Capacidades del modelo Gemini para la API de Places

Las funciones del modelo Gemini para la API de Places (nueva) ofrecen compatibilidad con LLM para la API de Places, de modo que puedas mostrar los datos asociados con un lugar (horarios de atención, opiniones y fotos) junto con los datos que proporcionan los LLM. Estos datos generativos contienen datos agregados y resumidos de los LLM para mejorar los datos que ya están asociados a un lugar.

Por ejemplo, una búsqueda de texto (nueva) estándar para "estaciones de carga de VE" muestra una lista de lugares que ofrecen carga de VE. Este tipo de respuesta es útil si solo estás buscando el cargador de VE más cercano o el que sea compatible con tu vehículo.

Sin embargo, te recomendamos que comprendas mejor el área alrededor de la estación de carga, en especial si vas a estar en ese lugar durante una hora o más mientras se carga el vehículo. Cuando se usan las capacidades del modelo Gemini para esa misma búsqueda, la respuesta puede contener descripciones dinámicas y generativas de cada lugar en la respuesta, incluida la información sobre el área alrededor de la estación de carga:

  • “A 2 o 4 minutos a pie, hay varias opciones de restaurantes y tiendas, como Chef Chu's, Gen Korea barbacoa House, Amber India, Pacific Catch, y varias tiendas de alimentos como Walmart, Whole Foods Market y Trader Joe's”.

  • “A 1-5 minutos a pie, hay varias opciones de restaurantes y tiendas, como Khao Kang Thai Kitchen, Roger's Deli & Donuts y La Costeña. Si buscas sushi, Joy Sushi es una buena opción. Para las compras, Dollar Tree ofrece una variedad de productos con descuentos".

Este contenido generativo de los LLM mejora la respuesta y proporciona información adicional para ayudar a los usuarios a tomar una decisión fundamentada.

Se agregaron nuevas funciones potenciadas por IA a la API de Places (versión nueva)

Estas capacidades agregan los siguientes datos a una respuesta de la API de Places (nueva):

Resúmenes generativos del lugar

Los resúmenes generativos del lugar son específicos de un ID de lugar. Los resúmenes de lugar agregan muchos tipos diferentes de datos en un solo resumen del lugar.

La API de Places (versión nueva) proporciona dos tipos de resúmenes generativos de lugares:

  • Resúmenes de descripción general: Son una descripción general breve de un lugar (aproximadamente 100 caracteres) y que pueden ayudar a los usuarios a obtener una instantánea de un lugar.

  • Resúmenes de descripciones: Son resúmenes más largos de un lugar (aproximadamente 400 caracteres) que ofrecen una descripción detallada de los aspectos principales del lugar.

Actualmente, los resúmenes de lugares están disponibles para los tipos de lugares que se muestran en los Tipos admitidos en las categorías Cultura, Entretenimiento y recreación, Comidas y bebidas, Compras y Deportes.

Resúmenes del área generativos

El LLM crea los resúmenes generativos del área para el área cercana alrededor de un lugar. El resumen del área de un lugar puede contener toda la información necesaria para que un usuario tome una decisión, sin que el usuario tenga que realizar más solicitudes para desglosar los detalles del área.

Junto con una descripción del área, la respuesta también contiene una lista de los IDs de lugar de los lugares a los que se hace referencia en la descripción, y una lista de lugares ordenados según diferentes tipos de contenido. Por ejemplo, un tipo de contenido incluye una lista de lugares asociados con actividades en el área y otro contiene una lista de restaurantes en el área.

Actualmente, los resúmenes del área están disponibles para los tipos de lugares que se muestran en los Tipos admitidos en la categoría Alojamiento, así como para los tipos de lugares específicos electric_vehicle_charging_station, geocode y premise.

Generación de resúmenes de lugares y áreas

Google genera con frecuencia tanto los resúmenes generativos de lugares como los resúmenes generativos de áreas sin conexión. Si generas estos resúmenes sin conexión, puedes aprovechar el contenido con tecnología de Gemini y seguir viendo el mismo rendimiento que ya esperabas en la API de Places (versión nueva).

Google vuelve a generar estos resúmenes con frecuencia para asegurarse de que estén actualizados en función de la información disponible más reciente. Esto significa que mostrarás los datos más recientes en tu servicio cuando llames a la API.

Resultados de la búsqueda contextual

