Embasamento com o Google Maps na Gemini Enterprise Agent Platform

Esta página descreve como o embasamento com o Google Maps na Gemini Enterprise Agent Platform pode ajudar a melhorar seus aplicativos de IA generativa fornecendo contexto geoespacial.

Visão geral

O embasamento com o Google Maps na Gemini Enterprise Agent Platform é um serviço que conecta os modelos do Gemini a dados geoespaciais do Google Maps. O Google Maps tem acesso a informações sobre milhões de locais, incluindo empresas, pontos de referência e pontos de interesse. Esses dados dão acesso a informações sobre mais de 250 milhões de lugares que podem ser usados para embasar as respostas do modelo, permitindo que seus aplicativos e agentes de IA forneçam dados locais e contexto geoespacial.

Também é possível ativar o embasamento simultâneo com o Google Maps, a Pesquisa Google e o embasamento com suas fontes de dados.

Usos do embasamento com o Google Maps

É possível usar o embasamento com o Google Maps em vários aplicativos, como:

  • Assistentes de conversação que podem responder a perguntas sobre lugares por perto, como "Onde fica o lugar mais próximo para tomar um café expresso italiano?"
  • Descrições personalizadas e insights da comunidade, como "Quais são os restaurantes para toda a família que ficam perto daqui?"
  • Resumos de áreas ao redor de locais específicos, como um eletroposto ou um hotel.

Isso pode ser útil para casos de uso em apps de imóveis, viagens, mobilidade e mídias sociais.

Modelos compatíveis

Nesta seção, listamos os modelos que dão suporte ao embasamento com o Google Maps.

Clique para abrir os modelos compatíveis

Para mais informações sobre os modelos do Gemini, consulte Modelos do Gemini.

Usar o embasamento com o Google Maps para embasar as respostas do modelo

Este exemplo de código demonstra como usar o embasamento com o Google Maps para embasar as respostas do seu modelo.

Os resultados da pesquisa podem ser personalizados para uma localização geográfica específica usando as coordenadas de latitude e longitude.

Console

Para usar o embasamento com o Google Maps na Gemini Enterprise Agent Platform, siga estas etapas:

  1. No console do Google Cloud , acesse a página Agent Studio.

    Acessar o Agent Studio

  2. No painel lateral, em Configurações do modelo, acesse a seção Embasamento e clique no ícone de edição para Pesquisa Google, Google Maps. Um painel de configuração é exibido.

  3. Ative o Google Maps.

  4. Clique em Aplicar.

  5. Insira seu comando no campo e clique em Enviar. Suas respostas aos comandos serão embasadas com o Google Maps.

Python

Instalar

pip install --upgrade google-genai

Para saber mais, consulte a documentação de referência do SDK.

Defina variáveis de ambiente para usar o SDK de IA generativa do Google com a Vertex AI: 

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True
 

from google import genai
from google.genai.types import (
    GenerateContentConfig,
    GoogleMaps,
    HttpOptions,
    Tool,
)

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Where can I get the best espresso near me?",
    config=GenerateContentConfig(
        tools=[
            # Use Google Maps Tool
            Tool(google_maps=GoogleMaps())
        ],
        tool_config=types.ToolConfig(
            retrieval_config = types.RetrievalConfig(
                lat_lng = types.LatLng( # Pass geo coordinates for location-aware grounding
                    latitude=40.7128,
                    longitude=-74.006
                ),
                language_code = "en_US", # Optional: localize Maps results
            ),
        ),
    ),
)

print(response.text)
# Example response:
# 'Here are some of the top-rated places to get espresso near you: ...'

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • LOCATION: a região para processar a solicitação. Para usar o endpoint global, exclua o local do nome do endpoint e configure o local do recurso como global.
  • PROJECT_ID: o ID do projeto. .
  • MODEL_ID: o ID do modelo multimodal.
  • PROMPT: o comando a ser enviado para o modelo.
  • LATITUDE: a latitude do local. Por exemplo, uma latitude de 37.7749 representa São Francisco. Você pode obter coordenadas de latitude e longitude usando serviços como o Google Maps ou outras ferramentas de geocodificação.
  • LONGITUDE: a longitude do local. Por exemplo, uma longitude de -122.4194 representa São Francisco.
  • GROUNDING_TYPES: os tipos de embasamento do Google Maps que serão ativados. Atualmente, aceita places e routing.
    • places: pesquise informações de lugares, incluindo estabelecimentos, pontos de interesse de destaque e localizações geográficas.
    • routing: encontrar rotas e pesquisar ao longo do trajeto.
    Se não for especificado, o padrão será apenas places.

