Os recursos do modelo Gemini para a API Places (novos) oferecem suporte a LLMs na API Places para que você possa retornar os dados associados a um lugar (horários de funcionamento, avaliações, fotos) com os dados fornecidos por LLMs. Esses dados generativos contêm dados agregados e resumidos dos LLMs para melhorar os dados já associados a um lugar.
Por exemplo, uma Pesquisa por texto (nova) padrão para "estações de recarga de VEs" retorna uma lista de lugares que oferecem recarga de VEs. Esse tipo de resposta é adequado se você estiver procurando o carregador de VE mais próximo ou o mais compatível com seu veículo.
No entanto, você também pode entender melhor a área ao redor da estação de recarga, principalmente se você for ficar lá por uma hora ou mais enquanto o veículo carrega. Ao usar os recursos do modelo do Gemini para essa mesma pesquisa, a resposta pode conter descrições dinâmicas e generativas de cada lugar na resposta, incluindo informações sobre a área ao redor da estação de recarga:
"A dois a quatro minutos a pé, há várias opções de restaurantes e lojas, incluindo o Chef Chu's, o Gen Korean BBQ House, o Amber India, o Pacific Catch e várias mercearias, como o Walmart, o Whole Foods Market e o Trader Joe's".
"Em um raio de 1 a 5 minutos de caminhada, há várias opções de restaurantes e compras, incluindo o Khao Kang Thai Kitchen, o Roger's Deli & Donuts e o La Costeña. Para sushi, o Joy Sushi é uma boa opção. Para compras de supermercado, a Dollar Tree oferece uma variedade de produtos com preços promocionais."
Esse conteúdo generativo dos LLMs melhora a resposta e fornece mais informações para ajudar os usuários a tomar decisões mais conscientes.
Novos recursos com tecnologia de IA adicionados à API Places (novo)
Esses recursos adicionam os seguintes dados a uma resposta da API Places (nova):
Resumos de lugares generativos, que estão relacionados a um lugar específico. Os resumos de lugar são compatíveis com Place Details (novo), Text Search (novo) e Nearby Search (novo).
Resumos de áreas generativas, que estão relacionados a uma área específica ao redor de um lugar. Os resumos de área são compatíveis com Place Details (novo), Text Search (novo) e Nearby Search (novo).
A pesquisa contextual é compatível com a Pesquisa de texto (novo) e contém dados com base na string de pesquisa transmitida na solicitação, em vez de dados diretamente associados a um lugar. Esses dados ajudam a entender como a Pesquisa de texto (nova) determina a resposta.
Resumos de lugares generativos
Os resumos de lugares generativos são específicos para um ID de lugar. Os resumos de lugar agregam muitos tipos diferentes de dados em um único resumo do lugar.
A API Places (nova) oferece dois tipos de resumos de lugares generativos:
Resumos: informações gerais sobre um lugar, com cerca de 100 caracteres em média, que podem ajudar os usuários a ter uma ideia de um lugar.
Resumos da descrição: resumos mais longos de um lugar, com uma média de 400 caracteres, que fornecem uma visão geral detalhada dos principais aspectos do lugar.
No momento, os resumos de lugar estão disponíveis para os tipos de lugar mostrados em Tipos compatíveis nas categorias Cultura, Entretenimento e recreação, Comida e bebida, Compras e Esportes.
Resumos de áreas generativas
Os resumos de área generativa são criados pelo LLM para a área próxima de um lugar. O resumo de área de um lugar pode conter todas as informações necessárias para um usuário tomar uma decisão, sem que ele precise fazer outras solicitações para detalhar a área.
Junto com uma descrição da área, a resposta também contém uma lista de IDs de lugar para os locais mencionados na descrição e uma lista de lugares classificados por diferentes tipos de conteúdo. Por exemplo, um tipo de conteúdo contém uma lista de lugares associados a atividades na área, e outro contém uma lista de restaurantes na área.
No momento, os resumos de área estão disponíveis para os tipos de lugar mostrados em Tipos compatíveis na categoria Hospedagem, além dos tipos específicos electric_vehicle_charging_station, geocode e premise.
Geração de resumos de lugares e áreas
Os resumos de lugares generativos e de áreas generativas são gerados off-line com frequência pelo Google. Ao gerar esses resumos off-line, você pode aproveitar o conteúdo gerado pelo Gemini e ainda ter a mesma performance da API Places (nova).
O Google regenera esses resumos com frequência para garantir que eles estejam atualizados com base nas informações mais recentes disponíveis. Isso significa que você vai mostrar os dados mais recentes no seu serviço ao chamar a API.
Resultados da pesquisa contextual
Uma pesquisa de texto (nova) retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo" ou "loja de sapatos perto do Rio de Janeiro". A resposta da Pesquisa de texto (nova) contém uma lista de lugares correspondentes à string de texto e a todos os direcionamentos de local definidos na solicitação.
Quando você adiciona resultados da pesquisa contextual à resposta, ela agora inclui avaliações, fotos e justificativas que ajudam os usuários a responder às perguntas:
- Por que estou vendo esse lugar nos resultados?
- Por que eu deveria escolher esse lugar?
Por exemplo, você faz uma solicitação para Place Details (novo), Text Search (novo) ou Nearby Search (novo) hoje que inclui um lugar específico na resposta. Os dados de resposta para o local são os mesmos para as três solicitações porque os dados retornados estão associados a ele.
No entanto, para uma pesquisa de texto (nova) usando os novos recursos, a resposta pode incluir dados derivados da string de consulta de entrada. Isso significa que os resultados da pesquisa contextual são exclusivos da string de consulta. Por exemplo, você faz uma solicitação de pesquisa de texto (nova) com a seguinte string de consulta:
"Spicy vegetarian restaurant in Mountain View, CA"
Em seguida, deixe todos os parâmetros de entrada iguais e mude apenas a string de consulta para:
"Restaurante vegano e apimentado em Mountain View, CA"
Para um restaurante que aparece nas duas respostas, os dados de resposta sobre o local são os mesmos porque estão associados ao próprio local. Mas os resultados da pesquisa contextuais são exclusivos da consulta, porque são derivados da string de consulta. Em seguida, mostre as avaliações, fotos e justificações dos resultados da pesquisa contextual para ajudar os usuários a decidir qual lugar na resposta é mais adequado para a solicitação de pesquisa.
Ativar os recursos do modelo Gemini para a API Places (novo)
É necessário ativar a API Places (nova) para usar os recursos de modelo Gemini para a API Places (nova). Para mais informações, consulte Configurar seu projeto do Google Cloud.
Restrições para a versão experimental
Esta versão só oferece suporte a resumos de lugares e áreas nos Estados Unidos em inglês.
O que é o Gemini?
Para saber mais sobre o modelo Gemini, consulte as Perguntas frequentes sobre o Gemini.
Solicitar um resumo de lugar generativo
Os resumos de lugar são resumos generativos criados pelo LLM para um lugar específico. A API Places (nova) adiciona dois tipos de resumos a uma resposta:
Visão geral: resumos generativos semelhantes ao resumo editorial estático associado a um lugar. Os resumos curtos generativos, com cerca de 100 caracteres em média, têm várias vantagens:
Muitos lugares não têm resumos editoriais, então eles preenchem uma lacuna nas informações disponíveis para um local.
Como são gerados pelo LLM, o proprietário não precisa fazer a manutenção deles.
Os resumos generativos de descrição são derivados de muitas fontes, incluindo avaliações do Google Maps. A descrição, que tem em média cerca de 400 caracteres, inclui uma lista de avaliações usadas para gerar a descrição longa.
Para gerar resumos de descrições manualmente, é necessário que uma pessoa agregue dados de muitos locais e, em seguida, crie e mantenha o conteúdo manualmente. Os recursos do modelo Gemini para a API Places (novo) criam esses resumos com base nos LLMs para manter o escopo e a atualidade do conteúdo gerado.
Os resumos de lugares são compatíveis com Place Details (novo), Text Search (novo) e Nearby Search (novo). Para incluir o resumo do lugar na resposta, inclua o campo a seguir na máscara de campo da solicitação:
Detalhes do lugar:
generativeSummaryText Search e Nearby Search:
places.generativeSummary
O campo generativeSummary contém os seguintes campos:
generativeSummary.overview: o resumo da visão geral generativa.generativeSummary.description: o resumo da descrição generativa.generativeSummary.references: uma matriz de até cinco avaliações usadas para fornecer conteúdo para o resumo da descrição. Se não houver um resumo de descrição, essa matriz estará vazia.overviewFlagContentUri: um link em que os usuários podem sinalizar um problema com o resumo da visão geral.descriptionFlagContentUri: um link em que os usuários podem sinalizar um problema com o resumo da descrição.
Exemplo de solicitação de resumo de visão geral e descrição
Este exemplo usa uma
máscara de campo de places.generativeSummary para retornar todo o objeto
generativeSummary, incluindo os campos generativeSummary.overview,
generativeSummary.description e 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
A resposta está no 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"
},
. . .
}Exemplo de solicitação de resumo da visão geral
Este exemplo de pesquisa de texto retorna apenas o resumo overview de restaurantes vegetarianos apimentados em 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
A resposta contém o campo generativeSummary.overview, que inclui o
overview.text e o 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"
}
}
},
. . .
}Solicitar um resumo da área geradora
Os resumos de área são resumos generativos criados pelo LLM para a área próxima de um lugar. Os resumos de área podem ser importantes para os usuários tomarem uma decisão sobre um lugar.
Por exemplo, você quer reservar um hotel em uma nova cidade e, embora encontre um que atenda aos seus requisitos, também quer saber mais sobre a área ao redor do hotel. Em vez de olhar um mapa da área ao redor e depois investigar cada lugar no mapa, você pode gerar um resumo da área para o hotel.
Os resumos de área são compatíveis com Place Details (novo), Text Search (novo) e Nearby Search (novo).
Para incluir o resumo da área na resposta, inclua na máscara de campo da solicitação:
areaSummary(Place Details)places.areaSummary(Pesquisa de texto e Nearby Search).
O campo areaSummary de um lugar na resposta contém o campo flagContentUri, que pode ser usado para sinalizar conteúdo inadequado para que o Google possa removê-lo. Ela também
contém uma matriz de até quatro
contentBlocks.
O tema de cada bloco é baseado no tipo de lugar:
Para um eletroposto, definido como um lugar do tipo
electric_vehicle_charging_station, os blocos de tópicos incluem:"overview","coffee","restaurant"e"store".Para um lugar com um tipo definido pela categoria Hospedagem e os tipos específicos
geocodeepremise, os blocos de temas incluem"overview","activity","restaurant"e"store".
Exemplo de solicitação de resumo de área de um eletroposto
Este exemplo de solicitação do Place Details retorna o resumo da área de uma estação de recarga de VE específica em Mountain View, identificada pelo 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
A resposta contém o campo areaSummary, incluindo a matriz
contentBlocks:
O campo
topicespecifica o tipo de bloco de conteúdo. Como o lugar neste exemplo é um eletroposto, os quatro blocos de conteúdo são"overview","coffee","restaurant"e"store".O campo
contentinclui o resumo do tópico, incluindo o código de idioma.A matriz
referencesespecifica os nomes dos recursos de lugar, no formatoplaces/PLACE_ID, usados para fornecer conteúdo para o bloco de conteúdo.
{
"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"
}
}Exemplo de solicitação de resumo de área para um hotel
Este exemplo de solicitação do Text Search solicita hotéis em 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
A resposta contém o campo areaSummary, incluindo a matriz
contentBlocks. A resposta para lugares do tipo hotel contém blocos de conteúdo para os tópicos "overview", "activity", "restaurant" e "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" } }, ... ] }
Solicitar resultados da pesquisa contextual
A resposta a uma solicitação de Text Search (novo) contém uma matriz de lugares que correspondem aos critérios da string de pesquisa de entrada. Agora é possível solicitar dados de pesquisa contextual na resposta com base na consulta de entrada para a API.
Para oferecer suporte a resumos contextuais, a resposta de
Pesquisa de texto (novo)
contém uma nova matriz chamada contextualContents no mesmo nível que a
matriz places na resposta:
{
"places": [],
"contextualContents":[]
}Cada elemento na matriz contextualContents, do tipo
ContextualContent,
está no local correspondente da matriz como o lugar na matriz places. Ou seja, o elemento em contextualContents[0] corresponde ao lugar em places[0].
Cada elemento da matriz contém os seguintes campos de matriz:
contextualContents.reviews: uma matriz de até três avaliações.contextualContents.photos: uma matriz de até cinco fotos.contextualContents.justifications: uma matriz de justificações para o lugar, incluindo:reviewJustification: destaque uma seção de uma avaliação do usuário que possa ser do interesse do usuário final.businessAvailabilityAttributesJustification: inclui atributos de uma empresa que podem ser de interesse para um usuário final.
Para incluir os resultados da pesquisa contextual na resposta, inclua
contextualContents na
máscara de campo
da solicitação de pesquisa de texto (nova):
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
A resposta contém a matriz contextualContents para cada local na resposta:
{
"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
}
}
]
},
. . .
]
}Orientações de implementação para casos de uso automotivo
Para a segurança do motorista, o Google recomenda renderizar resumos de IA generativa no modo estacionado para experiências automotivas. Se você renderizar resumos no modo de direção, as informações na tela precisam ser simples, claras e concisas para garantir que a atenção do motorista volte rapidamente para a estrada.
- Não mais do que 3 linhas
- 120 caracteres ou 24 palavras ou menos
- Tamanho mínimo da parte frontal de 24 dp
Principalmente em contextos automotivos, é responsabilidade do desenvolvedor renderizar resumos de IA generativa de maneiras seguras e em conformidade com todas as leis e regulamentações locais.
Atribuições
Ao mostrar avaliações, fotos e resumos de IA generativa no seu app, incluindo resumos de lugares e áreas, você também precisa mostrar as atribuições necessárias.
Mostrar atribuições para resumos generativos
Ao mostrar resumos de IA generativa no app, incluindo resumos de local e de área, você também precisa mostrar as atribuições necessárias. Esta seção descreve como mostrar atribuições com base na forma como você exibe os resumos da IA generativa no app.
Em todos os casos, a atribuição precisa usar letras maiúsculas. A atribuição e o logotipo do Google precisam estar em conformidade com todos os padrões de cor, estilo e tipo de letra. Para mais informações sobre esses padrões, consulte Políticas da API Places (nova).
Resumo da IA generativa exibido no contexto de outros dados do Google
Nesse caso, a atribuição de IA generativa pode ser exibida sozinha acima ou abaixo do resumo, dependendo da atribuição do Google do conteúdo em outro lugar.
Para a atribuição, use o texto "Resumo feito por IA", conforme mostrado nesta imagem:
Resumo da IA generativa exibido de forma isolada
Quando um resumo de IA generativa aparece isolado de qualquer outro conteúdo do Google Maps, ele precisa incluir a atribuição de IA generativa e a atribuição ao Google separadas por um ponto-e-vírgula. Para a atribuição, use o texto "Resumido por IA" e o logotipo do Google, conforme mostrado nesta imagem:
Resumo da IA generativa repetido em uma lista
Ao repetir uma visão geral do resumo do lugar da IA generativa em uma lista de lugares, em que todos:
- O conteúdo da lista é atribuído ao Google
- Os resumos mostrados são gerados por IA
- O conteúdo está disponível no Google
A atribuição precisa aparecer acima ou abaixo da lista em uma única linha. A atribuição de IA é alinhada à esquerda, e a atribuição do Google é alinhada à direita:
Se resumos de descrição de IA generativa mais longos forem usados em uma lista, cada resumo precisará ter atribuição de IA ("Resumido por IA" com o ícone/botão de informações).
Mostrar informações sobre um resumo da IA generativa em uma caixa de diálogo
Além de um resumo de IA generativa, é necessário disponibilizar uma caixa de diálogo para os usuários finais
que mostre informações sobre o resumo e um link para informar problemas
usando o identificador exclusivo do resumo contido no
campo
flagContentUri. Ao usar um resumo de descrição
de IA generativa, é necessário incluir informações sobre
as fontes do resumo, chamadas de referências.
Para permitir o acesso a essa caixa de diálogo, inclua um ícone de informações (como um affordance de interatividade) em conjunto com a atribuição de IA (como mostrado nos exemplos acima) e faça com que a área e o ícone de atribuição de IA respondam a um toque/clique.
Para resumos de lugares generativos, mostre:
| Sobre | Os resumos de lugares gerados pela IA são criados com base em avaliações do Google e outros dados. |
| Informar um problema | Para informar um problema ao Google sobre o conteúdo de um resumo, use o
link contido no campo
flagContentUri. |
| Referências | Avaliações de origem |
Exemplo:
Para resumos de área generativa, mostre:
| Sobre | Os resumos de área da IA são gerados com base em avaliações do Google e dados locais. |
| Informar um problema | Para informar um problema ao Google sobre o conteúdo de um resumo, use o
link contido no campo
flagContentUri. |
