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

L'API Geocoding propose des résumés générés par l'IA pour aider les utilisateurs à comprendre une destination. Ces résumés sont fournis dans l' Destination objet du arrival_summary champ.

Il s'agit 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 :

• "Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate"
• "Tall cream apartment building with balconies ⋅ Entrance is under a large arched bridge over the driveway and has a security booth"

Les résumés d'arrivée sont générés par l'IA. Toutefois, ils sont expérimentaux et peuvent parfois contenir des informations inexactes. Vos utilisateurs ne doivent pas se fier aux résumés optimisés par l'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.arrival_summary dans l'en-tête X-Goog-FieldMask de votre requête de recherche de 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": [
    {
      "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 de divulgation obligatoire et un lien permettant de signaler des problèmes avec le résumé.

Texte de divulgation

Lorsque vous affichez un résumé optimisé par l'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, juste en dessous du 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 avec le contenu du résumé. Lorsque vous affichez un résumé optimisé par l'IA, vous devez mettre ce lien à la disposition des utilisateurs pour qu'ils puissent signaler des problèmes avec le 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

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.