Capacidades do modelo do Gemini para a API Places

Os recursos de modelo do Gemini para a API Places (nova) permitem que os LLMs a API Places para retornar os dados associados a um local. (horário de funcionamento, avaliações, fotos) com os dados fornecidos pelos LLMs. Isso os dados generativos contêm dados agregados e resumidos dos LLMs para aprimorar os dados já associados a um local.

Por exemplo, um padrão Text Search (novo) para "postos de recarga de VE" retorna uma lista de lugares que oferecem carregamento de VE. Isso tipo de resposta, tudo bem se você estiver apenas procurando pelo carregador de VE mais próximo ou o mais próximo compatível com o seu veículo.

Mas talvez você também queira 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 isso, mesma pesquisa, a resposta pode conter descrições dinâmicas e generativas de cada local na resposta, incluindo informações sobre a área ao redor do ponto estação:

  • "A cerca de 2 a 4 minutos a pé há vários restaurantes e lojas opções, incluindo Chef Chu's, Gen Korean BBQ House, Amber India, Pacífico Catch e vários mercados, como Walmart, Whole Foods Market e Trader Joe's."

  • "A cerca de 1 a 5 minutos a pé há vários restaurantes e lojas como o Khao Kang Thai Kitchen, o Roger's Deli e Donuts e La Costeña. Para sushi, o Joy Sushi é uma boa opção. Para compras de mercado, o Dollar Tree oferece uma variedade de produtos a 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 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

Os resumos de lugares generativos são específicos para um ID de lugar. Resumos de lugares agregar muitos tipos diferentes de dados em um único resumo para o local.

A API Places (nova) oferece dois tipos de resumos generativos de lugares:

  • Resumos da visão geral: informações gerais breve de um lugar, em média por volta de 100 caracteres, que podem ajudar os usuários a ter uma visão geral de um lugar.

  • Resumos das descrições: resumos mais longos sobre um lugar, em média cerca de 400 caracteres, que fornecem uma visão geral detalhada, abrangendo as principais aspectos do lugar.

No momento, os resumos de lugares estão disponíveis para os tipos de lugar mostrados na seção Compatível de classificação para as categorias Cultura, Entretenimento e recreação, Alimentos e bebidas, Compras, e Esportes.

Resumos de áreas generativas

Os resumos de área generativa são criados pelo LLM para a área próxima ao redor de um lugar O resumo de área de um lugar pode conter todas as informações necessárias para que o usuário tome 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 local para os locais mencionados na descrição e uma lista de locais 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, bem como os tipos específicos de lugares electric_vehicle_charging_station, geocode e premise.

Geração de resumos de lugares e áreas

Tanto os resumos de lugares generativos quanto os resumos de áreas generativas geradas 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 acesso ao o mesmo desempenho da API Places (nova) que você já esperava.

O Google gera novamente esses resumos com frequência para garantir que eles estejam sempre atualizados. com base nas informações mais recentes disponíveis. Isso significa que você vai exibir os dados mais recentes no serviço quando você chamar a API.

Resultados da pesquisa contextual