Text Search (nuevo) muestra información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Nueva York" o "tiendas de zapatos cerca de Ottawa". La respuesta de Text Search (nuevo) contiene una lista de lugares que coinciden con la cadena de texto y cualquier personalización de ubicación establecida en la solicitud.

Cuando agregas resultados de la búsqueda contextuales a la respuesta, la respuesta ahora incluye opiniones, fotos y justificaciones que ayudan a los usuarios a responder las preguntas:

  • ¿Por qué veo este lugar en los resultados?
  • ¿Por qué debería elegir este lugar?

Por ejemplo, hoy realizas una solicitud a Place Details (nuevo), Text Search (nuevo) o Nearby Search (nuevo) que incluye un lugar específico en la respuesta. Los datos de respuesta del lugar son los mismos para las tres solicitudes porque los datos que se muestran están asociados con ese lugar.

Sin embargo, para una búsqueda de texto (nueva) que use las nuevas funciones, la respuesta puede incluir datos derivados de la cadena de consulta de entrada. Eso significa que los resultados de la búsqueda contextuales son únicos para la cadena de consulta. Por ejemplo, realizas una solicitud de Text Search (nuevo) con la siguiente cadena de consulta:

“Restaurante vegetariano picante en Mountain View, CA”

Luego dejas todos los parámetros de entrada como están y solo cambias la cadena de consulta por lo siguiente:

“Restaurante vegan picante en Mountain View, CA”

Para un restaurante que aparece en ambas respuestas, los datos de respuesta sobre el lugar son los mismos porque esos datos están asociados con el lugar. Sin embargo, los resultados de la búsqueda contextuales son únicos de la consulta porque derivan de la cadena de consulta. Luego, puedes mostrar a los usuarios las opiniones, fotos y justificaciones de los resultados de la búsqueda contextual para ayudarlos a decidir qué lugar de la respuesta es el más adecuado para su solicitud de búsqueda.

Habilita las capacidades del modelo Gemini para la API de Places (nuevo)

Debes habilitar la API de Places (versión nueva) para usar las capacidades del modelo de Gemini para la API de Places (versión nueva). Para obtener más información, consulta Configura tu proyecto de Google Cloud.

Restricciones para la versión experimental

Esta versión solo admite resúmenes de lugares y áreas para lugares de Estados Unidos, solo en inglés.

¿Qué es Gemini?

Para obtener más información sobre el modelo de Gemini, consulta las Preguntas frecuentes sobre Gemini.

Solicita un resumen generativo del lugar

Los resúmenes de lugares son resúmenes generativos que crea el LLM para un lugar específico. La API de Places (versión nueva) agrega dos tipos de resúmenes a una respuesta:

  • Resúmenes generativos de descripción general que son similares al resumen editorial estático asociado con un lugar. Los resúmenes breves generativos tienen, en promedio, 100 caracteres y varias ventajas:

    • Muchos lugares no tienen resúmenes editoriales, por lo que llenan un espacio en la información disponible para un lugar.

    • Se generan a partir del LLM, por lo que no es necesario que el propietario del lugar los mantenga.

  • Los resúmenes generativos de las descripciones se obtienen de muchas fuentes, incluidas las opiniones de Google Maps. La descripción, que tiene un promedio de alrededor de 400 caracteres, incluye una lista de opiniones que se usan para generar la descripción larga.

    Para generar resúmenes de descripciones de forma manual, se requiere que una persona agregue datos de muchas ubicaciones y, luego, diseñe y mantenga el contenido. Las capacidades del modelo de Gemini para la API de Places (versión nueva) compilan estos resúmenes a partir de los LLM a fin de mantener el alcance y la actualidad del contenido generado.

Los resúmenes de lugares son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo). Para incluir el resumen de lugar en la respuesta, incluye el siguiente campo en la máscara de campo de la solicitud:

  • Place Details: generativeSummary

  • Text Search y Nearby Search: places.generativeSummary

El campo generativeSummary contiene los siguientes campos:

  • generativeSummary.overview: El resumen de la descripción general generativa
  • generativeSummary.description: Es el resumen de la descripción generativa.
  • generativeSummary.references: Es un array de hasta cinco opiniones que se usa para proporcionar contenido para el resumen de la descripción. Si no hay un resumen de descripción, este array está vacío.

Ejemplo de solicitud de resumen de descripción general

En esta búsqueda de texto de ejemplo, solo se muestra el resumen de overview para los restaurantes vegetarianos picantes en Mountain View, California:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText

La respuesta contiene el campo generativeSummary.overview, que incluye overview.text y overview.languageCode:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

Ejemplo de solicitud de resumen y descripción general

En este ejemplo, se realiza la misma consulta que en el ejemplo anterior, pero se usa una máscara de campo places.generativeSummary para mostrar el objeto generativeSummary completo, incluidos los campos generativeSummary.overview, generativeSummary.description y generativeSummary.references:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

Solicita un resumen del área generativa

Los resúmenes del área son resúmenes generativos creados por el LLM para el área cercana de un lugar. Los resúmenes del área pueden ser importantes para los usuarios que toman una decisión sobre un lugar.

Por ejemplo, si buscas reservar un hotel en una ciudad nueva y, si bien puedes encontrar un hotel que cumpla con tus requisitos, también te gustaría obtener más información sobre el área alrededor del hotel. En lugar de mirar un mapa de los alrededores y luego tener que investigar cada lugar en él, puedes generar un resumen del área del hotel.

Los resúmenes del área son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).

Para incluir el resumen de área en la respuesta, inclúyelo en la máscara de campo de la solicitud:

  • areaSummary (Place Details)
  • places.areaSummary (Text Search y Nearby Search).

El campo areaSummary de un lugar de la respuesta contiene un array de hasta cuatro contentBlocks. El tema de cada bloque depende del tipo de lugar:

  • En el caso de una estación de carga de VE, que se define como un lugar de tipo electric_vehicle_charging_station, los bloques de tema incluyen "overview", "coffee", "restaurant" y "store".

  • Para un lugar con un tipo definido por la categoría Alojamiento y los tipos de lugar específicos geocode y premise, los bloques de temas incluyen "overview", "activity", "restaurant" y "store".

Ejemplo de solicitud del resumen de área de una estación de carga de VE

Esta solicitud de Place Details de ejemplo muestra el resumen del área de una estación de carga de VE específica en Mountain View, identificada por el ID de lugar ChIJC5b6QKiwj4ARgn2EwlnJnWU:

curl -X GET -H 'Content-Type: application/json' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: id,displayName,areaSummary" \
  https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU

La respuesta contiene el campo areaSummary, incluido el array contentBlocks:

  • El campo topic especifica el tipo de bloque de contenido. Debido a que en este ejemplo se incluye una estación de carga de VE, los cuatro bloques de contenido son "overview", "coffee", "restaurant" y "store".

  • El campo content incluye el resumen de ese tema, incluido el código de idioma.

  • El array references especifica los nombres de los recursos de lugar, en el formato places/PLACE_ID, que se usan para proporcionar contenido al bloque de contenido.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ]
  }
}

Ejemplo de solicitud de resumen de área de un hotel

En esta solicitud de texto de ejemplo, se solicitan hoteles en Mountain View, CA:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText

La respuesta contiene el campo areaSummary, incluido el array contentBlocks. La respuesta para los lugares de tipo hotel contiene bloques de contenido para los temas "overview", "activity", "restaurant" y "store":

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

Solicita resultados de la búsqueda contextuales

La respuesta a una solicitud de Text Search (nuevo) contiene un arreglo de lugares que coinciden con los criterios de la string de búsqueda de entrada. Ahora puedes solicitar datos de búsqueda contextual en la respuesta en función de la consulta de entrada a la API.

Para admitir resúmenes contextuales, la respuesta de Text Search (nuevo) contiene un array nuevo llamado contextualContents en el mismo nivel que el array places en la respuesta:

{
  "places": [],
  "contextualContents":[]
}

Cada elemento del array contextualContents, del tipo ContextualContent, se encuentra en la ubicación correspondiente del array como el lugar del array places. Es decir, el elemento en contextualContents[0] corresponde al lugar en places[0].

Cada elemento de array contiene los siguientes campos de array:

  • contextualContents.reviews: Es un array de hasta tres opiniones.
  • contextualContents.photos: Es un array de hasta cinco fotos.

  • contextualContents.justifications: Es un array de justificaciones para el lugar, que incluyen lo siguiente:

    • reviewJustification: Destaca una sección de la opinión de un usuario que podría interesarle al usuario final.
    • businessAvailabilityAttributesJustification: Incluye atributos de una empresa que podrían ser de interés para un usuario final.

Para incluir los resultados de la búsqueda contextual en la respuesta, incluye contextualContents en la máscara de campo de la solicitud de Text Search (nuevo):

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

