Riepiloghi delle aree basati sull'IA

I riepiloghi delle aree basati sull'AI vengono generati per l'area circostante un luogo. I riepiloghi delle aree 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 generato del quartiere di un hotel per scoprire di più sulla zona circostante:

  • "Questa vivace area di San Francisco, che unisce North Beach e Chinatown, si trova a nord-ovest del Financial District e offre punti di riferimento letterari, attrazioni culturali uniche e una varietà di ristoranti. Tra i luoghi di interesse più importanti figurano 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 adatto ai pedoni invita all'esplorazione nonostante alcune colline e la folla. Immergiti nella storia letteraria alla libreria City Lights, scopri la vivace cultura di Chinatown con i suoi templi e le sue fabbriche di biscotti della fortuna o fai un salto indietro nel tempo al Cable Car Museum. Ti aspetta una varietà di opzioni gastronomiche, dall'autentica cucina cinese alla deliziosa pizza."

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 serie di punti ristoro 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 si fa riferimento nella descrizione.

L'API Places (novità) fornisce due tipi di riepiloghi delle aree basati sull'AI:

  • Riepiloghi dei quartieri, che forniscono panoramiche di alto livello delle attrazioni nelle vicinanze per i luoghi con i tipi premise, street_address e tutti i tipi nelle categorie Housing e Lodging.
  • Riepiloghi dei servizi delle stazioni di ricarica per veicoli elettrici (EVCS), che forniscono panoramiche generali delle attrazioni nelle vicinanze per i luoghi con tipo electric_vehicle_charging_station.

I riepiloghi delle aree basati sull'AI sono supportati in Place Details (New), Ricerca testuale (New) e Nearby Search (New).

I riepiloghi delle aree sono supportati per i punti d'interesse nelle seguenti lingue e regioni:

Lingua Regione
Inglese Stati Uniti

Richiedi un riepilogo del quartiere

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

  • Place Details (New): neighborhoodSummary
  • Ricerca testuale (nuova) e Nearby Search (nuova): places.neighborhoodSummary

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

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

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

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"
    }
  }
}

Richiedi un riepilogo dei servizi EVCS

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

  • Place Details (New): evChargeAmenitySummary
  • Ricerca testuale (nuova) e Nearby Search (nuova): places.evChargeAmenitySummary

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

  • Quattro campi secondari: 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 di riferimento nel formato place/PLACE_ID.
  • Un link flagContentUri che consente agli utenti di 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 dei servizi di una stazione di ricarica EV 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 saperne di più, consulta le policy per l'API Places.