Método HTTP e URL: 

POST https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Corpo JSON da solicitação:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "PROMPT"
    }]
  }],
  "tools": [{
    "googleMaps": {
      "groundingTypes": {
        "places": {},
        "routing": {}
      }
    }
  }],
  "toolConfig": {
    "retrievalConfig": {
      "latLng": {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      },
      "languageCode": "en_US"
    }
  },
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout. It has a rating of 4.2 stars based on 411 reviews."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "groundingChunks": [
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "The Italian Place",
              "placeId": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w"
            }
          },
          {
            "maps": {
              "uri": "https://maps.google.com/?cid=9001322937822692826",
              "title": "Hank's Pasta Bar",
              "placeId": "places/MMVtPzn9FGcevML89",
              "placeAnswerSources": {
                "reviewSnippets": [
                  {
                    "id": "places/ChIJOTRDf_qwt4kR2kV_WYUf63w",
                    "title": "Google Maps Review",
                    "uri": "https://maps.google.com/?cid=9001322937822692826"
                  },
                ]
              }
            }
          },
          ...
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 79,
              "text": "\"The Italian Place\" in Alexandria, VA, is good for children and offers takeout."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ],
      }
    }
  ],
  ...
}

Propriedades do lugar

Nesta seção, listamos as propriedades de lugar usadas para descrever locais e usadas pelo embasamento com o Google Maps para gerar respostas. Essas propriedades são usadas para determinar os tipos de perguntas que o embasamento com o Google Maps pode responder.

Exemplos de propriedades de lugar

Esta lista mostra uma amostra em ordem alfabética de propriedades sobre lugares que podem ser usadas pelo modelo para gerar respostas:

  • Endereço
  • Tendências de movimentação
  • Retirada
  • Cartão de débito
  • Distância
  • Informações sobre eletropostos (tipos de conector, velocidades de carregamento e disponibilidade)
  • Estacionamento gratuito
  • Preços de combustível e tipos de combustível disponíveis
  • Bom para ir com crianças
  • Música ao vivo
  • Destaques do cardápio
  • Horário de funcionamento
  • Opções de pagamento (como dinheiro ou cartão de crédito)
  • Aceita animais de estimação
  • Analisar insights
  • Serve cerveja
  • Serve comida vegetariana
  • Acessibilidade para cadeirantes
  • Wi-Fi

Exemplos de uso de propriedades de lugar

