Fornire riepiloghi basati sull'AI

Questo prodotto o questa funzionalità è sperimentale (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per saperne di più, consulta le descrizioni della fase di lancio.

Sviluppatori dello Spazio economico europeo (SEE)

Se il tuo indirizzo di fatturazione si trova nello Spazio economico europeo, a partire dall'8 luglio 2025, i Termini di servizio di Google Maps Platform per il SEE si applicheranno al tuo utilizzo dei servizi. La funzionalità varia in base alla regione. Scopri di più.

Attenzione: i riepiloghi dell'AI sono disponibili solo per le destinazioni residenziali in alcune aree metropolitane negli Stati Uniti e in India. La copertura è limitata a queste aree e potrebbe essere bassa, soprattutto al di fuori dei centri urbani. Per un elenco delle aree metropolitane supportate, consulta Copertura delle destinazioni.

L'API Geocoding offre riepiloghi generati dall'AI per aiutare gli utenti a comprendere una destinazione. Questi riepiloghi sono forniti nell'oggetto Destination nel campo arrival_summary.

Questi riepiloghi sono brevi snippet di testo di circa 120 caratteri o 24 parole o meno, che riassumono gli attributi distintivi della destinazione per aiutare gli utenti durante la pianificazione del viaggio e l'arrivo.

Ad esempio:

• "Dietro Domino's Pizza ⋅ Condominio di media altezza con strisce bianche e rosso mattone ⋅ L'ingresso si trova dietro un cancello di metallo nero"
• "Alto edificio residenziale color crema con balconi. L'ingresso si trova sotto un grande ponte ad arco sopra il vialetto e ha una cabina di sicurezza"

I riepiloghi degli arrivi sono creati con l'AI. Tuttavia, questi riepiloghi sono sperimentali e potrebbero occasionalmente contenere informazioni imprecise. I tuoi utenti non devono fare affidamento sui riepiloghi basati sull'AI come fonte di informazioni.

Richiedere un riepilogo degli arrivi

Per restituire un riepilogo dell'arrivo nella risposta, includi destinations.arrival_summary nell'intestazione X-Goog-FieldMask della richiesta Cerca destinazioni.

Il campo arrival_summary contiene un oggetto ArrivalSummary con i seguenti campi: text, flag_content_url e disclosure_text.

La risposta è nel formato:

{
  "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"
        }
      }
    }
  ]
}

Visualizzare riepiloghi basati sull'AI

Quando mostri i riepiloghi basati sull'AI nella tua app, devi includere il testo dell'informativa richiesto e un link per segnalare problemi con il riepilogo.

Testo dell'informativa

Quando mostri un riepilogo basato sull'AI dal campo text, devi includere il testo dell'informativa localizzato fornito nel campo disclosure_text dell'oggetto ArrivalSummary nella risposta immediatamente sotto il riepilogo. Non modificare né integrare mai il testo dell'informativa fornito dall'API.

Problemi con i rapporti

Ogni riepilogo contiene un flag_content_url che fornisce un link per consentire agli utenti di segnalare problemi relativi ai contenuti del riepilogo. Quando viene visualizzato un riepilogo basato sull'AI, devi rendere disponibile questo link agli utenti per segnalare problemi relativi al riepilogo.

Per saperne di più, consulta le norme per l'API Geocoding.

Copertura della destinazione

I riepiloghi basati sull'AI sono disponibili solo per le destinazioni residenziali nelle seguenti aree metropolitane:

Stati Uniti

• Atlanta
• Boston
• Chicago
• Dallas-Fort Worth
• Houston
• Las Vegas
• Los Angeles
• Miami
• New York
• Filadelfia
• San Diego
• San Francisco
• Seattle
• Washington, D.C.

India

• Bangalore (Bengaluru)
• Chennai
• Delhi (Nuova Delhi)
• Hyderabad
• Kolkata
• Mumbai