Fornire riepiloghi basati sull'AI

Sviluppatori dello Spazio economico europeo (SEE)

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

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

Ad esempio:

  • "Dietro Domino's Pizza ⋅ Edificio residenziale di media altezza con strisce bianche e rosso mattone ⋅ L'ingresso è 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 generati dall'AI. Tuttavia, questi riepiloghi sono sperimentali e potrebbero occasionalmente contenere informazioni imprecise. Gli utenti non devono fare affidamento sui riepiloghi basati sull'AI come fonte di informazioni.

Richiedere un riepilogo dell'arrivo

Per restituire un riepilogo dell'arrivo nella risposta, includi destinations.arrivalSummary nell'X-Goog-FieldMask intestazione della richiesta di ricerca delledestinazioni:

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

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

La risposta è nel formato:

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

Visualizzare i riepiloghi basati sull'AI

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

Testo dell'informativa

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

Problemi con i report

Ogni riepilogo contiene un flag_content_url che fornisce un link per consentire agli utenti di segnalare problemi con i contenuti del riepilogo. Quando visualizzi un riepilogo basato sull'AI, devi rendere disponibile questo link agli utenti per segnalare problemi con il riepilogo.

Per ulteriori informazioni, consulta Norme per l'API Geocoding.

Copertura delle destinazioni

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

Feedback

Questa è una funzionalità sperimentale dell'API Geocoding. Apprezziamo i feedback all'indirizzo geocoding-feedback-channel@google.com.