Os recursos de modelo do Gemini para a API Places (nova) oferecem suporte para LLMs à API Places para que você possa retornar os dados associados a um lugar (horário de funcionamento, avaliações, fotos) com dados fornecidos por LLMs. Esses dados generativos contêm dados agregados e resumidos dos LLMs para aprimorar os dados já associados a um local.
Por exemplo, uma Pesquisa de texto (novo) padrão para "postos de recarga de VE" retorna uma lista de lugares que oferecem carregamento de VE. Esse tipo de resposta é bom se você está apenas procurando o carregador de VE mais próximo ou o compatível com seu veículo.
Mas talvez seja melhor entender melhor a área ao redor da estação de recarga, principalmente se você vai 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 uma caminhada de 2 a 4 minutos, há várias opções de restaurantes e lojas, incluindo Chef Chu's, Gen Korean Churrascaria, Amber India, Pacific Catch e vários mercados, como Walmart, Whole Foods Market e Trade Joe's."
"A cerca de 1 a 5 minutos a pé, há várias opções de restaurantes e lojas, 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 mantimentos, a Dollar Tree oferece uma variedade de produtos com descontos."
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 lugares são compatíveis com Place Details (novo), Text Search (novo) e Nearby Search (novo).
Resumos de área generativa, 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).
Os resultados da pesquisa contextual são compatíveis com o Text Search (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 o Text Search (novo) determina a resposta.
Resumos de lugares generativos
Os resumos de lugares generativos são específicos para um ID de lugar. Esses resumos agregam muitos tipos diferentes de dados em um único resumo do lugar.
A API Places (nova) oferece dois tipos de resumos generativos de lugares:
Resumos da visão geral: informações gerais breves sobre um lugar, com cerca de 100 caracteres, que podem ajudar os usuários a ter uma visão geral dele.
Resumos das descrições: resumos mais longos de um lugar, em média, com cerca de 400 caracteres, que fornecem uma visão geral detalhada sobre os principais aspectos do lugar.
No momento, os resumos de lugares estão disponíveis para 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 generativos são criados pelo LLM para a área próxima a um lugar. O resumo de área de um lugar pode conter todas as informações necessárias para que o usuário decida, 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
Tanto os resumos de lugares generativos quanto os 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 com tecnologia do Gemini e ainda ter o mesmo desempenho da API Places (nova) que já é esperado.
O Google gera novamente esses resumos com frequência para garantir que eles estejam atualizados com base nas informações mais recentes disponíveis. Isso significa que você exibirá os dados mais recentes em seu serviço quando chamar a API.
Resultados da pesquisa contextual
Uma Text Search (novo) 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 do Text Search (novo) contém uma lista de locais correspondentes à string de texto e a qualquer direcionamento de local definido 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, hoje você faz uma solicitação para Place Details (novo), Text Search (novo) ou Nearby Search (novo), 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 um Text Search (novo) que usa os novos recursos, a resposta pode incluir dados derivados da própria string de consulta de entrada. Isso significa que os resultados da pesquisa contextuais são exclusivos para a string de consulta. Por exemplo, você faz uma solicitação Text Search (novo) com a seguinte string de consulta:
"Restaurante vegetariano picante em Mountain View, CA"
Em seguida, você deixa todos os parâmetros de entrada iguais e altera a string de consulta apenas para:
"Restaurante vegana picante em Mountain View, CA"
Para um restaurante que aparece nas duas respostas, os dados sobre o lugar são os mesmos, porque estão associados ao próprio lugar. No entanto, os resultados da pesquisa contextuais são exclusivos da consulta, porque são derivados da string de consulta. É possível exibir as avaliações, fotos e justificativas dos resultados da pesquisa contextual aos usuários para ajudá-los a decidir qual local na resposta é mais aplicável à solicitação de pesquisa.
Ativar os recursos do modelo Gemini para a API Places (novo)
Ative a API Places (nova) para usar os recursos de modelo do Gemini na API Places (nova). Para mais informações, acesse Configurar seu projeto do Google Cloud.
Restrições da versão experimental
Esta versão só é compatível com resumos de lugares e áreas para locais nos Estados Unidos em inglês.
O que é o Gemini?
Para saber mais sobre o modelo do Gemini, consulte as perguntas frequentes sobre o Gemini.
Pedir um resumo generativo de lugares
Os resumos de lugares são resumos generativos criados pelo LLM para um local 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 breves generativos, com cerca de 100 caracteres, 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, em média, com 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 de modelo do Gemini para a API Places (nova) criam esses resumos com base nos LLMs para manter o escopo e a atualização 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 seguinte campo na máscara de campo da solicitação:
Place Details:
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 resumo da descrição, a matriz ficará vazia.
Exemplo de solicitação de resumo da visão geral
Este exemplo de Pesquisa de texto retorna apenas o resumo de overview para restaurantes vegetarianos picantes 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 overview.text e 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"
}
}
},
. . .
}
Exemplo de solicitação de visão geral e descrição de resumo
Este exemplo faz a mesma consulta mostrada no exemplo anterior, mas 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:
{
"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"
},
. . .
}
Solicitar um resumo da área generativa
Resumos de área são resumos generativos criados pelo LLM para a área próxima de um lugar. Os resumos da área são importantes para os usuários que decidem sobre um lugar.
Por exemplo, você quer reservar um hotel em uma cidade nova e pode encontrar um hotel que atenda às suas necessidades, mas também quer saber mais sobre a área ao redor do hotel. Em vez de analisar um mapa dos arredores e ter que investigar cada lugar nele, gere um resumo da área do 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 local na resposta contém uma matriz de até quatro contentBlocks.
O tema de cada bloco é baseado no tipo de lugar:
Para um eletroposto, definido como um local do tipo
electric_vehicle_charging_station, os blocos de temas 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 para o resumo da área de uma estação de recarga de VEs
Este exemplo de solicitação do Place Details retorna o resumo da área de uma estação de recarga de VEs 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 local neste exemplo é uma estação de recarga de VEs, os quatro blocos de conteúdo são"overview","coffee","restaurant"e"store".O campo
contentinclui o resumo desse tópico, incluindo o código do idioma.A matriz
referencesespecifica os nomes dos recursos de lugar, no formatoplaces/PLACE_ID, que são usados para fornecer conteúdo ao 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"
]
}
}
]
}
}
Exemplo de solicitação de resumo da área de 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"
]
}
}
]
}
},
...
]
}
Solicitar resultados da pesquisa contextuais
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 você pode solicitar dados de pesquisa contextuais na resposta com base na consulta de entrada para a API.
Para oferecer suporte a resumos contextuais, a resposta de
Text Search (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 da matriz correspondente, assim como na matriz places. Ou seja, o elemento em contextualContents[0] corresponde ao local 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 justificativas para o local, incluindo:reviewJustification: destaca uma seção da avaliação de usuário que pode ser interessante para um usuário final.businessAvailabilityAttributesJustification: inclui atributos de uma empresa que podem ser de interesse de um usuário final.
Para incluir os resultados da pesquisa contextual na resposta, inclua
contextualContents na
máscara de campo
da solicitação Text Search (novo):
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": "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
}
}
]
},
. . .
]
}
Orientações de implementação para casos de uso automotivos
Para segurança do motorista, o Google recomenda renderizar resumos de IA generativa no modo estacionado para experiências automotivas. Ao renderizar resumos no modo carro, as informações na tela precisam ser simples, claras e concisas para garantir que a atenção do motorista volte rapidamente para a estrada.
- No máximo 3 linhas
- 120 caracteres ou 24 palavras ou menos
- Tamanho mínimo da frente de 24 dp
Especialmente em contextos automotivos, é responsabilidade do desenvolvedor renderizar resumos de IA generativa de maneiras seguras e que obedeçam a 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 lugares e áreas, também é necessário mostrar as atribuições necessárias. Esta seção descreve como mostrar atribuições com base em como você mostra os resumos da IA generativa no seu app.
Em todos os casos, a atribuição precisa usar maiúsculas/minúsculas. A atribuição e o logotipo do Google precisam obedecer a todos os padrões de cor, estilo e família tipográfica. 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 da IA generativa pode ser mostrada sozinha acima ou abaixo do resumo, dependendo da atribuição do conteúdo do Google em outro lugar.
Para a atribuição, use o texto "Resumido por IA", conforme mostrado nesta imagem:
Resumo da IA generativa exibido isoladamente
Quando um resumo de IA generativa aparece isoladamente de qualquer outro conteúdo do Google Maps, ele precisa incluir a atribuição da IA generativa e a atribuição ao Google separadas por um ponto final. 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 de 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 deve ser exibida acima ou abaixo da lista em uma única linha. A atribuição de IA está alinhada à esquerda, e a atribuição do Google está alinhada à direita:
Se resumos de descrição de IA generativa de formato mais longo 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
Junto com um resumo da IA generativa, é necessário disponibilizar um diálogo aos usuários finais com informações sobre o resumo e um link para informar problemas. Ao usar um resumo da descrição da IA generativa, é preciso incluir informações sobre as fontes do resumo, chamadas de references.
Para ativar o acesso a essa caixa de diálogo, inclua um ícone de informações (como um tipo de interatividade) em conjunto com a atribuição de IA (conforme mostrado nos exemplos acima) e faça com que a área e o ícone de atribuição de IA respondam a um pressionamento/clique.
Para resumos de lugares generativos, mostre:
| Sobre | Os resumos de lugares por IA são gerados 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, acesse este link. |
| Referências | Avaliações de origem |
Exemplo:
Para resumos de áreas generativas, exiba:
| Sobre | Os resumos de áreas 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, acesse este link. |