La respuesta contiene el array contextualContents para cada lugar en ella:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Guía de implementación para casos de uso de la industria automotriz

Para la seguridad del conductor, Google recomienda renderizar resúmenes de la IA generativa en modo estacionado para las experiencias en la industria automotriz. Si se renderizan resúmenes en el modo en automóvil, la información en pantalla debe ser simple, clara y concisa para garantizar que la atención del conductor regrese rápidamente a la ruta.

  • No debe tener más de 3 líneas.
  • 120 caracteres o 24 palabras o menos
  • Tamaño mínimo frontal de 24 dp

En especial en los contextos de la industria automotriz, es responsabilidad del desarrollador renderizar resúmenes de la IA generativa de maneras seguras y que cumplan con todas las leyes y reglamentaciones locales.

Atribuciones

Cuando muestras opiniones, fotos y resúmenes de IA generativa en tu app, incluidos los resúmenes de lugares y áreas, debes asegurarte de mostrar también las atribuciones requeridas.

Muestra atribuciones de los resúmenes generativos

Cuando muestras resúmenes de IA generativa en tu app, incluidos resúmenes de lugares y áreas, también debes mostrar las atribuciones necesarias. En esta sección, se describe cómo mostrar atribuciones según cómo muestras los resúmenes de la IA generativa en tu app.

En todos los casos, la atribución debe usar mayúsculas y minúsculas. La atribución y el logotipo de Google deben cumplir con todos los estándares de color, estilo y tipo de letra. Para obtener más información sobre estos estándares, consulta Políticas para la API de Places (versión nueva).

Resumen de la IA generativa mostrado en el contexto de otros datos de Google

En este caso, la atribución de IA generativa se puede mostrar sola encima o debajo del resumen, según la atribución de Google del contenido en otro lugar.

Para la atribución, usa el texto “Resumido por IA”, como se muestra en esta imagen:

Para la atribución, usa el texto Resumido por IA.

Resumen de la IA generativa que se muestra de forma aislada

Cuando un resumen de IA generativa aparece en aislamiento de cualquier otro contenido de Google Maps, debe incluir la atribución de IA generativa y la atribución a Google separadas por un punto. Para la atribución, usa el texto "Resumido por IA" y el logotipo de Google como se muestra en esta imagen:

Para que el resumen se muestre de forma aislada, incluye la atribución de IA generativa y la atribución de Google separadas por un punto.

Resumen de la IA generativa repetido en una lista

Cuando se repite la descripción general del resumen del lugar de la IA generativa en una lista de lugares, en las que todos hacen lo siguiente:

  • El contenido de la lista se atribuye a Google
  • Los resúmenes que se muestran son generados por IA
  • El contenido está disponible en Google

La atribución debe mostrarse encima o debajo de la lista en una sola línea. La atribución de IA está alineada a la izquierda y la de Google, a la derecha:

En el caso de una lista, muestra la atribución encima o debajo de la lista en una sola línea.

Si se usan resúmenes de descripciones de IA generativa más largos en una lista, cada resumen debe tener la atribución de IA ("Resumido por IA" con el botón o ícono de información).

Muestra información sobre un resumen de IA generativa en un diálogo

Junto con un resumen de IA generativa, debes hacer que un diálogo esté disponible para los usuarios finales en el que se muestre información sobre el resumen y un vínculo para informar problemas. Cuando uses un resumen de descripción de IA generativa, debes incluir información sobre las fuentes del resumen, llamadas references.

Para habilitar el acceso a este diálogo, incluye un ícono de información (como una asignación de interactividad) junto con la atribución de IA (como se muestra en los ejemplos anteriores) y haz que el área y el ícono de atribución de IA respondan a una presión o un clic.

Para los resúmenes generativos de lugares, muestra lo siguiente:

Información Los resúmenes de lugares basados en IA se generan a partir de las opiniones de Google y otros datos.
Cómo informar un problema Para informar a Google un problema relacionado con el contenido de un resumen, sigue este vínculo.
Referencias Opiniones de fuente

Por ejemplo:

Muestra información sobre un resumen de IA generativa en un diálogo.

Para los resúmenes del área generativa, muestra lo siguiente:

Información Los resúmenes del área creados con IA se generan a partir de las opiniones de Google y los datos locales.
Cómo informar un problema Para informar a Google un problema relacionado con el contenido de un resumen, sigue este vínculo.

Atribución del resumen del área de visualización.