Proporcionar resúmenes potenciados por IA

Este producto o función está en versión experimental (fase previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Desarrolladores del Espacio Económico Europeo (EEE)

Si tu dirección de facturación se encuentra en el Espacio Económico Europeo, a partir del 8 de julio de 2025, se aplicarán las Condiciones del Servicio de Google Maps Platform para el EEE al uso que hagas de los Servicios. La funcionalidad varía según la región. Obtén más información.

**Precaución:** Los resúmenes potenciados por IA solo están disponibles para destinos residenciales en ciertas áreas metropolitanas de Estados Unidos y la India. La cobertura se limita a estas áreas y puede ser baja, especialmente fuera de los centros de las ciudades. Para obtener una lista de las áreas metropolitanas admitidas, consulta Cobertura de destinos.

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:

• "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"

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.

Cómo solicitar 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

Importante: La función de resúmenes potenciados por IA es experimental. Forma solicitudes HTTP con el canal /v4alpha/. Más información sobre los canales de etapas de lanzamiento.

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

Cómo mostrar 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 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 [e-mail].