Las capacidades del modelo de Gemini para la API de Places (nueva) admiten la API de Places para que puedas mostrar los datos asociados con un lugar (horarios de atención, opiniones, fotos) junto con los datos proporcionados por los LLM. Estos datos generativos contienen datos agregados y resumidos de los LLM para mejorar los datos ya 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 funciona bien si solo buscas el cargador de VE más cercano o el más cercano compatible con tu vehículo.
Pero es posible que también quieras comprender mejor el área alrededor de la estación de carga, especialmente si estarás allí durante una hora o más mientras se carga el vehículo. Cuando usas 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 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 comestibles, como Walmart, Whole Foods Market y Trader Joe's".
“A 1 a 5 minutos a pie, hay varias opciones de restaurantes y tiendas, como Khao Kang Thai Kitchen, Roger's Deli & Donuts y La Costeña. Joy Sushi es una buena opción para comer sushi. Para comestibles, 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 (nuevo)
Estas capacidades agregan los siguientes datos a una respuesta de la API de Places (nueva):
Resúmenes de lugares generados que están relacionados con un lugar específico. Los resúmenes de lugares son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).
Resúmenes de áreas generativas que se relacionan con un área específica alrededor de un lugar. Los resúmenes de área son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).
Los resultados de la búsqueda contextual son compatibles con Text Search (nueva) y contienen datos basados en la cadena de búsqueda pasada en la solicitud, en lugar de datos asociados directamente con un lugar. Estos datos ayudan a comprender cómo Text Search (nuevo) determina la respuesta.
Resúmenes de lugares generados
Los resúmenes de lugares generados son específicos para un ID de lugar. Los resúmenes de lugares agregan muchos tipos diferentes de datos en un único resumen del lugar.
La API de Places (nueva) proporciona dos tipos de resúmenes generativos de lugares:
Resúmenes de descripción general: Es una descripción general breve de un lugar (aproximadamente 100 caracteres en promedio) que puede 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, de aproximadamente 400 caracteres, que ofrecen una descripción general detallada de los aspectos principales del lugar.
Por el momento, 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 de áreas generativas
El LLM crea resúmenes de áreas generativas 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 este 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 IDs de lugar 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 incluye una lista de lugares asociados con actividades en el área y otro contiene una lista de restaurantes en el área.
Por el momento, los resúmenes de áreas están disponibles para los tipos de lugares que se muestran en la sección Tipos admitidos de la categoría Alojamiento, así como para los tipos de lugar específicos electric_vehicle_charging_station, geocode y premise.
Generación de resúmenes de lugares y áreas
Google genera con frecuencia y sin conexión los resúmenes generativos de lugares y los resúmenes de áreas generativas. Si generas estos resúmenes sin conexión, puedes aprovechar el contenido con tecnología de Gemini y, al mismo tiempo, seguir viendo el mismo rendimiento de la API de Places (nuevo) que ya esperabas.
Google regenera con frecuencia estos resúmenes para asegurarse de que estén actualizados en función de la información disponible más reciente. Es decir, 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 contextuales a la respuesta, esta 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 para el 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 usa las funciones nuevas, la respuesta puede incluir datos derivados de la cadena de consulta de entrada. Esto significa que los resultados de la búsqueda contextual son únicos para la cadena de consulta. Por ejemplo, haces una solicitud de Text Search (nueva) con la siguiente cadena de consulta:
"Restaurante vegetariano picante en Mountain View, California"
Luego, debes dejar todos los parámetros de entrada iguales y solo cambiar la cadena de consulta a lo siguiente:
"Restaurante vegano picante en Buenos Aires, Argentina"
En el caso de 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 en sí. Sin embargo, los resultados de la búsqueda contextual son únicos de la consulta porque se derivan de la cadena de consulta. Luego, puedes mostrar las opiniones, fotos y justificaciones de los resultados de la búsqueda contextuales a tus usuarios para ayudarlos a decidir qué lugar de la respuesta es el más adecuado para sus solicitudes de búsqueda.
Habilita las capacidades del modelo de Gemini para la API de Places (Nuevo)
Debes habilitar la API de Places (nueva) para usar las capacidades del modelo de Gemini para la API de Places (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 y solo 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 lugares
Los resúmenes de lugar son resúmenes generativos creados por el LLM para un lugar específico. La API de Places (nueva) agrega dos tipos de resúmenes a una respuesta:
Descripción general: Son resúmenes generativos similares al resumen editorial estático asociado con un lugar. Los resúmenes generativos cortos, de alrededor de 100 caracteres en promedio, tienen varias ventajas:
Muchos lugares no tienen resúmenes editoriales, por lo que llenan la información disponible sobre un lugar.
Se generan a partir del LLM, por lo que no es necesario que el propietario del lugar las mantenga.
Los resúmenes generativos de Descripción se derivan de muchas fuentes, incluidas las opiniones de Google Maps. La descripción, que tiene un promedio de 400 caracteres, incluye una lista de opiniones que se usaron 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, cree y mantenga el contenido de forma manual. Las capacidades del modelo de Gemini para la API de Places (nueva) compilan estos resúmenes a partir de los LLM para 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 del lugar en la respuesta, incluye el siguiente campo en la máscara de campo de la solicitud:
Detalles del lugar:
generativeSummaryText Search y Nearby Search:
places.generativeSummary
El campo generativeSummary contiene los siguientes campos:
generativeSummary.overview: El resumen generativo de la descripción general.generativeSummary.description: El resumen de la descripción generativa.generativeSummary.references: Es un array de hasta cinco opiniones que se usan para proporcionar contenido en el resumen de la descripción. Si no hay un resumen de la descripción, este array está vacío.
Ejemplo de solicitud de resumen de la descripción general
Este ejemplo de Text Search muestra solo el resumen de overview para los restaurantes vegetarianos picantes en Mountain View, CA:
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 descripción general y solicitud de resumen de la descripción
En este ejemplo, se realiza la misma consulta que en el ejemplo anterior, pero se usa una máscara de campo de 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 de áreas son resúmenes generativos creados por el LLM para el área cercana de un lugar. Los resúmenes de áreas 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 que rodea el hotel. En lugar de mirar un mapa del área circundante y tener que investigar cada lugar en el mapa, puedes generar un resumen del área del hotel.
Los resúmenes de área son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo).
Para incluir el resumen del área en la respuesta, incluye 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 un array de hasta cuatro contentBlocks.
El tema de cada bloque se basa en el tipo de lugar:
En el caso de una estación de carga de VE, que se define como un lugar del 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 lugar específicos
geocodeypremise, los bloques de temas incluyen:"overview","activity","restaurant"y"store".
Ejemplo de solicitud de resumen del á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
topicespecifica 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
contentincluye el resumen de ese tema y el código de idioma.El array
referencesespecifica los nombres de 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"
]
}
}
]
}
}
Ejemplo de solicitud de un resumen del área de un hotel
En este ejemplo de solicitud de Text Search 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 Places de tipo hotel incluye 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 (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 Text Search (nueva) contiene un array nuevo llamado contextualContents en el mismo nivel que el array places de la respuesta:
{
"places": [],
"contextualContents":[]
}
Cada elemento del array contextualContents, de tipo ContextualContent, se encuentra en la ubicación correspondiente del array que es 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 incluye 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 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": "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 experiencias automotrices. Si renderizas 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 vuelva a la ruta rápidamente.
- No más de 3 líneas
- 120 caracteres o 24 palabras o menos
- Tamaño mínimo frontal de 24 dp
En particular, en contextos automotores, es responsabilidad del desarrollador procesar los resúmenes de la IA generativa de formas 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.
Mostrar atribuciones para los 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 en función de cómo muestras los resúmenes de la IA generativa en tu app.
En todos los casos, la atribución debe usar el uso de mayúsculas y minúsculas. La atribución y el logotipo de Google deben cumplir con todos los estándares de color, estilo y tipografía. Si deseas 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 que se muestra en el contexto de otros datos de Google
En este caso, la atribución de IA generativa se puede mostrar sola por 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:
El resumen de la IA generativa se muestra de forma aislada
Cuando un resumen de IA generativa aparece de forma aislada de cualquier otro contenido de Google Maps, debe incluir la atribución de IA generativa y la atribución a Google separadas por una intersección. Para la atribución, usa el texto “Resumido por IA” y el logotipo de Google como se muestra en esta imagen:
Resumen de la IA generativa repetido en una lista
Cuando se repite una descripción general del resumen del lugar de IA generativa en una lista de lugares, en la que ocurre lo siguiente:
- El contenido de la lista se atribuye a Google
- Los resúmenes que se muestran están generados por IA
- El contenido está disponible en Google
La atribución debe aparecer encima o debajo de la lista en una sola línea. La atribución de IA está alineada a la izquierda, y la atribución de Google está alineada a la derecha:
Si se usan resúmenes de descripciones de IA generativa más largos en una lista, cada resumen debe tener una atribución de IA ("Resumido por IA" con el ícono o botón de información).
Mostrar información sobre un resumen de IA generativa en un diálogo
Junto con el resumen de la 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. Cuando uses un resumen de la descripción de la IA generativa, debes incluir información sobre las fuentes del resumen, lo que se denomina references.
Para habilitar el acceso a este diálogo, incluye un ícono de información (como una opció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 creados con IA se generan a partir de las opiniones de Google y otros datos. |
| Cómo informar un problema | Para informar a Google un problema con el contenido de un resumen, sigue este vínculo. |
| Referencias | Opiniones de fuentes |
Por ejemplo:
Para ver los resúmenes de áreas generativas, muestra lo siguiente:
| Información | Los resúmenes de áreas basadas en IA se generan a partir de opiniones en Google y datos locales. |
| Cómo informar un problema | Para informar a Google un problema con el contenido de un resumen, sigue este vínculo. |
