Les résumés d'avis optimisés par l'IA sont des résumés de lieux générés par l'IA sur la base des avis des utilisateurs uniquement. En synthétisant les éléments clés des avis des utilisateurs, tels que les attributs des lieux et le sentiment des auteurs, les résumés d'avis fournissent des informations générales et aident les utilisateurs à prendre des décisions éclairées.
Par exemple, un résumé des avis sur le Ferry Building à San Francisco inclut des informations sur la nourriture et le shopping, ainsi que sur la vue et l'atmosphère :
"Les visiteurs apprécient ce lieu historique pour sa sélection variée de boutiques, de restaurants et son marché de producteurs. Beaucoup louent la vue sur la baie et la ville. Ils soulignent également l'atmosphère animée, l'accès pratique aux ferries pour d'autres destinations et la possibilité de profiter des commerces locaux."
Les résumés d'avis sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New).
Les résumés d'avis sont disponibles pour les points d'intérêt dans les langues et régions suivantes :
| Langue | Région |
|---|---|
| Anglais |
Inde Japon Royaume-Uni États-Unis |
| Japonais | Japon |
Demander un résumé des avis
Pour demander un récapitulatif des avis, incluez reviewSummary dans le masque de champ de la requête :
- Détails du lieu (nouveau) :
reviewSummary - Text Search (nouvelle version) et Nearby Search (nouvelle version) :
places.reviewSummary
Les attributions pour un résumé d'avis doivent inclure un lien vers les avis sur le lieu dans Google Maps. Pour récupérer ce lien, incluez reviewSummary.reviewsUri dans le masque de champ de la requête.
Le corps de la réponse inclut trois champs :
text: résumé des avis généré par l'IA.flagContentUri: permet de signaler du contenu inapproprié à Google pour qu'il le supprime.disclosureText: chaîne de texte localisée avec le texte d'information "Résumé avec Gemini" qui doit être inclus dans les attributions.
Requête Place Details (New)
L'exemple suivant demande un résumé des avis pour un restaurant de raviolis à 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 réponse se présente sous la forme suivante :
{ "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" } }
Requête Text Search (nouvelle version)
L'exemple suivant demande un résumé des avis pour un café à 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'
Le corps de la réponse se présente sous la forme suivante :
{ "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" } }, ... ] }
Requête Nearby Search (nouveau)
L'exemple suivant demande des hôtels à proximité du centre-ville de 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 réponse se présente sous la forme suivante :
{ "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" } }, ... ] }
Attributions
Tous les résumés générés par IA affichés dans votre application doivent être accompagnés de l'attribution appropriée, conformément aux règles et normes de Google. Pour en savoir plus, consultez les Règles de l'API Places.