Os exemplos a seguir usam propriedades de lugar em perguntas sobre diferentes tipos de lugares. O embasamento com o Google Maps usa as propriedades para entender sua intenção e, em seguida, fornece respostas relevantes com base nos dados associados aos lugares no Google Maps.

  • Planejar um jantar em família: você pode perguntar: O restaurante "The Italian Place" é bom para crianças e oferece serviço de entrega? Qual é a classificação dele?

    As respostas a essas perguntas ajudam a determinar se um restaurante é adequado para uma família e se oferece um serviço conveniente.

  • Conhecer os destaques do cardápio e os pratos principais: você pode perguntar, por exemplo, Quais são os pratos de massa mais recomendados no cardápio do "The Italian Place"? Eles têm entradas vegetarianas? O que os avaliadores dizem sobre o molho marinara?

    As respostas a essas perguntas usam os Destaques do cardápio e os Insights de avaliações para ajudar você a conhecer ofertas culinárias específicas e os favoritos da comunidade.

  • Verificar a acessibilidade para um amigo: você pode perguntar, por exemplo, Preciso de um restaurante que tenha uma entrada acessível para pessoas em cadeira de rodas.

    A resposta a esse comando pode ajudar você a determinar se o local atende a necessidades específicas de acessibilidade.

  • Encontrar um lugar para comer um lanche tarde da noite: pergunte, por exemplo, A lanchonete "Burger Joint" está aberta agora? O local serve jantar? Qual é o horário de funcionamento na sexta-feira?

    As respostas a essas perguntas ajudam você a encontrar um estabelecimento aberto que sirva uma refeição específica em um determinado horário.

  • Planejar o carregamento de VE e as comodidades do hotel para uma viagem de carro: você pode perguntar, Vou me hospedar no "Overnight Motel". Eles têm eletropostos no local, quais tipos de conector são compatíveis e qual é o movimento do estacionamento nas noites de sexta-feira?

    As respostas a essas perguntas combinam informações sobre eletropostos e tendências de movimento para ajudar você a planejar o carregamento do veículo e avaliar os níveis de lotação durante sua estadia.

  • Compare preços de gasolina e combustíveis especiais nas proximidades: você pode perguntar, por exemplo, Quais postos de gasolina perto de Mountain View, CA, vendem diesel ou hidrogênio e como os preços atuais se comparam?

    As respostas a essas perguntas usam os preços da gasolina e os tipos de combustível disponíveis para ajudar você a localizar combustíveis especiais e paradas de reabastecimento econômicas.

  • Sintetizar o ambiente de trabalho com base nas avaliações: você pode perguntar: O que os resumos das avaliações dos clientes dizem sobre o nível de ruído, o conforto dos assentos e a confiabilidade do Wi-Fi no "Breakfast Cafe" para trabalho remoto?

    Uma resposta a esse comando usa os insights de avaliações para avaliar se um café é adequado para trabalhar ou estudar com base no consenso da comunidade.

As informações nos Resultados Embasados do Google Maps podem ser diferentes das condições reais da via ou do local.

Entender a resposta

As fontes do Google Maps são retornadas em groundingMetadata dentro de groundingChunks. As fontes são retornadas para lugares, que são usados para ajudar a gerar o Resultado Embasado do Google Maps. O campo uri pode direcionar para uma avaliação de apoio ou diretamente para a ficha do lugar no Google Maps.

Este exemplo de código demonstra uma fonte de lugar na resposta:

"groundingChunks": [
  {
    "maps": {
      "uri": "{Link to place sheet or review on Maps}",
      "title": "{Name of Maps Place}",
      "placeId": "{Place ID}"
    }
  }
],

Roteamento: encontrar rotas

O embasamento com o Google Maps é compatível com o recurso de encontrar rotas. Esse recurso permite que seus agentes de IA entendam o movimento físico, as estimativas de viagem em tempo real e as relações espaciais entre os locais. Com o recurso de encontrar rotas, seu modelo pode fornecer rotas otimizadas para desempenho e tempos de viagem precisos que consideram as condições em tempo real. Essa integração permite que o embasamento com o Google Maps filtre lugares com base no tempo de viagem, ofereça rotas precisas de um ponto a outro e calcule os tempos estimados de deslocamento para modos de transporte específicos.

Recursos

O recurso Encontrar Rotas calcula distâncias e durações de viagem precisas entre origens e destinos.

O recurso Encontrar rotas é compatível com o seguinte:

  • Meios de transporte: rotas para dirigir, caminhar, andar de bicicleta, transporte público e veículos motorizados de duas rodas (nem todos os meios de transporte estão disponíveis em todos os países)

  • Vários waypoints: até 13 paradas intermediárias entre a origem e o destino.

  • Trânsito em tempo real: considera as condições de trânsito atuais para fornecer tempos de viagem "ao vivo" precisos, em vez de médias estáticas.

Veja a seguir exemplos dos tipos de perguntas que o recurso Encontrar Trajeto aceita:

  • Proximidade com base no tempo de viagem: "Quais são alguns restaurantes americanos a 10 minutos a pé do Hilton Hotel, na 1335 6th Ave, em Nova York?"

  • Estimativa de deslocamento diário: "Quanto tempo leva para ir de transporte público do Mercado Municipal de São Paulo até a Avenida Paulista?"

Ativar o recurso Encontrar Rotas

