Fournir des résumés optimisés par l'IA

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' Destination objet du champ arrivalSummary.

Ces résumés sont de courts extraits de texte lisibles 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 rayures blanches et rouge brique ⋅ L'entrée se trouve derrière un portail en métal noir"
• "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 cabine de sécurité"

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 optimisés par IA comme source d'informations.

Demander un résumé d'arrivée

Pour renvoyer un résumé d'arrivée dans la réponse, incluez destinations.arrivalSummary dans l'X-Goog-FieldMask en-tête de votre requête de recherche de destinations :

curl -X POST -d '{
  "place": "places/ChIJAWLGeHRZwokRV4Dojw9TEHA"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.arrivalSummary" \
https://geocode.googleapis.com/v4alpha/geocode/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 comme suit :

{
  "destinations": [
    {
      "arrivalSummary": {
        "text": {
          "text": "Tall red-brick apartment building ⋅ Entrance has a glass front and a grey metal overhang",
          "languageCode": "en"
        },
        "flagContentUrl": "https://www.google.com/local/review/rap/report?postId=...",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    }
  ]
}

Afficher les résumés optimisés par IA

Lorsque vous affichez des résumés optimisés par IA dans votre application, vous devez inclure le texte de divulgation requis et un lien pour signaler les problèmes liés au résumé.

Texte de divulgation

Lorsque vous affichez un résumé optimisé par IA à partir du champ text, vous devez inclure le texte de divulgation 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é optimisé par 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 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

Commentaires

Il s'agit d'une fonctionnalité expérimentale de l'API Geocoding. Nous vous serions reconnaissants de nous faire part de vos commentaires à l'adresse geocoding-feedback-channel@google.com.