Políticas e atribuições da API Geocoding

Este documento lista os requisitos para aplicativos desenvolvidos com a API Geocoding. O uso da API Geocoding é regido pelo seu contrato com o Google.

Políticas

Nesta seção, descrevemos as políticas relevantes para a API Geocoding. As políticas fornecem diretrizes e requisitos práticos de implementação para ajudar você a usar o Serviço corretamente e de acordo com as expectativas da Plataforma Google Maps.

Exceções às restrições de armazenamento em cache

O ID de lugar, usado para identificar um local de maneira exclusiva, está isento das restrições de armazenamento em cache. Portanto, é permitido armazenar valores de ID de local indefinidamente. O ID de lugar é retornado no campo place_id nas respostas da API. Aprenda a salvar, atualizar e gerenciar IDs no guia de IDs de lugar.

Filtragem e reordenação do lado do cliente

É possível realizar a filtragem do lado do cliente na lista de resultados de nível superior, como remover resultados de endereço que não correspondem a critérios específicos de país ou código postal. Também é possível filtrar ou reordenar sublistas contidas em um único resultado, como priorizar determinados pontos de navegação, desde que os critérios de filtragem ou reordenação não sejam enganosos para os usuários finais. É preciso garantir que essas modificações não deturpem os dados originais retornados pela API.

Países e territórios do Espaço Econômico Europeu

Este produto tem Termos de Serviço diferentes para clientes com um endereço de faturamento no Espaço Econômico Europeu (EEE) e também pode ter funcionalidades diferentes. Antes de criar com a Plataforma Google Maps, leia os seguintes termos e informações específicos do EEE:

• Termos de Serviço da Plataforma Google Maps para o EEE
• Termos de Serviço Específicos da Plataforma Google Maps para o EEE
• Perguntas frequentes sobre o EEE
• Requisitos de segurança viária da Plataforma Google Maps

Se o seu endereço de faturamento não estiver no EEE, os seguintes Termos de Serviço serão aplicáveis:

• Termos de Serviço da Plataforma Google Maps
• Termos de Serviço específicos da Plataforma Google Maps

Requisitos de atribuição do Google Maps

Esta seção apresenta os requisitos e as diretrizes de atribuição para mostrar o Google Maps e o Conteúdo nos seus aplicativos.

Mostrar atribuição do Google Maps

Siga os requisitos de atribuição do Google Maps ao exibir conteúdo das APIs da Plataforma Google Maps no seu app ou site. Não é necessário adicionar outra atribuição se o Conteúdo for mostrado em um mapa do Google em que a atribuição já esteja visível.

Atribuição do Google Maps incluída

Para atribuições do Google Maps que já são fornecidas pela Plataforma Google Maps na interface do usuário, como no Kit de Interface do Places:

• Não remova a atribuição incluída, independentemente de onde ela é exibida. Não altere, oculte ou obscureça a atribuição e verifique se ela está claramente visível em relação ao plano de fundo.
• Sempre diferencie visualmente o conteúdo da Plataforma Google Maps de outros conteúdos usando indicações da interface, como uma borda, cor de plano de fundo, sombra ou espaço em branco suficiente.
• Ao fazer modificações visuais, você precisa aderir a todos os requisitos de atribuição do Google Maps.

Atribuição de texto e logotipo do Google Maps

Sempre que possível, a atribuição precisa ser feita com o logotipo do Google Maps. Em casos de espaço limitado, o texto Google Maps é aceitável. É preciso que fique sempre claro para os usuários finais qual conteúdo é fornecido pelo Google Maps.

Atribuição de logotipo

Baixar os logotipos do Google Maps

Use os arquivos oficiais do logotipo do Google Maps. Faça o download dos logotipos abaixo e siga as diretrizes desta seção.

Ao usar o logotipo do Google Maps, siga estas diretrizes.