Na API REST e nos SDKs, o embasamento com o Google Maps usa como padrão os dados do Places somente quando grounding_types é omitido. Para ativar os recursos de rotas, é necessário configurar explicitamente routing em grounding_types na configuração da solicitação. Se você quiser usar as ferramentas de Places e Routing, especifique places e routing em grounding_types.

Entender a resposta

Quando um comando aciona o recurso de encontrar rotas, o modelo gera uma resposta em linguagem natural com base em metadados estruturados. Isso permite mostrar informações de viagem precisas ao usuário.

Os seguintes dados são retornados em uma resposta de payload:

  • Duração: o tempo necessário para viajar entre os locais, considerando o trânsito, se solicitado. Por exemplo, "500 segundos".

  • Distância: a distância física do trajeto. Por exemplo, "1,9 km".

  • Polilinha: uma string de texto codificada que permite renderizar visualmente o caminho específico do trajeto em um mapa.

Veja um exemplo de resposta para o comando: "Como faço para chegar ao restaurante Carmine's do hotel Hilton (1335 6th Ave em NYC) onde estou hospedado?"

Para chegar ao restaurante Carmine's saindo do Hilton Hotel, localizado na 1335 6th Ave, em Nova York, vá até a unidade Carmine's - Time Square, na 200 W 44th St, Nova York, NY 10036, EUA.

Aqui estão as rotas a pé:

  1. Comece no Hilton Hotel: saia do Hilton Hotel na 1335 6th Ave.

  2. Caminhe para o sul na 6th Avenue: siga para o sul na 6th Avenue (Avenue of the Americas) em direção à W 44th Street.

  3. Vire à direita na W 44th Street: vire à direita na W 44th Street.

  4. O Carmine's está à sua esquerda: caminhe pela W 44th Street. O Carmine's estará à sua esquerda, no número 200.

A caminhada tem cerca de 800 metros e leva de 10 a 15 minutos.

Veja a seguir um exemplo de resposta para o comando: "Quanto tempo leva para ir de transporte público do Pikes Place Market até Capitol Hill em Seattle?"

Para ir do Pike Place Market até Capitol Hill em Seattle usando o transporte público, você tem algumas opções:

  • Bonde (VLT): o bonde de Westlake, que fica perto do Pike Place Market, até Capitol Hill leva aproximadamente 3 minutos. Incluindo as baldeações, o tempo total de viagem é de cerca de 9 minutos, com bondes partindo a cada 10 minutos.

  • Ônibus: um ônibus direto do King County Metro da Pike St com a 4th Ave (perto do Pike Place Market) para Capitol Hill leva cerca de 11 minutos, com saídas a cada 20 minutos. Como alternativa, o ônibus da linha 49 leva cerca de 16 minutos.

Rotas: pesquisar no trajeto

A Pesquisa ao Longo do Trajeto permite que seus agentes de IA descubram pontos de interesse que são geograficamente relevantes e convenientes para o trajeto planejado de um usuário. Ao embasar as respostas nos mecanismos de roteamento e pesquisa espacial do Google Maps, seu modelo pode fornecer recomendações que minimizam desvios e entendem o fluxo logístico de uma viagem de carro ou de um trajeto diário.

Recursos

Com a Pesquisa ao Longo do Trajeto, seu aplicativo pode identificar empresas, comodidades ou atrações específicas situadas diretamente ao longo de um caminho gerado entre uma origem e um destino. Somente o modo de viagem "Carro" é aceito.

Os exemplos a seguir ilustram os tipos de perguntas que a ferramenta Pesquisar ao Longo do Trajeto pode processar.

  • Pesquisa básica de rota: "Encontre postos de gasolina no caminho de 1800 Amphibious Blvd. Mountain View, CA 94045, para 456 Sunny St, Sunnyvale CA." (Normalmente, os endereços de origem e destino são derivados do histórico de chat.)
  • Pesquisa com base nas propriedades do lugar: "Há alguma padaria com pelo menos uma classificação de 4 estrelas entre São Francisco e 1800 Amphibious Blvd. Mountain View, CA 94045?"
  • Pesquisa de trajeto com vários trechos: "Vou fazer uma viagem de carro de São Francisco para San Luis Obispo e depois para Los Angeles. Sugira três opções de carregador de VE entre São Francisco e San Luis Obispo e, em seguida, entre San Luis Obispo e Los Angeles."

