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

Esta seção descreve as políticas relevantes para a API Geocoding. As políticas fornecem diretrizes e requisitos de implementação prática para ajudar você a usar o serviço corretamente e de acordo com as expectativas da Plataforma Google Maps.

Exceções das restrições de armazenamento em cache

Observe que 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. Ele é 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 (por exemplo, remover resultados de endereço que não correspondam a critérios específicos de país ou CEP) e filtrar ou reordenar sublistas contidas em um único resultado (por exemplo, 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. É necessário garantir que essas modificações não representem incorretamente 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, revise os seguintes termos e informações específicos do EEE:

• Termos de Serviço da Plataforma Google Maps no EEE
• Termos de Serviço específicos da Plataforma Google Maps no EEE
• Perguntas frequentes sobre o EEE
• Requisitos de segurança rodoviária da Plataforma Google Maps

Se o 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 fornece requisitos e diretrizes de atribuição para mostrar o Google Maps e o conteúdo nos seus aplicativos.

Observação: os requisitos de atribuição atualizados a seguir agora usam "Google Maps" em vez de apenas "Google". Reconhecemos que suas implementações atuais podem usar a atribuição de "Google," de acordo com as orientações anteriores, e você pode continuar usando "Google" como uma atribuição por enquanto. Para novas implementações, use "Google Maps" conforme descrito nesta seção. No futuro, vamos fornecer cronogramas e instruções para ajudar você a fazer a transição das atribuições do "Google" para as do "Google Maps".

Mostrar a atribuição do Google Maps

É necessário seguir os requisitos de atribuição do Google Maps ao mostrar conteúdo de APIs da Plataforma Google Maps no seu app ou site. Não é necessário adicionar mais atribuições 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 a atribuição do Google Maps que já é fornecida pela Plataforma Google Maps em a interface do usuário, como no Kit de Interface do Places:

• Não remova a atribuição incluída, independentemente de onde ela seja mostrada. Não altere, oculte, ou obscureça a atribuição e verifique se ela está claramente visível no plano de fundo.
• 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, é necessário obedecer a todos os requisitos de atribuição do Google Maps.

Logotipo e atribuição de texto do Google Maps

A atribuição precisa ser feita com o logotipo do Google Maps sempre que possível. Em casos em que o espaço é limitado, o texto Google Maps é aceitável. É necessário que os usuários finais sempre saibam qual conteúdo é fornecido pelo Google Maps.

Esquerda: exemplo de atribuição de logotipo do Google Maps. Direita: exemplo de atribuição de texto do Google Maps

Atribuição de logotipo

Siga estes requisitos para usar o logotipo do Google Maps no seu app ou site.

Exemplos de variações aceitáveis para atribuição de logotipo do Google Maps

Baixar logotipos do Google Maps

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

Baixar os recursos de atribuição do Google Maps

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ção.
• 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 do tamanho do logotipo

Siga estas especificações de tamanho para o logotipo do Google Maps:

• 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.

Exemplo de logotipo do Google Maps mostrando o espaço livre mínimo e o intervalo de tamanho aceitável

Acessibilidade do logotipo

Siga estes requisitos de acessibilidade para o logotipo do Google Maps:

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

Exemplos de variações inaceitáveis e problemas de acessibilidade para atribuição de logotipo do Google Maps

Atribuição de texto

Se o tamanho da interface não for compatível com o uso do logotipo do Google Maps, você poderá escrever Google Maps em texto. Siga estas diretrizes:

Exemplos de variações aceitáveis da atribuição de texto do Google Maps

• Não modifique o texto Google Maps de forma alguma:
  
  • Não altere a capitalização de Google Maps
  • Não quebre Google Maps em várias linhas
  • Não localize Google Maps para outro idioma.
  • Impeça que os navegadores traduzam Google Maps usando o atributo HTML translate="no".

Exemplos de variações inaceitáveis da atribuição de texto do Google Maps

• 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 substitutas	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 o contraste acessível (4,5:1) com o 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 tipográfico e a cor adequados 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

Siga estes requisitos para o tratamento visual da atribuição do Google Maps.

• 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 represente incorretamente o Google Maps atribuindo-o a 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.

As figuras a seguir mostram exemplos desses requisitos visuais.

Exemplo de atribuição do Google Maps posicionada na parte de cima, na parte de baixo e ao lado do conteúdo

Exemplo de duas abordagens para diferenciar o conteúdo do Google Maps (a classificação do lugar) de outros conteúdos

Não obscureça a atribuição do Google Maps nem a misture com conteúdo de outras fontes

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. Quando isso acontecer, o texto da sua atribuição deverá 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 adequada.

Resumos com tecnologia de IA

Ao mostrar resumos com tecnologia de IA 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 abaixo.
• Os usuários finais precisam conseguir ler o texto completo do resumo conforme fornecido por Plataforma Google Maps.

Mostrar o texto de divulgação de resumos com tecnologia de IA

Ao mostrar um resumo com tecnologia de IA, sempre inclua o texto de divulgação localizado (fornecido no campo disclosure_text do corpo da resposta) imediatamente abaixo do resumo. Nunca modifique ou aumente o texto de divulgação fornecido pela API.

Figura 1: texto de divulgação mostrado corretamente abaixo dos resumos com tecnologia de IA.

Requisitos de resumo de chegada

Os resumos de chegada mostrados no seu app precisam ser acompanhados do texto e dos links necessários a seguir:

Texto	Requisito
Sobre este resumo	Use o seguinte link para "Como o Google disponibiliza e usa informações em fichas locais": https://support.google.com/local-listings/answer/9851099.
Denunciar resumo	Use o link contido no flag_content_url campo da resposta para denunciar um problema ao Google sobre o conteúdo de um resumo. Observação:os resumos com tecnologia de IA fornecidos pela API Geocoding estão sujeitos às políticas de conteúdo e produtos do Google em todos os países. É necessário notificar os usuários finais de que, se eles quiserem denunciar conteúdo que precisa ser removido dos serviços do Google de acordo com as leis aplicáveis, eles precisam denunciar usando o URL de conteúdo sinalizado fornecido (flag_content_url).

Figura 2: resumo com tecnologia de IA mostrado com links associados necessários disponibilizados aos usuários finais usando um menu flutuante.

Mostrar orientações para casos de uso automotivo

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

• No máximo três linhas
• Até 120 caracteres ou 24 palavras
• Tamanho mínimo da frente de 24 dp

Principalmente em contextos automotivos, é responsabilidade do desenvolvedor renderizar resumos com tecnologia de IA de maneiras seguras e em conformidade com todas as leis e regulamentações locais.