Las capacidades del modelo de Gemini para la API de Places (nuevas) brindan compatibilidad con los LLM a la API de Places para que puedas mostrar los datos asociados con un lugar (horario de atención, opiniones, fotos) junto con los datos que proporcionan los LLM. Estos datos generativos contienen datos agregados y resumidos de los LLM para mejorar los datos ya asociados con un lugar.
Por ejemplo, una Text Search (nueva) estándar para "estaciones de carga de VE" muestra una lista de lugares que ofrecen carga de VE. Este tipo de respuesta es adecuado si solo buscas el cargador de VE más cercano o el más compatible con tu vehículo.
Sin embargo, también te recomendamos que conozcas mejor el área que rodea la estación de carga, en especial si vas a estar allí durante una hora o más mientras se carga el vehículo. Cuando se usan las capacidades del modelo de Gemini para esa misma búsqueda, la respuesta puede contener descripciones generativas y dinámicas de cada lugar de la respuesta, incluida información sobre el área alrededor de la estación de carga:
“A una distancia de 2 a 4 minutos a pie, hay varias opciones de restaurantes y tiendas, como Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch y varias tiendas de comestibles, como Walmart, Whole Foods Market y Trader Joe's”.
“A 1 o 5 minutos a pie, hay varias opciones de restaurantes y tiendas, como Khao Kang Thai Kitchen, Roger's Deli & Donuts y La Costeña. Para comer sushi, Joy Sushi es una buena opción. En el caso de los comestibles, Dollar Tree ofrece una variedad de productos a precios con descuento".
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 impulsadas por IA a la API de Places (nuevo)
Estas funciones agregan los siguientes datos a una respuesta de la API de Places (nueva):
Resumenes generativos de lugares que se relacionan con un lugar específico. Los resúmenes de lugares son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).
Resumenes de áreas generativas que se relacionan con un área específica alrededor de un lugar. Place Details (nueva), Text Search (nueva) y Nearby Search (nueva) admiten resúmenes de áreas.
Text Search (nuevo) es compatible con los resultados de la búsqueda contextual y contiene datos basados en la cadena de búsqueda que se pasa en la solicitud, en lugar de datos directamente asociados con un lugar. Estos datos ayudan a comprender cómo Text Search (nueva) determina la respuesta.
Resúmenes generativos de lugares
Los resúmenes generativos de lugares son específicos de un ID de lugar. Los resúmenes de lugares agregan muchos tipos de datos diferentes en un solo resumen del lugar.
La API de Places (nueva) proporciona dos tipos de resúmenes generativos de lugares:
Resumen general: Es una breve descripción general de un lugar, de alrededor de 100 caracteres en promedio, que puede ayudar a los usuarios a obtener un resumen de un lugar.
Resumen de la descripción: Son resúmenes más largos de un lugar, en promedio, de alrededor de 400 caracteres, que proporcionan una descripción general detallada de los aspectos más importantes del lugar.
Actualmente, los resúmenes de lugares están disponibles para los tipos de lugares que se muestran en Tipos compatibles para las categorías Cultura, Entretenimiento y recreación, Comida y bebida, Compras y Deportes.
Resúmenes de áreas generativas
El LLM crea resúmenes de áreas generativas para el área cercana a 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 tenga que realizar más solicitudes para desglosar los detalles del área.
Además de una descripción del área, la respuesta también contiene una lista de los IDs de los lugares a los que se hace referencia en la descripción y una lista de lugares ordenados por diferentes tipos de contenido. Por ejemplo, un tipo de contenido contiene una lista de lugares asociados con actividades en el área y otro contiene una lista de restaurantes en el área.
Actualmente, los resúmenes de áreas están disponibles para los tipos de lugares que se muestran en Tipos admitidos de 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 sin conexión los resúmenes de lugares generativos y de áreas generativas. Si generas estos resúmenes sin conexión, puedes aprovechar el contenido potenciado por Gemini y, al mismo tiempo, ver el mismo rendimiento de la API de Places (nueva) que ya esperas.
Google regenera estos resúmenes con frecuencia para garantizar que estén actualizados según la información más reciente disponible. Eso 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 (nueva) muestra información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Buenos Aires" o "tiendas de zapatos cerca de Santiago". La respuesta de Text Search (nueva) 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 contextual a la respuesta, esta ahora incluye opiniones, fotos y justificaciones que ayudan a los usuarios a responder las siguientes 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, ya que los datos que se muestran están asociados con ese lugar.
Sin embargo, en el caso de una Text Search (nueva) que usa las nuevas funciones, la respuesta puede incluir datos derivados de la propia cadena de consulta de entrada. Esto significa que los resultados de la búsqueda contextual son únicos para la cadena de consulta. Por ejemplo, realizas una solicitud de Text Search (nueva) con la siguiente cadena de consulta:
"Restaurante vegetariano picante en Mountain View, California"
Luego, dejas todos los parámetros de entrada iguales y solo cambias la cadena de consulta a lo siguiente:
"Restaurante vegano picante en Mountain View, California"
En el caso de un restaurante que aparece en ambas respuestas, los datos de la respuesta sobre el lugar son los mismos, ya que esos datos están asociados con el lugar en sí. Sin embargo, los resultados de la búsqueda contextual son únicos para la búsqueda, ya que se derivan de la cadena de búsqueda. Luego, puedes mostrarles a los usuarios las opiniones, las fotos y las justificaciones de los resultados de la búsqueda contextual para ayudarlos a decidir qué lugar de la respuesta es más aplicable a su solicitud de búsqueda.
Habilita las funciones del modelo de 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 de la versión experimental
Esta versión solo admite resúmenes de lugares y áreas de Estados Unidos en inglés.
¿Qué es Gemini?
Para obtener información sobre el modelo de Gemini, consulta las Preguntas frecuentes de Gemini.
Solicita un resumen generativo de un lugar
Los resúmenes de lugares son resúmenes generativos que crea el LLM para un lugar específico. La API de Places (nueva) agrega dos tipos de resúmenes a una respuesta:
Son resúmenes generativos de Descripción general que son similares al resumen editorial estático asociado con un lugar. Los resúmenes breves generativos, que tienen un promedio de alrededor de 100 caracteres, tienen varias ventajas:
Muchos lugares no tienen resúmenes editoriales, por lo que estos cubren una brecha en la información disponible sobre un lugar.
Se generan desde el LLM, por lo que el propietario del lugar no necesita mantenerlos.
Los resúmenes generativos de la descripción provienen 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, una persona debe agregar datos de muchas ubicaciones y, luego, crear y mantener el contenido de forma manual. Las capacidades del modelo de Gemini para la API de Places (nuevas) compilan estos resúmenes a partir de los LLM para mantener el alcance y la actualización 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 del lugar en la respuesta, incluye el siguiente campo en la máscara de campo de la solicitud:
Place Details:
generativeSummary
Búsqueda de texto y Búsqueda cercana:
places.generativeSummary
El campo generativeSummary
contiene los siguientes campos:
generativeSummary.overview
: Es el resumen general generativo.generativeSummary.description
: Es el resumen de la descripción generativa.generativeSummary.references
: Es un array de hasta cinco opiniones que se usan para proporcionar contenido para el resumen de la descripción. Si no hay un resumen de la descripción, este array estará vacío.overviewFlagContentUri
: Es un vínculo en el que los usuarios pueden marcar un problema con el resumen general.descriptionFlagContentUri
: Es un vínculo en el que los usuarios pueden marcar un problema con el resumen de la descripción.
Ejemplo de solicitud de resumen de descripción y descripción general
En este ejemplo, se usa una máscara de campo de places.generativeSummary
para mostrar todo el objeto generativeSummary
, incluidos los campos generativeSummary.overview
, generativeSummary.description
y generativeSummary.references
:
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" \ https://places.googleapis.com/v1/places:searchText
La respuesta tiene el siguiente formato:
{ "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": "John Smith", "uri": "https://www.google.com/maps/contrib/11685942231/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo" }, "publishTime": "2023-05-09T07:24:36Z" "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670" }, . . . ] }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12", "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12" } }, { "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" }, . . . }
Ejemplo de solicitud de resumen general
En este ejemplo, la Búsqueda de texto muestra solo el resumen overview
de 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" } } }, . . . }
Solicita un resumen del área generativa
Los resúmenes de área son resúmenes generativos que crea el LLM para el área cercana de un lugar. Los resúmenes de áreas pueden ser importantes para los usuarios que toman decisiones sobre un lugar.
Por ejemplo, quieres 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 que rodea el hotel. En lugar de mirar un mapa del área circundante y, luego, tener que investigar cada lugar del mapa, puedes generar un resumen del área del hotel.
Place Details (nueva), Text Search (nueva) y Nearby Search (nueva) admiten resúmenes de áreas.
Para incluir el resumen del área en la respuesta, incluye lo siguiente 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 en la respuesta contiene el campo flagContentUri
que puedes usar para marcar contenido inapropiado para que Google lo quite. También contiene un array de hasta cuatro contentBlocks
.
El tema de cada bloque se basa en el tipo de lugar:
Para una estación de carga de VE, definida como un lugar de tipo
electric_vehicle_charging_station
, los bloques de temas incluyen"overview"
,"coffee"
,"restaurant"
y"store"
.Para un lugar con un tipo definido por la categoría Alojamiento y los tipos de lugares específicos
geocode
ypremise
, los bloques de temas incluyen"overview"
,"activity"
,"restaurant"
y"store"
.
Ejemplo de solicitud de resumen de área de una estación de carga de VE
En este ejemplo de solicitud a Place Details, se 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. Como el lugar de este ejemplo es 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 formatoplaces/PLACE_ID
, que se usan para proporcionar contenido para el 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" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12" } }
Ejemplo de solicitud de resumen de área de un hotel
En este ejemplo de solicitud de Búsqueda de texto, se solicitan hoteles en Mountain View, California:
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" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12" } }, ... ] }
Cómo solicitar resultados de la búsqueda contextual
La respuesta a una solicitud de Text Search (nueva) contiene un array de lugares que coinciden con los criterios de la cadena de búsqueda de entrada. Ahora puedes solicitar datos de búsqueda contextual en la respuesta según la consulta de entrada a la API.
Para admitir resúmenes contextuales, la respuesta de la Búsqueda de texto (nueva) 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 del array correspondiente como el lugar en el array places
. Es decir, el elemento en contextualContents[0]
corresponde al lugar en places[0]
.
Cada elemento del array contiene los siguientes campos:
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 incluye lo siguiente:reviewJustification
: Destaca una sección de una opinión de un usuario que podría ser de interés para un 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 Búsqueda de texto (nueva):
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 de la respuesta:
{ "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": "Jane Doe", "uri": "https://www.google.com/maps/contrib/113193/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100" }, "publishTime": "2023-04-18T02:48:02Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db" }, { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB", "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": "Bob Jones", "uri": "https://www.google.com/maps/contrib/11034435/reviews", "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100" }, "publishTime": "2023-07-03T16:51:49Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db" }, . . . ], "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/113010465422", "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo" } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db" }, { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo", "widthPx": 960, "heightPx": 720, "authorAttributions": [ { "displayName": "Toast" } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db" }, . . . ], "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": "Stan Davis", "uri": "https://www.google.com/maps/contrib/112959/reviews", "photoUri": "https://lh3.googleuser-cc-rp-mo" }, "publishTime": "2023-06-18T06:12:41Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1", "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db" } } }, { "businessAvailabilityAttributesJustification": { "dineIn": true } } ] }, . . . ] }
Orientación para la implementación de casos de uso de la industria automotriz
Para la seguridad del conductor, Google recomienda renderizar resúmenes de IA generativa en el modo estacionado para las experiencias de la industria automotriz. Si se renderizan resúmenes en el modo de conducción, la información en pantalla debe ser simple, clara y concisa para garantizar que la atención del conductor vuelva rápidamente a la ruta.
- No más de 3 líneas
- 120 caracteres o 24 palabras o menos
- Tamaño frontal mínimo de 24 dp
En especial, en contextos de la industria automotriz, es responsabilidad del desarrollador renderizar resúmenes de IA generativa de manera segura y que satisfaga todas las leyes y reglamentaciones locales.
Atribuciones
Cuando muestres opiniones, fotos y resúmenes de IA generativa en tu app, incluidos los resúmenes de lugares y áreas, debes asegurarte de mostrar las atribuciones requeridas.
Cómo mostrar atribuciones para resúmenes generativos
Cuando muestres resúmenes de IA generativa en tu app, incluidos los 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 la forma en que muestres los resúmenes de IA generativa en tu app.
En todos los casos, la atribución debe usar mayúsculas iniciales. 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 de la API de Places (nueva).
Resumen de la IA generativa que se muestra en el contexto de otros datos de Google
En este caso, la atribución de IA generativa se puede mostrar sola sobre o debajo del resumen, y se basa en la atribución de Google del contenido en otro lugar.
Para la atribución, usa el texto "Resumen de IA", como se muestra en esta imagen:
Resumen de IA generativa que se muestra de forma aislada
Cuando un resumen de IA generativa aparece de forma independiente de cualquier otro contenido de Google Maps, debe incluir la atribución de IA generativa y la atribución a Google separadas por un signo de puntuación. Para la atribución, usa el texto "Resumen con IA" y el logotipo de Google, como se muestra en esta imagen:
Resumen de IA generativa repetido en una lista
Cuando se repite una descripción general del resumen de lugares de IA generativa en una lista de lugares, en la que se cumplen todas las siguientes condiciones:
- 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 en una sola línea, arriba o debajo de la lista. La atribución de IA está alineada a la izquierda y la de Google está alineada a la derecha:
Si se usan resúmenes de descripciones de IA generativa de formato más largo en una lista, cada resumen debe tener atribución de IA ("Resumen de IA" con el ícono o botón de información).
Cómo mostrar información sobre un resumen de IA generativa en un diálogo
Junto con un resumen de IA generativa, debes poner a disposición de los usuarios finales un diálogo que muestre información sobre el resumen y un vínculo para informar problemas con el identificador único del resumen contenido en el campo flagContentUri
. Cuando uses un resumen de descripción de IA generativa, debes incluir información sobre las fuentes del resumen, llamadas referencias.
Para habilitar el acceso a este diálogo, incluye un ícono de información (como un indicador 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.
En el caso de los resúmenes generativos de lugares, muestra lo siguiente:
Acerca de | Los resúmenes de lugares generados por IA se basan en las opiniones de Google y otros datos. |
Informa un problema | Para informar un problema a Google sobre el contenido de un resumen, usa el vínculo que se encuentra en el campo flagContentUri . |
Referencias | Opiniones de fuentes |
Por ejemplo:
Para los resúmenes de áreas generativas, muestra lo siguiente:
Acerca de | Los resúmenes de áreas generados por IA se basan en las opiniones de Google y los datos locales. |
Informa un problema | Para informar un problema a Google sobre el contenido de un resumen, usa el vínculo que se encuentra en el campo flagContentUri . |