Ativar a pesquisa ao longo do trajeto

A pesquisa ao longo do trajeto requer os recursos de lugares e trajeto para descobrir lugares situados ao longo de um trajeto de viagem. Na API REST e nos SDKs, é necessário configurar explicitamente places e routing em grounding_types na configuração da solicitação.

Entender a resposta

Quando um comando aciona a ferramenta Pesquisar ao Longo do Trajeto, o modelo gera uma resposta em linguagem natural com base em metadados estruturados que combinam dados de lugares e de rotas. Isso garante que os locais sugeridos sejam realmente convenientes para o trajeto físico da viagem. O groundingMetadata vai conter groundingChunks para os lugares retornados e o trajeto pesquisado.

Exemplo de comando [Pesquisa básica de trajeto]:

Encontre postos de gasolina no caminho de 1800 Amphibious Blvd. Mountain View, CA 94045, até 456 Sunny St, Sunnyvale CA.

Exemplo de resposta [Pesquisa de trajeto básica]:

Aqui estão alguns postos de combustível no trajeto de 1800 Amphibious Blvd. Mountain View, CA 94045 até 456 Sunny St, Sunnyvale, CA:

  • Posto de gasolina de exemplo: localizado na Rua Exemplo, 123, Sunnyvale, CA 94045. Ele tem uma classificação de 3, 5 estrelas de 122 avaliações e vende hidrogênio, propano e gasolina, além de oferecer lavagem de carros. Fica aberto até as 21h50 hoje e tem banheiros.
  • Posto de gasolina fictício: localizado na Avenida Fictícia, 456, Sunnyvale, CA 94045. Ele tem uma classificação de 3,6 estrelas de 52 avaliações e oferece uma loja de conveniência e lava-rápido. Esse posto fica aberto 24 horas e tem banheiros.
  • Posto de gasolina genérico: localizado na Rua Genérica, 789, Sunnyvale, CA 94045. Tem uma classificação de 3,6 estrelas de 35 avaliações. Essa estação fica aberta 24 horas e tem banheiros.

Exemplo de comando [Pesquisa de trajeto com vários trechos]:

Vou fazer uma viagem de carro de São Francisco para San Luis Obispo e depois para Los Angeles. Sugira três opções de carregadores de VE entre São Francisco e San Luis Obispo e, em seguida, entre San Luis Obispo e Los Angeles.

Exemplo de resposta [pesquisa de trajeto com vários trechos]:

Aqui estão algumas opções de carregadores de VE para sua viagem de carro de São Francisco a Los Angeles, com paradas em San Luis Obispo.

Entre São Francisco e San Luis Obispo:

  • Carregador de exemplo: localizado na Av.Exemplo, 123, Campbell, CA 95008, essa estação tem uma classificação de 4,5.
  • Estação de VE fictícia: você pode encontrar essa estação em 456 Fictional Rd, Gilroy, CA 95008, com uma classificação de 4,4.
  • Generic Charging Station: essa estação fica na 789 Generic St, Salinas, CA 95008, e tem uma classificação de 3,5.

Entre San Luis Obispo e Los Angeles:

  • Carregador de exemplo: localizado em 123 Example Rd, San Luis Obispo, CA 93123, essa estação tem uma classificação de 4,3.
  • Fictional EV Station: essa estação fica na 456 Fictional Ave, Santa Barbara, CA 93123, com uma classificação de 3,9.
  • Generic Charging Station: você pode encontrar essa estação na Rua Genérica, 789, Glendale, CA 93123, com uma classificação de 3,0.

Tenha uma ótima viagem!

Requisitos de uso do serviço

Nesta seção, descrevemos os requisitos de uso do serviço para o embasamento com o Google Maps.

Informar o usuário sobre o uso de fontes do Google Maps

Com cada Resultado Embasado do Google Maps, você recebe fontes no groundingChunks que dão suporte a cada resposta. Os seguintes metadados também são retornados:

  • URI de origem
  • título
  • ID

