I riepiloghi delle recensioni basati sull'AI sono riepiloghi dei luoghi creati con l'AI esclusivamente in base alle recensioni degli utenti. Riassumendo gli elementi chiave delle recensioni degli utenti, come gli attributi del luogo e il sentiment dei recensori, i riepiloghi delle recensioni forniscono informazioni di alto livello e aiutano gli utenti a prendere decisioni informate.
Ad esempio, il riepilogo delle recensioni del Ferry Building di San Francisco include informazioni che vanno da cibo e shopping a panorami e atmosfera:
"I visitatori affermano che questo punto di riferimento storico offre una vasta scelta di negozi, ristoranti e un mercato agricolo, e molti lodano la vista sulla baia e sulla città. Inoltre, mettono in evidenza l'atmosfera vivace, la comodità di raggiungere altre destinazioni in traghetto e l'opportunità di usufruire delle attività commerciali locali".
I riepiloghi delle recensioni sono supportati in Dettagli del luogo (nuova versione), Ricerca di testo (nuova versione) e Ricerca nelle vicinanze (nuova versione).
I riepiloghi delle recensioni sono supportati per i punti d'interesse nelle seguenti lingue e regioni:
| Lingua | Regione |
|---|---|
| Inglese |
India Giappone Regno Unito Stati Uniti |
| Giapponese | Giappone |
Richiedere un riepilogo delle recensioni
Per richiedere un riepilogo delle recensioni, includi reviewSummary nella maschera del campo della
richiesta:
- Place Details (New):
reviewSummary - Ricerca di testo (novità) e Ricerca nelle vicinanze (novità):
places.reviewSummary
Le attribuzioni per un riepilogo delle recensioni devono includere un link alle recensioni del luogo su
Google Maps. Per recuperare il link, includi
reviewSummary.reviewsUri
nella maschera del campo della richiesta.
Il corpo della risposta include tre campi:
text: il riepilogo delle recensioni creato con l'AI.flagContentUri: Utilizzato per segnalare contenuti inappropriati per la rimozione da parte di Google.disclosureText: una stringa di testo localizzata con il testo dell'informativa "Riassunto con Gemini" che deve essere incorporato nelle attribuzioni.
Richiesta Place Details (New)
L'esempio seguente richiede un riepilogo delle recensioni per un ristorante di ravioli a New York:
curl -X GET https://places.googleapis.com/v1/places/ChIJD2l2k7ZL0YkRC80d-3MV1lM \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,reviewSummary"
La risposta è nel formato:
{ "displayName": { "text": "Dumpling House", "languageCode": "en" }, "reviewSummary": { "text": { "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1" } }
Richiesta di ricerca testuale (nuova)
L'esempio seguente richiede un riepilogo delle recensioni per un bar a New York:
curl -X POST -d '{
"textQuery": "coffee shop",
"locationBias": {
"circle": {
"center": {
"latitude": 40.722630,
"longitude": -74.001397
}
}
},
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchText'
Il corpo della risposta ha il seguente formato:
{ "places": [ { "id": "ChIJyfJXNphZwokRbo-oe0DjVT4", "reviewSummary": { "text": { "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1" } }, { "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ", "reviewSummary": { "text": { "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1" } }, ... ] }
Richiesta di ricerca nelle vicinanze (nuova)
Il seguente esempio richiede hotel vicino al centro di Seattle:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 47.609937,
"longitude": -122.340714
},
"radius": 1000
}
},
"includedTypes": ["hotel"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchNearby'
La risposta è nel formato:
{ "places": [ { "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ", "reviewSummary": { "text": { "text": "People say this hotel offers clean, modern, and spacious rooms with comfortable beds and phenomenal city views. They highlight the convenient downtown location, with easy walking access to popular attractions, and the efficient self-parking option. They also like the friendly and helpful staff, and the smooth check-in and check-out process.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3c%7CCAIQACorChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3cSDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1" } }, { "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U", "reviewSummary": { "text": { "text": "People say this hotel offers spacious rooms, a convenient location near the convention center and Pike Place Market, and a tasty restaurant. They also highlight the friendly and attentive staff, the comfortable beds and pillows, and the convenient amenities such as a Starbucks in the lobby and a club lounge.\n\nSome reviews mention the rooms can be noisy.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2Nnc%7CCAIQACorChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2NncSDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1" } }, ... ] }
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.