Riepiloghi delle aree basati sull'IA

I riepiloghi dell'area basati sull'AI vengono generati per l'area circostante un luogo. I riepiloghi dell'area forniscono un contesto aggiuntivo per una località, inclusi i punti di interesse nelle vicinanze, in modo che gli utenti possano prendere una decisione più informata su dove andare e cosa fare una volta arrivati.

Ad esempio, quando visiti una nuova città, puoi visualizzare un riepilogo del quartiere generato per un hotel per scoprire di più sulla zona circostante:

  • "Questa vivace zona di San Francisco, che unisce North Beach e Chinatown, si trova a nord-ovest del quartiere finanziario e offre punti di riferimento letterari, attrazioni culturali uniche e una ristorazione variegata. Tra i luoghi più importanti ci sono l'iconica libreria City Lights, l'affascinante Cable Car Museum e le vivaci strade di Chinatown.

    La zona offre un mix unico di storia e cultura, dove un ambiente pedonale invita all'esplorazione nonostante alcune colline e folle. Immergiti nella storia della letteratura alla libreria City Lights, scopri la vivace cultura di Chinatown con i suoi templi e le fabbriche di biscotti della fortuna o fai un salto indietro nel tempo al Cable Car Museum. Ti aspetta una varietà di opzioni gastronomiche, dalla cucina cinese autentica alla pizza deliziosa."

Se stai pensando di ricaricare un veicolo elettrico, puoi visualizzare un riepilogo generato per una stazione di ricarica per veicoli elettrici per trovare bar o ristoranti nelle vicinanze da visitare mentre aspetti:

  • "Questa zona offre una vasta gamma di opzioni di ristorazione a 9 minuti a piedi, tra cui Starbucks, Sushi Jin e Safeway".

Oltre a una descrizione dell'area, la risposta contiene anche un elenco di ID luogo per i luoghi a cui viene fatto riferimento nella descrizione.

L'API Places (New) fornisce due tipi di riepiloghi dell'area basati sull'AI:

  • Riepiloghi del quartiere, che forniscono panoramiche di alto livello delle attrazioni vicine per i luoghi con i tipi premise, street_address e tutti i tipi nelle categorie Alloggi e Strutture ricettive.
  • Riepiloghi dei servizi delle stazioni di ricarica per veicoli elettrici (EVCS), che forniscono panoramiche di alto livello delle attrazioni nelle vicinanze per i luoghi di tipo electric_vehicle_charging_station.

I riepiloghi delle aree basati sull'AI sono supportati in Dettagli del luogo (novità), Ricerca di testo (novità), e Ricerca nelle vicinanze (novità).

Richiedere un riepilogo del quartiere

I riepiloghi del quartiere possono essere generati per i luoghi con tipi nelle categorie Alloggi e Strutture ricettive. Per restituire un riepilogo del quartiere nella risposta, includi quanto segue nella maschera del campo della richiesta:

  • Place Details (New): neighborhoodSummary
  • Ricerca di testo (novità) e Ricerca nelle vicinanze (novità): places.neighborhoodSummary

Il campo neighborhoodSummary per un luogo nella risposta contiene quanto segue:

  • Due campi secondari: overview e description. Il sottocampo overview include punti di interesse nelle vicinanze specifici per il luogo, mentre il sottocampo description fornisce informazioni più generali sull'area circostante. Ogni sottocampo include un elenco di nomi di risorse di luoghi a cui viene fatto riferimento nel formato place/PLACE_ID.
  • Un link flagContentUri in cui gli utenti possono segnalare un problema con il riepilogo generato.
  • Una stringa di testo localizzata con il testo dell'informativa "Riassunto con Gemini" che deve essere incorporata nelle attribuzioni.

L'esempio seguente richiede un riepilogo del quartiere per un hotel di New York City:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,neighborhoodSummary" \
'https://places.googleapis.com/v1/places/ChIJT0DdRo1ZwokRkufwSD-TdGM'

La risposta è nel formato:

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Richiedere un riepilogo dei servizi EVCS

I riepiloghi dei servizi delle stazioni di ricarica per veicoli elettrici (EVCS) possono essere generati per i luoghi di tipo electric_vehicle_charging_station. Per includere il riepilogo dei servizi EVCS nella risposta, includi quanto segue nella maschera del campo della tua richiesta:

  • Place Details (New): evChargeAmenitySummary
  • Ricerca di testo (novità) e Ricerca nelle vicinanze (novità): places.evChargeAmenitySummary

Il campo evChargeAmenitySummary per un luogo nella risposta contiene quanto segue:

  • Quattro sottocampi: overview, coffee, restaurant e store. Ogni sottocampo include una breve descrizione dei punti di interesse nelle vicinanze e un elenco dei nomi delle risorse dei luoghi a cui viene fatto riferimento nel formato place/PLACE_ID.
  • Un link flagContentUri in cui gli utenti possono segnalare un problema con il riepilogo generato.
  • Una stringa di testo localizzata con il testo dell'informativa "Riassunto con Gemini" che deve essere incorporata nelle attribuzioni.

Il seguente esempio richiede un riepilogo dei servizi di una stazione di ricarica EV per una stazione di ricarica a Mountain View:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,evChargeAmenitySummary" \
'https://places.googleapis.com/v1/places/ChIJtwHgNNa2j4ARlC8vbI9lLZA'

La risposta è nel formato:

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Attribuzioni

Tutti i riepiloghi basati sull'AI visualizzati nella tua app devono essere accompagnati dall'attribuzione appropriata in conformità con le norme e gli standard di Google. Per maggiori informazioni, consulta le norme per l'API Places.