Ao apresentar resultados do Embasamento com o Google Maps usando a Gemini Enterprise Agent Platform, você precisa especificar as fontes associadas do Google Maps e informar aos usuários o seguinte:

  • As fontes do Google Maps precisam seguir imediatamente o conteúdo gerado que elas apoiam. Esse conteúdo gerado também é chamado de Resultado Embasado do Google Maps.
  • As fontes do Google Maps precisam ser visíveis em uma interação do usuário.

Para interfaces com foco na voz

Fontes: as fontes do Google Maps precisam ser exibidas em uma UI complementar que mostre um registro histórico literal de qualquer conversa por voz com a IA. Esse registro precisa aderir aos requisitos de fornecimento e está sujeito aos limites aplicáveis de armazenamento e armazenamento em cache de dados.

Divulgação ativa de fontes: os usuários finais precisam estar cientes do papel do Google Maps na experiência deles e de como encontrar fontes detalhadas no momento da interação.

A declaração ativa de fontes precisa transmitir os seguintes pontos:

  • O conteúdo gerado com IA pode incluir informações do Google Maps.

  • As fontes detalhadas estão disponíveis na UI complementar.

É preciso transmitir a declaração ativa de fontes usando pelo menos um dos métodos a seguir.

  • Exibição visual: para interações por voz que ocorrem em um dispositivo com tela, mostre a declaração ativa na tela sempre que o embasamento com o Google Maps for usado.

  • Aviso por voz: leia a declaração ativa para o usuário. Isso precisa ocorrer durante a primeira interação compatível com o embasamento com o Google Maps e se repetir pelo menos a cada 6 meses.

Exemplo de declaração: "O conteúdo gerado com IA pode incluir informações do Google Maps. Você pode encontrar fontes detalhadas no app complementar."

Declaração persistente: uma explicação de que o conteúdo do Google Maps pode ser usado em conteúdo gerado com IA precisa estar sempre acessível ao usuário final (por exemplo, em um menu de configurações de voz ou em uma declaração de interação por voz).

Consultas do usuário: seu assistente por voz precisa responder com precisão às consultas do usuário final sobre a origem do conteúdo, inclusive quando o conteúdo gerado com IA inclui informações do Google Maps. Se o Google Maps for a fonte, direcione os usuários finais para a UI complementar para acessar informações específicas da fonte.

Para cada origem em groundingChunks, uma prévia do link precisa ser gerada seguindo estes requisitos:

Estas imagens mostram os requisitos mínimos para exibir as fontes e os links do Google Maps.

Comando com resposta mostrando as fontes

Você pode recolher a visualização das fontes.

Comando com resposta e fontes recolhidas

Opcional: melhore a prévia do link com conteúdo adicional, como:

  • Um favicon do Google Maps é inserido antes da atribuição de texto do Google Maps.
  • Uma foto do URL de origem (og:image).

Para mais informações sobre alguns dos nossos provedores de dados do Google Maps e os termos de licença deles, consulte os avisos legais do Google Maps e do Google Earth.

Diretrizes de atribuição de texto do Google Maps

Ao atribuir fontes ao Google Maps em texto, siga estas diretrizes:

  • Não modifique o texto Google Maps de forma alguma:
    • Não mude as letras maiúsculas de Google Maps.
    • Não quebre o nome Google Maps em várias linhas.
    • Não traduza Google Maps para outro idioma.
    • Impeça que os navegadores traduzam o Google Maps usando o atributo HTML translate="no".
  • Estilize o texto do Google Maps conforme descrito na tabela a seguir:
