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 del quartiere generato per un hotel per scoprire di più sull'area circostante:

  • "Questa vivace zona di San Francisco, che unisce North Beach e Chinatown, si trova a nord-ovest del Financial District e presenta punti di riferimento letterari, attrazioni culturali uniche e una ristorazione variegata. Tra i luoghi di interesse figurano l'iconica libreria City Lights, l'affascinante Cable Car Museum e le vivaci strade di Chinatown.

    La zona offre una miscela unica di storia e cultura, dove un ambiente pedonale invita all'esplorazione nonostante alcune colline e la folla. Immergiti nella storia letteraria della libreria City Lights, vivi 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 aspettano una varietà di opzioni di ristorazione, dalla cucina cinese autentica 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 opzioni di ristorazione raggiungibili in 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 (New) 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 di alto livello delle attrazioni nelle vicinanze per i luoghi con il tipo electric_vehicle_charging_station.

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

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

Lingua Regione
Inglese Stati Uniti

Richiedere 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 Housing e Lodging. Per restituire un riepilogo del quartiere nella risposta, includi quanto segue nella maschera dei campi della richiesta:

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

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

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

Il seguente esempio richiede un riepilogo del quartiere per un hotel a 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"
    }
  }
}

Richiedere un riepilogo dei servizi EVCS

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

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

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

  • Quattro campi secondari: overview, coffee, restaurant e store. Ogni campo secondario include una breve descrizione dei punti d'interesse nelle vicinanze e un elenco di nomi di risorse luogo a cui si fa 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 di divulgazione "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 ulteriori informazioni, consulta Norme per l'API Places.