Nesta página, descrevemos 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 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 as fontes de dados.
Usos do embasamento com o Google Maps
É possível usar o embasamento com o Google Maps para vários aplicativos, como:
- Assistentes de conversa que podem responder a perguntas sobre lugares próximos, como "Onde fica o lugar mais próximo para tomar um 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 redes sociais.
Modelos compatíveis
Esta seção lista os modelos que oferecem suporte ao embasamento com o Google Maps.
Clique para abrir os modelos compatíveis
- Gemini Nano Banana 2.1
- Gemini 4 Argon Cyber Permissive
- Gemini 4 Argon
- Gemini 3.8 Live
- Gemini 3.8 Flash
- Gemini 3.7 Flash
- Gemini 3.6 Flash
- Gemini 3.5 Flash-Lite
- Gemini 3.5 Flash
- Gemini 3.1 Pro
- Gemini 3.1 Flash-Lite
- Gemini 3.1 Flash Image
- Gemini 3 Pro Image
- Gemini 3 Flash
- Gemini 2.5 Pro
- Gemini 2.5 Flash-Lite
- Gemini 2.5 Flash com áudio nativo da API Gemini Live
- Gemini 2.5 Flash
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 plataforma de agentes do Gemini Enterprise, siga estas etapas:
No console do Cloud de Confiance , acesse a página Agent Studio.
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 aparece.
Ative a opção Google Maps.
Clique em Aplicar.
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 mais informações, 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.7749representa São Francisco. É possível 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.4194representa São Francisco. - GROUNDING_TYPES: os tipos de embasamento do Google Maps a serem ativados. Atualmente, é compatível com
placeserouting.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.
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
Esta seção lista 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.
Exemplo de propriedades de lugar
Esta lista fornece 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 dos combustíveis e tipos 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 a 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 deles?
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 pratos vegetarianos? O que os avaliadores dizem sobre o molho marinara?
As respostas a essas perguntas usam os recursos Destaques do menu e 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.
Uma 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? Eles servem 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 conectores são compatíveis? E como fica o 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 aglomeraçã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 abastecimento 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 Encontrar rotas, seu modelo pode fornecer trajetos otimizados para performance 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 ponto a ponto e calcule os tempos estimados de deslocamento para modos de transporte específicos.
Recursos
O Find Directions 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 carro, caminhada, 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 atuais de trânsito para fornecer tempos de viagem "ao vivo" precisos em vez de médias estáticas.
Confira alguns exemplos de perguntas que o recurso Encontrar rotas 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 trajeto: "Quanto tempo leva para ir de transporte público do Pike Place Market até Capitol Hill em Seattle?"
Ativar o recurso Encontrar Rotas
Nas API REST e nos SDKs, o embasamento com o Google Maps usa os dados do Places por padrão somente quando grounding_types é omitido. Para ativar os recursos de rotas, você
precisa configurar explicitamente routing em grounding_types na configuração
da solicitação. Se você quiser usar as ferramentas Places e Routing, especifique places e routing em grounding_types.
Entender a resposta
Quando um comando aciona o recurso Encontrar rotas, o modelo gera uma resposta em linguagem natural com suporte de 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 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é:
Comece no Hilton Hotel:saia do Hilton Hotel em 1335 6th Ave.
Caminhe para o sul na 6ª Avenida:siga para o sul na 6ª Avenida (Avenida das Américas) em direção à Rua 44 Oeste.
Vire à direita na W 44th Street:vire à direita na W 44th Street.
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 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 de Pike St & 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
Com a Pesquisa ao longo do trajeto, seus agentes de IA descobrem pontos de interesse 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 da rota, seu aplicativo pode identificar empresas, comodidades ou atrações específicas localizadas diretamente em um caminho gerado entre uma origem e um destino. Somente o meio de transporte "Carro" é aceito.
Os exemplos a seguir ilustram os tipos de perguntas que a ferramenta Pesquisar ao longo do trajeto pode responder.
- Pesquisa básica de rotas: "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 conversas.)
- Pesquisar com base em propriedades de 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 rotas 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."
Ativar a pesquisa ao longo do trajeto
A Pesquisa no trajeto exige os recursos Places e Routing para descobrir lugares ao longo de um trajeto. 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 metadados estruturados que combinam dados do Google Maps e do Maps Platform. 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 rotas]:
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]:
Confira 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. Tem uma classificação de 3, 5 estrelas em 122 avaliações e vende hidrogênio, propano e gasolina, além de oferecer serviços de lava-rápido. Fica aberto até as 21h50 hoje e tem banheiros.
- Posto de gasolina fictício: localizado em 456 Fictional Ave, Sunnyvale, CA 94045. Ele tem uma classificação de 3,6 estrelas em 52 avaliações e oferece uma loja de conveniência e um 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. Esta estação fica aberta 24 horas e tem banheiros.
Exemplo de comando [Pesquisa de trajeto com várias etapas]:
Vou fazer uma viagem de carro de São Francisco a San Luis Obispo e depois a Los Angeles. Sugira três opções de carregadores de veículos elétricos entre São Francisco e San Luis Obispo e entre San Luis Obispo e Los Angeles.
Exemplo de resposta [pesquisa de rota 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:
- Exemplo de carregador: localizado na Rua Exemplo, 123, Campbell, CA 95008, esta estação tem uma classificação de 4,5.
- Fictional EV Station: 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:
- Exemplo de carregador: localizado em 123 Example Rd, San Luis Obispo, CA 93123, essa estação tem uma classificação de 4,3.
- Eletroposto fictício: localizado em 456 Fictional Ave, Santa Barbara, CA 93123, com uma classificação de 3,9.
- Eletroposto genérico: você pode encontrar esse eletroposto em 789 Generic St, Glendale, CA 93123, com uma classificação de 3,0.
Boa 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 ao usuário sobre o uso de fontes do Google Maps
Com cada Resultado Embasado do Google Maps, você recebe fontes no
groundingChunks que embasam 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, é necessário especificar as fontes associadas do Google Maps e informar aos usuários o seguinte:
- As fontes do Google Maps precisam aparecer imediatamente após o conteúdo gerado que elas embasam. 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 obedecer aos requisitos de origem e está sujeito aos limites aplicáveis de armazenamento e 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 divulgaçã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.
Anúncio 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 divulgaçã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 por 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 de voz precisa responder com precisão às consultas do usuário final sobre a origem do conteúdo, inclusive quando o conteúdo gerado por IA inclui informações do Google Maps. Se o Google Maps for a origem, direcione os usuários finais para a UI complementar para acessar informações específicas da origem.
Mostrar fontes do Google Maps com links do Google Maps
Para cada origem em groundingChunks, uma prévia de link precisa ser gerada de acordo com
estes requisitos:
- Atribua cada fonte ao Google Maps seguindo as diretrizes de atribuição de texto do Google Maps.
- Mostra o título da fonte fornecido na resposta.
- Vincule à fonte usando o
urida resposta.
Estas imagens mostram os requisitos mínimos para exibir as fontes e os links do Google Maps.
É possível recolher a visualização das fontes.
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 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: 12sp Tamanho máximo da fonte: 16sp Para saber mais sobre sp, consulte Unidades de tamanho da fonte no site do Material Design. |
| Espaçamento entre letras | Normal |
CSS de exemplo
O CSS a seguir renderiza o Google Maps com o estilo e a cor tipográficos adequados em um segundo plano branco ou claro.
@import url('https://documentation.s3ns.fr/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 da 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:
placeIdreviewId
As restrições contra armazenamento em cache nos Termos do 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 vai distribuir nem comercializar um Aplicativo do Cliente que ofereça o Embasamento com o Google Maps em um Território Proibido. 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 feita no 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). | Três consultas de Place Search (consultas do Google Maps), supondo que este comando gere três consultas de fanout. | 3 consultas de Place Search com fanout: - Melhor sushi perto do Hilton Midtown Manhattan - Restaurantes de sushi perto de 1335 6th Ave, Nova York - Restaurantes japoneses perto de 1335 6th Ave, Nova 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 até 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 Place Search com fanout: - Aeroportos perto de Nova York 3 consultas de rotas: - Rotas de 1335 6th Ave, Nova York, NY 10019, EUA até John F. Aeroporto Internacional John F. Kennedy, Queens, NY 11430, EUA - Como chegar de 1335 6th Ave, Nova York, NY 10019, EUA até o Aeroporto Internacional Newark Liberty, Newark, NJ 07114, EUA - Como chegar de 1335 6th Ave, Nova York, NY 10019, EUA até o Aeroporto LaGuardia |
| Encontre postos de gasolina no caminho de 1800 Amphibious Blvd. Mountain View, CA 94045, até 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 mais sobre como embasar 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 plataforma de agentes do Gemini Enterprise, consulte IA responsável.