Propriedade Estilo
Família de fontes Roboto. O carregamento da fonte é opcional.
Família de fontes substituta Qualquer fonte Sans Serif já usada no seu produto ou "Sans-Serif" para invocar a fonte padrão do sistema
Estilo da fonte Normal
Espessura da fonte 400
Cor da fonte Branco, preto (#1F1F1F) ou cinza (#5E5E5E). Mantenha um contraste acessível (4.5:1) em relação ao plano de fundo.
Tamanho da fonte Tamanho mínimo da fonte: 12 sp
Tamanho máximo da fonte: 16 sp
Para aprender mais sobre sp, consulte as unidades de tamanho de fonte no site do Material Design.
Espaçamento entre letras Normal

CSS de exemplo

O CSS a seguir renderiza Google Maps com o estilo tipográfico e a cor apropriados em um plano de fundo branco ou claro.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

ID de lugar e ID de avaliação

Os dados do Google Maps incluem o ID de lugar e o ID da avaliação. Você pode armazenar em cache, armazenar e exportar os seguintes dados de resposta:

  • placeId
  • reviewId

As restrições contra o armazenamento em cache nos Termos de Embasamento com o Google Maps não se aplicam.

Território Proibido

O embasamento com o Google Maps tem restrições para determinados conteúdos e atividades para manter uma plataforma segura e confiável. O Cliente não distribuirá nem comercializará um Aplicativo do Cliente que ofereça o Embasamento com o Google Maps em um Território Vetado. Para mais informações, consulte Territórios proibidos da Plataforma Google Maps. A lista de Territórios Proibidos pode ser atualizada periodicamente.

Faturamento

O embasamento com o Google Maps cobra por cada consulta do Google Maps (consulte Preços).

Uma solicitação enviada pelo cliente ao Gemini pode resultar em uma ou mais consultas ao Google Maps. A tabela a seguir mostra alguns exemplos:

Exemplo de comando Número potencial de consultas do Google Maps Exemplo de geração de consultas
Restaurantes de sushi perto do Hilton Hotel (1335 6th Ave em NYC). 3 consultas de pesquisa do Place Search (consultas do Google Maps), supondo que esse comando gere 3 consultas de fan-out. 3 consultas de pesquisa de fan-out do Place Search:
- Melhor sushi perto do Hilton Midtown Manhattan
- Restaurantes de sushi perto de 1335 6th Ave New York
- Restaurantes japoneses perto de 1335 6th Ave New York
Como faço para ir do Hilton Hotel, 1335 6th Ave, até 200 W 44th St, Nova York? 1 consulta de rotas (consulta do Google Maps) 1 consulta de rotas:
- Rotas do Hilton Hotel, 1335 6th Ave, Nova York, NY para 200 W 44th St, Nova York, NY 10036
Distância do Hilton Hotel (1335 6th Ave em Nova York) até o aeroporto. 4 consultas de pesquisa do Google Maps (1 consulta de pesquisa do Place Search + 3 consultas de pesquisa do Find Directions), supondo que a pesquisa de lugares retorne 3 aeroportos. 1 consulta de pesquisa do Place Search com divergência:
- Aeroportos perto da cidade de Nova York

3 consultas do Find Directions:
- Trajeto de 1335 6th Ave, Nova York, NY 10019, EUA até o Aeroporto Internacional John F. Kennedy, Queens, NY 11430, EUA- Trajeto de 1335 6th Ave, Nova York, NY 10019, EUA até o Aeroporto de LaGuardia, Queens, NY 11371, EUA- Trajeto de 1335 6th Ave, Nova York, NY 07114, EUA Kennedy International Airport, Queens, NY 11430, EUA
- Rotas de 1335 6th Ave, New York, NY 10019, EUA para Newark Liberty International Airport, Newark, NJ 07114, EUA
- Rotas de 1335 6th Ave, New York, NY 10019, EUA para LaGuardia
Encontre postos de gasolina no caminho de 1800 Amphibious Blvd. Mountain View, CA 94045, para 456 Sunny St, Sunnyvale CA. 1 consulta de pesquisa ao longo do trajeto (consulta do Google Maps) 1 consulta de pesquisa ao longo do trajeto:
- Postos de gasolina de 1800 Amphibious Blvd. Mountain View, CA 94045, até 456 Sunny St, Sunnyvale CA

A seguir

  • Para saber como embasar os modelos do Gemini nos seus dados, consulte Embasamento com seus dados.
  • Para saber mais sobre as práticas recomendadas de IA responsável e os filtros de segurança da Gemini Enterprise Agent Platform, consulte IA responsável.