I riepiloghi dei luoghi basati sull'AI sono brevi panoramiche di 100 caratteri specifiche per un determinato ID luogo. I riepiloghi dei luoghi aggregano molti tipi diversi di dati in una panoramica di alto livello per aiutare gli utenti a farsi un'idea di un luogo.
Ad esempio, i riepiloghi dei luoghi possono mettere in evidenza cibi, servizi o beni popolari disponibili per l'acquisto in una località:
- "Ristorante dei Forum Shops che serve porzioni abbondanti di piatti tradizionali italiani in un ambiente informale."
- "Salone elegante che offre tagli e colorazioni, oltre a pieghe."
- "Grande negozio con molti venditori che offrono una varietà di decorazioni, mobili e abbigliamento vintage."
I riepiloghi dei luoghi sono supportati da Place Details (versione nuova), Ricerca testuale (versione nuova), e Nearby Search (versione nuova). I riepiloghi dei luoghi sono disponibili per i tipi di luoghi mostrati in Tipi supportati per le categorie Cultura, Intrattenimento e svago, Cibo e bevande, Shopping, Servizi, e Sport.
I riepiloghi dei luoghi sono supportati per i punti di interesse nelle seguenti lingue e regioni:
| Lingua | Regione |
|---|---|
| Inglese |
India Stati Uniti |
Richiedere un riepilogo generativo di un luogo
Per restituire un riepilogo di un luogo nella risposta, includi il seguente campo nella maschera dei campi della richiesta:
- Place Details (versione nuova):
generativeSummary - Ricerca testuale (versione nuova) e Nearby Search (versione nuova):
places.generativeSummary
Il generativeSummary contiene i seguenti campi:
generativeSummary: il riepilogo del luogo.overviewFlagContentUri: un link in cui gli utenti possono segnalare un problema con il riepilogo del luogo.disclosureText: una stringa di testo localizzata con il testo di divulgazione "Riassunto con Gemini" che deve essere incorporata nelle attribuzioni.
Richiesta Place Details (versione nuova)
La seguente richiesta Place Details (versione nuova) restituisce un riepilogo overview per un ristorante di sushi a Chicago, IL:
curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,generativeSummary"
La risposta è nel formato:
{ "displayName": { "text": "Sushi Nova - Lincoln Park", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.", "languageCode": "en-US" }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }
Richiesta Ricerca testuale (versione nuova)
La seguente richiesta Ricerca testuale (versione nuova) restituisce un riepilogo overview per i ristoranti vegetariani piccanti a Mountain View, CA:
curl -X POST -d '{
"textQuery": "Spicy Vegetarian Food",
"location_bias": {
"rectangle": {
"low": {
"latitude": 37.415,
"longitude": -122.091
},
"high": {
"latitude": 37.429,
"longitude": -122.065
}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'
La risposta è nel formato:
{ "places": [ { "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI", "displayName": { "text": "Plant-Based Vegan Vietnamese", "languageCode": "en" } }, { "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI", "displayName": { "text": "sweetgreen", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.", "languageCode": "en-US" }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
Richiesta Nearby Search (versione nuova)
La seguente richiesta Nearby Search (versione nuova) restituisce un riepilogo overview per ristoranti e bar a Portland, OR:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 45.553360,
"longitude": -122.674934
},
"radius": 1000
}
},
"includedTypes": ["restaurant", "cafe"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'
La risposta è nel formato:
{ "places": [ { "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY", "generativeSummary": { "overview": { "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.", "languageCode": "en-US" }, "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJU4OzoWynlVQRxlQMpGenSvA", "generativeSummary": { "overview": { "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.", "languageCode": "en-US" }, "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 Norme per l'API Places.