Um Text Search (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". Text Search (New) contém uma lista de locais que correspondem à string de texto e a quaisquer viés de local definido na solicitação.

Quando você adiciona resultados de pesquisa contextuais à resposta, ela incluem avaliações, fotos e justificativas que ajudam os usuários a responder 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 local específico na resposta. O dados de resposta para o local são os mesmos para todas as três solicitações porque o dados retornados são associados a esse lugar.

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 contextual são exclusivos da 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 só altera a string de consulta para:

"Restaurante vegana picante em Mountain View, CA"

Para um restaurante que aparece em ambas as respostas, os dados de resposta sobre a lugar é o mesmo porque os dados estão associados ao próprio local. Mas o os resultados da pesquisa contextual são exclusivos da consulta, pois são derivados de a string de consulta. Você pode exibir as avaliações, fotos e justificáveis dos resultados da pesquisa contextual para os usuários, a fim de ajudá-los 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 do modelo Gemini para a API Places (nova). Para mais informações, consulte Configure seu projeto do Google Cloud.

Restrições da versão experimental

Esta versão só é compatível com resumos de lugares e áreas para lugares nos Estados Unidos Estados Unidos, somente em inglês.

O que é o Gemini?

Para saber mais sobre o modelo do Gemini, consulte a documentação do Gemini Perguntas frequentes.

Solicitar um resumo generativo de lugares

Os resumos de lugares são resumos generativos criados pelo LLM para um tipo específico lugar A API Places (nova) adiciona dois tipos de resumos a uma resposta:

  • Visão geral: resumos generativos semelhantes aos resumos editoriais estáticos resumo associado a um lugar. Resumos breves generativos, em média cerca de 100 caracteres, têm diversas vantagens:

    • Muitos lugares não têm resumos editoriais, então eles preenchem uma lacuna na informações disponíveis para um lugar.

    • Como são gerados pelo LLM, o proprietário do lugar não precisa fazer isso para mantê-los.

  • Descrição: os resumos generativos são derivados de várias fontes, incluindo avaliações do Google Maps. A descrição, em média cerca de 400 caracteres, inclui uma lista de resenhas usadas para gerar o texto descrição.

    Para gerar resumos de descrições manualmente é necessário agregar dados de muitos locais e, em seguida, 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 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 no máscara de campo da solicitação:

  • Place Details: generativeSummary

  • Text Search e Nearby Search: places.generativeSummary

O 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 descrição resumo, essa matriz estará vazia.

Exemplo de solicitação de resumo da visão geral

Este exemplo de Pesquisa de texto retorna somente o resumo overview de "picante" restaurantes vegetarianos 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 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 o generativeSummary.overview, Campos 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 áreas são resumos generativos criados pelo LLM para a área próxima de um lugar. Os resumos de áreas podem ser importantes para os usuários que tomam uma decisão sobre um lugar

Por exemplo, você quer reservar um hotel em uma cidade nova e, embora possa encontrar um hotel que atenda às suas necessidades, você também gostaria de saber mais sobre a área ao redor do hotel. Em vez de analisar um mapa e, em seguida, ter que investigar cada lugar no mapa, você pode em vez gerar um resumo da área do hotel.

Resumos de área são suportados por Place Details (novo), Text Search (novo), e Nearby Search (novo).

Para incluir o resumo da área na resposta, inclua no campo máscara de campo da solicitação:

  • areaSummary (Place Details)
  • places.areaSummary (Pesquisa de texto e Nearby Search).

O 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 lugar do tipo electric_vehicle_charging_station, os blocos de temas incluem: "overview", "coffee", "restaurant" e "store".

  • Para um local com um tipo definido pelo Hospedagem e os tipos de lugar específicos geocode e premise, o tema os blocos 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 um VE específico estação de recarga 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 o contentBlocks matriz:

  • O campo topic especifica 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 content inclui o resumo desse tópico, incluindo o com o código do idioma.

  • A matriz references especifica os nomes dos recursos de lugar no formato places/PLACE_ID, usado para fornecer conteúdo para 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 o contentBlocks matriz. A resposta para locais do tipo hotel contém blocos de conteúdo para o 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 um Text Search (novo) request contém uma matriz de lugares que correspondem aos critérios da entrada de pesquisa fio. Agora você pode solicitar dados de pesquisa contextuais na resposta com base no 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 o places na resposta:

{
  "places": [],
  "contextualContents":[]
}

Cada elemento na matriz contextualContents, do tipo ContextualContent, está no local da matriz correspondente que está na matriz places. Isso é que o elemento em contextualContents[0] corresponde ao local 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 de fotos.
  • contextualContents.justifications: uma matriz de justificativas para o lugar, incluindo:

    • reviewJustification: destacar um seção de uma 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 para um fim usuário.

Para incluir os resultados da pesquisa contextual na resposta, inclua contextualContents no 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 da 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 em o modo estacionado para experiências automotivas. Ao renderizar resumos no modo carro, as informações na tela devem ser simples, claras e concisas para garantir que a atenção do motorista volta 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 renderize resumos de IA generativa de maneiras seguras e em conformidade com todos leis e regulamentações locais.

Atribuições

Ao mostrar avaliações, fotos e resumos de IA generativa no app, incluindo resumos de lugares e áreas, você deve também exibir as atribuições necessárias.

Mostrar atribuições para resumos generativos

Quando você mostra resumos de IA generativa no seu app, incluindo lugar e área resumos, você também precisa exibir as atribuições necessárias. Esta seção descreve como mostrar atribuições com base em como você mostra a IA generativa resumos no seu app.

Em todos os casos, a atribuição precisa usar maiúsculas/minúsculas. A atribuição e O logotipo do Google precisa seguir 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 feita pelo Google em outros lugares.

Para a atribuição, use o texto "Resumido por IA" como mostrado nesta imagem:

Para a atribuição, use o texto resumido por IA.

Resumo da IA generativa exibido isoladamente

Quando um resumo da IA generativa aparece isoladamente de qualquer outro conteúdo de Google Maps, ela deve incluir atribuição de IA generativa e para Google separados por um ponto final. Para a atribuição, use o texto "Resumido por IA" e o logotipo do Google, como mostrado nesta imagem:

Para o resumo exibido isoladamente, inclua a atribuição da IA generativa e
  Atribuição do Google separada por um ponto final.

Resumo da IA generativa repetido em uma lista

Ao repetir uma IA generativa visão geral do resumo de lugares 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:

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

Se os resumos de IA generativa forem mais longos, são usados em uma lista, cada resumo precisa ter atribuição ("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, é preciso disponibilizar um diálogo para finalizar usuários que exibe informações sobre o resumo e um link para informar problemas. Ao usar uma IA generativa description summary, será necessário incluir informações sobre as fontes do resumo, chamadas de referências.

Permitir o acesso a esta caixa de diálogo incluindo um ícone de informação (como um item de interatividade affordance) em conjunto com a atribuição de IA (conforme mostrado acima exemplos) e fazer com que a área e o ícone de atribuição de IA respondam a um pressionar/clicar.

Para resumos de lugares generativos, mostre:

Sobre Os resumos de lugares por IA são gerados com base em avaliações do Google e outras dados.
Informar um problema Para informar um problema ao Google sobre o conteúdo de um resumo, faça o seguinte: clique neste link.
Referências Avaliações de origem

Exemplo:

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

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, faça o seguinte: clique neste link.

Atribuição do resumo da área de exibição.