Os recursos de modelo do Gemini para a API Places (nova) são compatíveis com LLMs à API Places. Assim, você pode retornar os dados associados a um lugar (horário de funcionamento, avaliações, fotos) e os dados fornecidos pelos LLMs. Esses dados generativos contêm informações agregadas e resumidas dos LLMs para aprimorar os dados já associados a um lugar.
Por exemplo, uma Pesquisa de texto (novo) padrão para "estações 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 mais próximo com seu veículo.
Mas talvez você também queira entender melhor a área ao redor da estação de recarga, especialmente se for passar uma hora ou mais enquanto o veículo carrega. Ao usar os recursos do modelo Gemini para essa mesma pesquisa, a resposta pode conter descrições dinâmicas e generativas de cada local da resposta, incluindo informações sobre a área ao redor da estação de recarga:
"A cerca de 2 a 4 minutos a pé, há várias opções gastronômicas, incluindo Chef Chu's, Gen Korean Tour House, Amber India, Pacific Catch e vários supermercados 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 Khao Kang Thai Kitchen, Roger's Deli & Donuts e La Costeña. Para sushi, o Joy Sushi é uma boa opção. Para mantimentos, a Dollar Tree oferece uma variedade de produtos a preços com desconto.”
Esse conteúdo generativo dos LLMs aprimora a resposta e fornece mais informações para ajudar os usuários a tomar uma decisão informada.
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 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 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 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 o Text Search (novo) determina a resposta.
Resumos de lugares generativos
Os resumos de lugares generativos são específicos de um ID de lugar. Os resumos de lugares agregam muitos tipos diferentes de dados em um único resumo para o lugar.
A API Places (nova) oferece dois tipos de resumos de locais generativos:
Resumos de visão geral: breve visão geral de um lugar, com média de cerca de 100 caracteres, que ajuda os usuários a fazer uma captura de tela.
Resumos de descrições: resumos mais longos de um lugar, em média, com cerca de 400 caracteres, que fornecem uma visão geral detalhada dos principais aspectos dele.
No momento, os resumos de lugares estão disponíveis para os tipos de lugar exibidos nos Tipos aceitos das categorias Cultura, Entretenimento e recreação, Comida e bebida, Compras e Esportes.
Resumos da área generativa
Os resumos de áreas generativas são criados pelo LLM para a área próxima ao redor de um lugar. O resumo da área de um lugar pode conter todas as informações necessárias para que o usuário tome uma decisão, sem que seja necessário fazer outras solicitações para detalhar a área.
Além da descrição, a resposta também inclui uma lista de IDs de lugares 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 e para os 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 da área generativa são gerados off-line com frequência pelo Google. Ao gerar esses resumos off-line, você aproveita o conteúdo com a tecnologia do Gemini e continua tendo o mesmo desempenho da API Places (nova) que já espera.
O Google gera com frequência esses resumos para garantir que eles estejam atualizados com base nas informações mais recentes disponíveis. Isso significa que você exibirá os dados mais recentes no seu serviço quando chamar a API.
Resultados da pesquisa contextual
Uma Pesquisa de texto (Novo) retorna informações sobre um conjunto de locais com base em uma string, por exemplo, "pizza em São Paulo" ou "lojas de sapatos perto do Rio de Janeiro". A resposta do Text Search (novo) contém uma lista de locais que correspondem à string de texto e a todos os direcionamentos de local definidos na solicitação.
Quando você adiciona resultados da pesquisa contextuais à 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 devo escolher esse lugar?
Por exemplo, você faz uma solicitação para Place Details (New), Text Search (New) ou Nearby Search (New) que inclui um local específico na resposta. Os dados de resposta sobre o lugar são os mesmos para as três solicitações, porque os dados retornados são associados a ele.
No entanto, para uma Pesquisa de texto (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 contextual são exclusivos da string de consulta. Por exemplo, você faz uma solicitação Text Search (New) com a seguinte string de consulta:
"Restaurante vegetarian picante em Mountain View, CA"
Em seguida, você deixa todos os parâmetros de entrada iguais e altera apenas a string de consulta para:
"Restaurante vegan picante 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. No entanto, os resultados da pesquisa contextuais são exclusivos da consulta porque são derivados da string de consulta. Em seguida, você pode mostrar as avaliações, fotos e justificativas dos resultados da pesquisa contextual aos usuários para ajudá-los a decidir qual local na resposta é mais adequado à solicitação de pesquisa.
Ativar os recursos de modelo do Gemini para a API Places (novo)
Ative a API Places (nova) para usar os recursos do 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ó é compatível com resumos de locais e áreas nos Estados Unidos, apenas em inglês.
O que é o Gemini?
Para saber mais sobre o modelo do Gemini, consulte as Perguntas frequentes sobre o Gemini.
Solicite um resumo de lugar generativo
São resumos generativos criados pelo LLM para um local específico. A API Places (nova) adiciona dois tipos de resumos a uma resposta:
Resumos generativos da Visão geral semelhantes ao resumo editorial estático associado a um lugar. Os resumos breves generativos, em média, de cerca de 100 caracteres, têm várias vantagens:
Muitos lugares não têm resumos editoriais, então preenchem uma lacuna nas informações disponíveis para um lugar.
Eles são gerados usando o LLM, então o proprietário não precisa fazer a manutenção deles.
Os resumos generativos de descrição derivam de várias fontes, incluindo avaliações do Google Maps. A descrição, que tem em média 400 caracteres, inclui uma lista de avaliações usadas para gerar a descrição longa.
Para gerar resumos de descrição manualmente, é necessário que uma pessoa agregue dados de vários locais para criar e manter o conteúdo manualmente. Os recursos do modelo Gemini para a API Places (nova) criam esses resumos dos 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 campo a seguir 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 das informações gerais sobre a geração.generativeSummary.description: o resumo da descrição generativa.generativeSummary.references: uma matriz de até cinco avaliações usada para fornecer conteúdo para o resumo da descrição. Se não houver um resumo de descrição, essa matriz estará vazia.
Exemplo de solicitação de resumo da visão geral
Este exemplo de Text Search 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 resumo da descrição e visão geral
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
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 que tomam uma decisão sobre um lugar.
Por exemplo, você quer reservar um hotel em uma nova cidade e, embora possa encontrar um hotel que atenda às suas necessidades, também gostaria de saber mais sobre a área ao redor do hotel. Em vez de consultar um mapa da área ao redor e investigar cada lugar, você pode gerar 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 a máscara de campo da solicitação:
areaSummary(Place Details)places.areaSummary(Text Search e Nearby Search).
O campo areaSummary de um lugar 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 lugar 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 tópico incluem:"overview","activity","restaurant"e"store".
Exemplo de solicitação de resumo da área de um eletroposto
Este exemplo de solicitação do Place Details retorna o resumo da área de uma estação de carregamento 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 é 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, usados para fornecer conteúdo do 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 de pesquisa contextuais
A resposta a uma solicitação de Text Search (New) 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 da
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 da matriz correspondente 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:
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: destaca uma seção da avaliação que pode interessar a um usuário final.businessAvailabilityAttributesJustification: inclui atributos de uma empresa que podem ser do interesse de um usuário final.
Para incluir os resultados da pesquisa contextuais na resposta, inclua
contextualContents na
máscara de campo
da solicitação do 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 a 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 via.
- No máximo três linhas
- 120 caracteres ou 24 palavras ou menos
- Tamanho frontal mínimo de 24 dp
Especialmente em contextos automotivos, é responsabilidade do desenvolvedor renderizar resumos de IA generativa de maneira segura e compatível com todas as leis e regulamentações locais.
Atribuições
Ao exibir avaliações, fotos e resumos de IA generativa no seu app, incluindo resumos de locais e áreas, você também precisa conferir as atribuições necessárias.
Exibir atribuições para resumos generativos
Ao exibir resumos de IA generativa no app, incluindo resumos de locais e áreas, também é necessário exibir 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 app.
Em todos os casos, a atribuição precisa usar letras maiúsculas e minúsculas. A atribuição e o logotipo do Google precisam estar em conformidade com 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 mostrado 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 ao Google em outros lugares.
Para a atribuição, use o texto "Resumido por IA", como mostrado nesta imagem:
Resumo da IA generativa exibido isoladamente
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 uma pontuação. 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 de IA generativa em uma lista de lugares, todos:
- O conteúdo da lista é atribuído ao Google
- Os resumos mostrados são gerados por IA
- Conteúdo disponível pelo Google
A atribuição deve ser exibida 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 os resumos de descrição da IA generativa de forma mais longa forem usados em uma lista, cada resumo precisará ter atribuição de IA ("Resumido pela 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 uma caixa de diálogo para os usuários finais com informações sobre o resumo e um link para relatar problemas. Ao usar um resumo de descrição de IA generativa, é preciso incluir informações sobre as fontes do resumo, chamadas de references.
Ative o acesso a essa caixa de diálogo incluindo um ícone de informações (como uma affordance de interatividade) em conjunto com a atribuição de IA (conforme representado nos exemplos acima) e fazendo com que a área e o ícone de atribuição de IA respondam a um pressionamento ou clique.
Para resumos de lugares generativos, exiba:
| Sobre | Os resumos de lugares por IA são gerados com base nas avaliações e em outros dados do Google. |
| Informar um problema | Para informar o Google sobre um problema com o conteúdo de um resumo, siga este link. |
| Referências | Avaliações de origem |
Exemplo:
Para resumos de áreas generativas, exiba:
| Sobre | Os resumos da área de IA são gerados com base nas avaliações e nos dados locais do Google. |
| Informar um problema | Para informar o Google sobre um problema com o conteúdo de um resumo, siga este link. |
