Capacidades do modelo do Gemini para a API Places

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 informações adicionais para ajudar os usuários a tomar uma decisão consciente.

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

Os resumos generativos de lugar 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 de visão geral: informações breves sobre um lugar, com cerca de 100 caracteres em média, que podem ajudar os usuários a ter um resumo 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 a um lugar. O resumo da área de um lugar pode conter todas as informações necessárias para que um usuário tome uma decisão, sem precisar fazer outras solicitações para detalhar a área.

Além de uma descrição da área, a resposta também contém uma lista de IDs de lugares para os lugares referenciados 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.

Os resumos de área estão disponíveis para os tipos de lugar mostrados em Tipos compatíveis para a categoria Acomodação, bem como para os tipos de lugar 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 este lugar aparece nos resultados?
  • Por que devo 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 do lugar são os mesmos para as três solicitações, porque os dados retornados estão associados a esse lugar.

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 em ambas as 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 contextual 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 lugar.

    • Elas são geradas pelo LLM, então não é necessário que o proprietário do lugar as mantenha.

  • Os resumos generativos de descrição são derivados de muitas fontes, incluindo avaliações do Google Maps. A descrição, com uma média de 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 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 lugar 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:

  • Detalhes do lugar: generativeSummary

  • Pesquisa de texto e Pesquisa por locais próximos: 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 visão geral e resumo da 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 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"
        }
      }
    },
  . . .
}

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 de lugar específicos geocode e premise, os blocos de tópicos 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 topic especifica 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 content inclui o resumo do tópico, incluindo o código de idioma.

  • A matriz references especifica os nomes dos recursos de lugar, no formato places/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 de pesquisa de texto busca 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 (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 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:

  • 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 de um 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 lugar 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

Quando você exibe avaliações, fotos e resumos de IA generativa no seu app, incluindo resumos de lugares e áreas, é necessário 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 mostrado 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:

Para a atribuição, use o texto "Resumo feito por IA".

Resumo da IA generativa mostrado 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 "Resumo por IA" e o logotipo do Google, conforme mostrado nesta imagem:

Para o resumo mostrado isoladamente, inclua a atribuição de IA generativa e a atribuição do Google separadas por um ponto-e-vírgula.

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:

Para uma lista, mostre a atribuição acima ou abaixo dela em uma única linha.

Se resumos de descrição de IA generativa mais longos forem usados em uma lista, cada resumo precisará ter a atribuição de IA ("Resumo feito por IA" com o ícone/botão de informações).

Mostrar informações sobre um resumo de 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 recurso 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 Análises de origem

Exemplo:

Mostrar informações sobre um resumo de IA generativa em uma caixa de diálogo.

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.

Mostrar a atribuição do resumo da área.