L'API Geocoding propose des résumés générés par IA pour aider les utilisateurs à comprendre une destination. Ces résumés sont fournis dans l'objet Destination du champ arrival_summary.
Ces résumés sont de courts extraits de texte d'environ 120 caractères ou 24 mots maximum, qui résument les attributs distinctifs de la destination pour aider les utilisateurs à planifier leur voyage et à leur arrivée.
Exemple :
- "Derrière Domino's Pizza : immeuble de taille moyenne avec des bandes blanches et rouge brique ; l'entrée se trouve derrière une grille métallique noire"
- "Grand immeuble crème avec balcons ⋅ L'entrée se trouve sous un grand pont en arc au-dessus de l'allée et dispose d'une guérite"
Les résumés d'arrivée sont générés par IA. Toutefois, ces résumés sont expérimentaux et peuvent parfois contenir des informations inexactes. Vos utilisateurs ne doivent pas se fier aux résumés générés par l'IA comme source d'informations.
Demander un récapitulatif des arrivées
Pour renvoyer un récapitulatif de l'arrivée dans la réponse, incluez destinations.arrival_summary dans l'en-tête X-Goog-FieldMask de votre requête Rechercher des destinations.
Le champ arrival_summary contient un objet ArrivalSummary avec les champs suivants : text, flag_content_url et disclosure_text.
La réponse se présente sous la forme suivante :
{ "destinations": [ { "arrival_summary": { "text": { "text": "Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate", "languageCode": "en-US" }, "flag_content_url": "https://www.google.com/local/review/rap/report?postId=...", "disclosure_text": { "text": "Summarized with Gemini", "languageCode": "en-US" } } } ] }
Afficher les résumés optimisés par l'IA
Lorsque vous affichez des résumés optimisés par l'IA dans votre application, vous devez inclure le texte d'information requis et un lien permettant de signaler les problèmes liés au résumé.
Texte de l'annonce
Lorsque vous affichez un résumé optimisé par l'IA à partir du champ text, vous devez inclure le texte d'information localisé fourni dans le champ disclosure_text de l'objet ArrivalSummary dans la réponse, immédiatement sous le résumé. Ne modifiez ni n'augmentez jamais le texte de divulgation fourni par l'API.
Signaler des problèmes
Chaque résumé contient un flag_content_url qui fournit un lien permettant aux utilisateurs de signaler des problèmes liés au contenu du résumé. Lorsque vous affichez un résumé généré par l'IA, vous devez mettre ce lien à la disposition des utilisateurs pour qu'ils puissent signaler les problèmes liés au résumé.
Pour en savoir plus, consultez les Règles de l'API Geocoding.
Couverture des destinations
Les résumés optimisés par l'IA ne sont disponibles que pour les destinations résidentielles, dans les zones métropolitaines suivantes :
États-Unis
- Atlanta
- Boston
- Chicago
- Dallas-Fort Worth
- Houston
- Las Vegas
- Los Angeles
- Miami
- New York
- Philadelphie
- San Diego
- San Francisco
- Seattle
- Washington, D.C.
Inde
- Bangalore (Bengaluru)
- Chennai
- Delhi (New Delhi)
- Hyderabad
- Kolkata
- Mumbai