Les résumés de lieux optimisés par l'IA sont des aperçus brefs de 100 caractères maximum, spécifiques à un ID de lieu donné. Les résumés de lieux regroupent de nombreux types de données différents dans un aperçu général pour aider les utilisateurs à obtenir un aperçu d'un lieu.
Par exemple, les résumés de lieux peuvent mettre en avant les plats, services ou produits populaires disponibles à l'achat dans un lieu :
- "Restaurant du Forum Shops servant de grandes portions de plats italiens traditionnels dans un espace décontracté."
- "Salon élégant proposant des coupes, des colorations et des brushings."
- "Grand magasin avec de nombreux vendeurs proposant une variété de décorations, de meubles et de vêtements vintage."
Les résumés de lieux sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New). Les résumés de lieux sont disponibles pour les types de lieux indiqués dans Types acceptés pour les catégories Culture, Divertissement et loisirs, Aliments et boissons, Shopping, Services et Sports.
Les résumés de lieux sont disponibles pour les points d'intérêt dans les langues et régions suivantes :
| Langue | Région |
|---|---|
| Anglais |
Inde États-Unis |
Demander un résumé génératif d'un lieu
Pour renvoyer un résumé du lieu dans la réponse, incluez le champ suivant dans le masque de champ de la requête :
- Détails du lieu (nouveau) :
generativeSummary - Text Search (nouvelle version) et Nearby Search (nouvelle version) :
places.generativeSummary
Le champ generativeSummary contient les champs suivants :
generativeSummary: résumé du lieu.overviewFlagContentUri: lien permettant aux utilisateurs de signaler un problème concernant le résumé du lieu.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)
La requête Place Details (New) suivante renvoie un résumé overview pour un restaurant de sushis à Chicago, dans l'Illinois :
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 réponse se présente sous la forme suivante :
{ "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" } } }
Requête Text Search (nouvelle version)
La requête Text Search (New) suivante renvoie un résumé overview pour les restaurants végétariens épicés à Mountain View, en Californie :
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 réponse se présente sous la forme suivante :
{ "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" } } }, /.../ ] }
Requête Nearby Search (nouveau)
La requête Nearby Search (nouveau) suivante renvoie un résumé overview pour les restaurants et cafés de Portland, dans l'Oregon :
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 réponse se présente sous la forme suivante :
{ "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" } } }, /.../ ] }
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.