• Não modifique o logotipo de forma alguma.
• Mantenha a proporção do logotipo para evitar distorções.
• Use o logotipo com contorno em um plano de fundo com muitos detalhes, como um mapa ou uma imagem.
• Use o logotipo sem contorno em um plano de fundo simples, como uma cor sólida ou um gradiente sutil.

Especificação de tamanho do logotipo

• Altura mínima do logotipo: 16 dp
• Altura máxima do logotipo: 19 dp
• Espaço livre mínimo do logotipo: 10 dp à esquerda, à direita e na parte de cima, 5 dp na parte de baixo

Para saber mais sobre dp, consulte Densidade de pixels no site do Material Design.

Acessibilidade do logotipo

• Mantenha um contraste acessível entre o logotipo e o plano de fundo.
• Inclua um rótulo de acessibilidade com o texto Google Maps.

Atribuição de texto

Se o tamanho da sua interface não permitir o uso do logotipo do Google Maps, escreva Google Maps em texto. Siga as seguintes diretrizes:

• Não modifique o texto Google Maps de forma alguma:
  
  • Não mude as letras maiúsculas de Google Maps.
  • Não quebre 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:

  Requisitos de estilo de texto do Google Maps
  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 saber mais sobre sp, consulte Unidades de tamanho de 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 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;
}

Requisitos visuais

• Posicione a atribuição perto da parte de cima ou de baixo do conteúdo e no mesmo contêiner visual. Para uma única linha de conteúdo, a atribuição pode ser posicionada à direita ou à esquerda.

• Diferencie visualmente o conteúdo da Plataforma Google Maps de outros conteúdos usando indicações da interface, como uma borda, cor de plano de fundo, sombra ou espaço em branco suficiente.

• Não deturpe o Google Maps atribuindo a ele conteúdo que não seja da Plataforma Google Maps.
• Verifique se a atribuição está sempre visível e legível. Nunca remova, oculte, obscureça ou modifique essa atribuição.

As figuras a seguir mostram exemplos desses requisitos visuais.

Provedores de dados de terceiros

Alguns dados e imagens nos nossos produtos de mapas têm origens diferentes do Google. Para alguns produtos, como a API Map Tiles, podemos fornecer a atribuição necessária ao provedor de dados de terceiros. Nesse caso, o texto da atribuição precisa mostrar o nome "Google Maps" e os provedores de dados relevantes, como "Dados do mapa: Google, Maxar Technologies". Quando o Google fornece atribuição de terceiros, apenas incluir "Google Maps" ou o logotipo do Google não é uma atribuição correta.

Resumos gerados com IA (Destinos)

Ao mostrar resumos gerados com IA retornados pelo método SearchDestinations no seu app, faça o seguinte:

• Mostre as atribuições, os links de relatórios e os links de referência necessários, conforme definido nesta seção.
• Garanta que os usuários finais possam ler o texto completo do resumo, conforme fornecido pela Plataforma Google Maps.

Mostrar o texto de declaração dos resumos gerados com IA

Ao mostrar um resumo gerado com IA, sempre inclua o texto de declaração localizado fornecido no campo de resposta disclosureText logo abaixo do resumo. Nunca modifique ou aumente o texto de declaração fornecido pela API.

Requisitos de resumo de chegada

Os resumos de chegada exibidos no app precisam ser acompanhados pelo seguinte texto e links obrigatórios:

Orientação de exibição para casos de uso automotivos

Para a segurança do motorista, o Google recomenda renderizar resumos gerados com IA no modo estacionado para experiências automotivas. Se você renderizar resumos no modo Dirigindo, as informações na tela precisam ser claras e concisas para garantir que a atenção do motorista volte rapidamente para a estrada:

• No máximo 3 linhas
• Até 120 caracteres ou 24 palavras
• Tamanho mínimo da fonte de 24 dp

Especialmente em contextos automotivos, é responsabilidade do desenvolvedor renderizar resumos gerados com IA de maneira segura e em conformidade com todas as leis e regulamentações locais.