Proporcionar resúmenes potenciados por IA

La API de Geocoding ofrece resúmenes generados por IA para ayudar a los usuarios a comprender un destino. Estos resúmenes se proporcionan en el Destination objeto en el arrivalSummary campo.

Estos resúmenes son fragmentos de texto breves y fáciles de leer de aproximadamente 120 caracteres o 24 palabras o menos, que resumen atributos distintivos sobre el destino para ayudar a los usuarios durante la planificación y la llegada del viaje.

Por ejemplo:

• "Detrás de Domino's Pizza ⋅ Edificio de apartamentos de mediana altura con rayas blancas y rojo ladrillo ⋅ La entrada está detrás de una puerta de metal negra"
• "Edificio de apartamentos alto de color crema con balcones ⋅ La entrada está debajo de un gran puente arqueado sobre la entrada de vehículos y tiene una cabina de seguridad"

Los resúmenes de llegada se generan con IA. Sin embargo, estos resúmenes son experimentales y, en ocasiones, pueden contener información imprecisa. Los usuarios no deben confiar en los resúmenes potenciados por IA como su fuente de información.

Solicita un resumen de llegada

Para mostrar un resumen de llegada en la respuesta, incluye destinations.arrivalSummary en el X-Goog-FieldMask encabezado de tu solicitud de búsqueda de destinos:

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

El campo arrival_summary contiene un objeto ArrivalSummary con los siguientes campos: text, flag_content_url y disclosure_text.

La respuesta tiene el siguiente 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"
        }
      }
    }
  ]
}

Muestra resúmenes potenciados por IA

Cuando muestres resúmenes potenciados por IA en tu app, debes incluir el texto de divulgación obligatorio y un vínculo para informar problemas con el resumen.

Texto de divulgación

Cuando muestres un resumen potenciado por IA del campo text, debes incluir el texto de divulgación localizado que se proporciona en el campo disclosure_text del objeto ArrivalSummary en la respuesta inmediatamente debajo del resumen. Nunca modifiques ni aumentes el texto de divulgación que proporciona la API.

Cómo informar problemas

Cada resumen contiene una flag_content_url que proporciona un vínculo para que los usuarios informen problemas con el contenido del resumen. Cuando muestres un resumen potenciado por IA, debes poner este vínculo a disposición de los usuarios para que informen problemas con el resumen.

Para obtener más información, consulta las Políticas de la API de Geocoding.

Cobertura de destinos

Los resúmenes potenciados por IA solo están disponibles para destinos residenciales, en las siguientes áreas metropolitanas:

Estados Unidos

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

India

• Bangalore
• Chennai
• Delhi
• Hyderabad
• Calcuta
• Bombay

Comentarios

Esta es una función experimental de la API de Geocoding. Agradeceríamos tus comentarios en geocoding-feedback-channel@google.com.