Políticas da API Places

Este documento lista os requisitos específicos para todos os aplicativos desenvolvidos com a API Places, incluindo o serviço Place Autocomplete que faz parte da API. Mais informações gerais para desenvolvedores do Google Maps podem ser encontradas nos Termos de Serviço da Plataforma Google Maps.

Fornecimento de termos de uso e política de privacidade

Se você desenvolver um aplicativo com a API Places, disponibilize os Termos de Uso e uma Política de Privacidade que atendam às diretrizes listadas no Contrato com o Google:

  • Os Termos de Uso e a Política de Privacidade precisam ser disponibilizados publicamente.
  • Declare explicitamente nos Termos de Uso do seu aplicativo que, ao usá-lo, as pessoas estão sujeitas aos Termos de Serviço do Google.
  • Avise aos usuários na sua Política de Privacidade que está usando as APIs Google Maps e incorpore a Política de Privacidade do Google para referência.

O lugar recomendado para os Termos de Uso e a Política de Privacidade depende da plataforma do aplicativo.

Aplicativos para dispositivos móveis

Se estiver desenvolvendo um app para dispositivos móveis, recomendamos que coloque um link para os Termos de Uso e a Política de Privacidade na página de download da loja de aplicativos relevante e no menu de configurações do aplicativo.

Aplicativos da Web

Se estiver desenvolvendo um aplicativo da Web, recomendamos que coloque um link para os Termos de Uso e a Política de Privacidade no rodapé do seu site.

Pré-busca, armazenamento em cache ou armazenamento de conteúdo

Os aplicativos que usam a API Places estão vinculados aos termos do seu Contrato com o Google. Sujeito aos termos do Contrato, não faça pré-busca, indexação, armazenamento em cache ou no local de qualquer Conteúdo, exceto de acordo com as condições limitadas declaradas nos termos.

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

Como mostrar resultados da API Places

Mostre os resultados da API Places em um mapa do Google ou sem um mapa. Para mostrar os resultados da API Places em um mapa, use o Google Maps. Não é permitido usar dados da API Places em um mapa que não seja do Google.

O logotipo do Google é incluído quando o aplicativo mostra dados em um mapa do Google e não pode ser alterado. Aplicativos que mostram dados do Google na mesma tela que um mapa não precisam fornecer atribuições adicionais ao Google.

Se o aplicativo mostrar dados em uma página ou visualização que não tem um mapa do Google, inclua o logotipo. Por exemplo, se o aplicativo apresentar dados do Google em uma guia e um mapa do Google em outra, a primeira precisa incluir o logotipo do Google. Se o aplicativo usar campos de pesquisa com ou sem preenchimento automático, mostre o logotipo inline.

O logotipo do Google deve ficar no canto inferior esquerdo do mapa e as informações de atribuição no canto inferior direito. Eles precisam estar no mapa apresentado como um todo, não abaixo dele ou em outro lugar no aplicativo. Exemplo com o logotipo do Google no canto inferior esquerdo do mapa e a atribuição no canto inferior direito.

posição da atribuição da política

O arquivo ZIP a seguir contém o logotipo do Google nos tamanhos corretos para aplicativos para computador, Android e iOS. Não redimensione nem modifique esses logotipos.

Download: google_logo.zip

Não modifique a atribuição. Não remova, oculte ou corte as informações de atribuição. Não é permitido usar os logotipos do Google inline (por exemplo, "Estes mapas são do [Google_logo]").

Mantenha a atribuição próxima. Se for usar capturas de tela de imagens do Google fora da incorporação direta, inclua a atribuição padrão como aparece na imagem. Se necessário, personalize o estilo e a posição do texto de atribuição, contanto que o texto fique próximo ao conteúdo e seja legível para a pessoa comum. Não distancie a atribuição do conteúdo, como no fim do livro, nos créditos dos arquivos ou programa ou no rodapé do site.

Inclua provedores de dados de terceiros. Alguns dados e imagens nos nossos produtos de mapas têm origens diferentes do Google. Se você usar essas imagens, o texto da atribuição deverá mostrar o nome "Google" e os provedores de dados relevantes, como "Dados do mapa: Google, Maxar Technologies". Apenas incluir o nome e o logotipo do Google quando provedores de dados de terceiros são citados nas imagens não é uma atribuição correta.

Se estiver usando a Plataforma Google Maps em um dispositivo em que não é prático mostrar a atribuição, entre em contato com a equipe de vendas do Google para discutir as licenças adequadas ao seu caso de uso.

Outros requisitos de atribuição

Siga estas instruções para recuperar atribuições de terceiros e mostrá-las no seu app.

Recuperar atribuições de um lugar

Se o app mostrar informações obtidas chamando Place Details com um ID de lugar, ele também precisará mostrar atribuições de terceiros para os detalhes de lugar recebidos.

As atribuições no objeto Place de uma resposta são representadas por um objeto Attribution. Para adicionar Attribution à resposta, inclua places.attributions (Nearby Search e Text Search) ou attributions (Place Details) na máscara de campo da solicitação.

Os campos do objeto Attribution são strings que contêm provider e providerUri da atribuição. Se não houver atribuições, a string estará vazia.

Mostrar atribuições de uma foto

Mostre as atribuições do autor de todas fotos que aparecem no seu app.

A matriz photos contém os detalhes da foto em um objeto Place de uma resposta. Para adicionar a matriz photos à resposta, inclua places.photos (Nearby Search e Text Search) ou photos (Place Details) na máscara de campo da solicitação.

Cada elemento da matriz photos é uma instância de Photo, que contém a matriz authorAttributions do tipo AuthorAttribution.

Os campos do objeto AuthorAttribution são strings que contêm displayName, uri e photoUri da atribuição. Se não houver atribuições, a string estará vazia.

Mostrar uma avaliação

Um objeto Place em uma resposta pode conter até cinco avaliações. Você pode mostrar essas avaliações no seu app.

Quando elas têm contribuição de usuários do Google, inclua o nome do autor em um lugar próximo. Inclua a foto do autor quando ela aparece no campo de atribuição do objeto Review e também um link para o perfil. A imagem a seguir mostra um exemplo de avaliação de um parque:

Atribuição do autor

O Google também recomenda que você mostre como as avaliações estão sendo classificadas para o usuário final.

Cada revisão em um objeto Place de uma resposta é representada por um objeto Review. Para adicionar o objeto Review à resposta, inclua places.reviews (Nearby Search e Text Search) ou reviews (Place Details) na máscara de campo da solicitação.

Os campos do objeto Review contêm a atribuição ou ficam vazios se não houver atribuição para mostrar.

Atribuições de resultados da pesquisa

Na Europa, ao usar a classificação não adulterada do Google, os produtos de pesquisa precisam ter um texto explicativo a no máximo um clique de distância que descreva os principais fatores e a ponderação deles que determinam a classificação dos resultados da pesquisa. Texto explicativo:

Header: Sobre esses resultados

Body: quando você pesquisa empresas ou lugares perto de um local, o Google Maps mostra resultados locais. Vários fatores, como relevância, distância e destaque, são combinados para encontrar o melhor resultado.

Botão 1:Saiba mais
O texto"Saiba mais" precisa ter um link para um artigo da Central de Ajuda.

Botão 2:OK

Resumos com tecnologia de IA

Ao mostrar resumos com tecnologia de IA no seu app, incluindo resumos de lugar, área e revisão, 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 pelo Google Maps.

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

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

Declaração para todos os tipos de resumos com tecnologia de IA
Figura 1: texto de divulgação exibido corretamente abaixo de cada um dos três tipos de resumo com tecnologia de IA.

Requisitos adicionais de resumo de lugar e área

Os resumos de lugar e de área exibidos no app precisam ser acompanhados do texto e dos links obrigatórios a seguir:

Texto Requisito
Sobre este resumo Use o link a seguir para acessar "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 campo flagContentUri da resposta para ativar a denúncia de um problema ao Google sobre o conteúdo de um resumo.

Observação:os resumos com tecnologia de IA fornecidos pela API Places (nova) estão sujeitos às políticas de conteúdo e produtos do Google em todos os países. Você precisa notificar os usuários finais de que, se quiserem denunciar conteúdo que precisa ser removido dos Serviços do Google de acordo com as leis aplicáveis, eles precisam usar o URL do conteúdo de sinalização fornecido (flagContentUri).

Divulgação de resumos de lugares e áreas
Figura 2: resumo da área com tecnologia de IA mostrado com os links associados necessários disponibilizados para os usuários finais usando um menu overflow.

Requisitos do resumo da análise

Os resumos das avaliações exibidos no app precisam ser acompanhados de um título com o texto "Resumo da avaliação". Além disso, você precisa usar o texto e os links obrigatórios abaixo:

Texto Requisito
Sobre este resumo Use o link a seguir para acessar "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 campo flagContentUri da resposta.

Observação:os resumos com tecnologia de IA fornecidos pela API Places (nova) estão sujeitos às políticas de conteúdo e produtos do Google em todos os países. Você precisa notificar os usuários finais de que, se quiserem denunciar conteúdo que precisa ser removido dos Serviços do Google de acordo com as leis aplicáveis, eles precisam usar o URL do conteúdo de sinalização fornecido (flagContentUri).

Ver avaliações Use o link contido no campo googleMapsLinks.reviewsUri da resposta.
Divulgação para resumos de avaliações
Figura 3: resumo da revisão com tecnologia de IA mostrado com os links associados necessários disponibilizados para os usuários finais usando um menu overflow.

Orientações de exibição para casos de uso automotivo

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

  • Não mais do que 3 linhas
  • 120 caracteres ou 24 palavras ou menos
  • Tamanho mínimo da parte frontal 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.

Diretrizes de estilo de uma atribuição do Google

Estas são as diretrizes de estilo para atribuições do Google em CSS e HTML, caso não possa usar o logotipo para download do Google.

Espaço livre

O espaço livre ao redor do logotipo completo deve ser pelo menos igual à altura do "G" em Google.

O espaço entre a cópia da atribuição e o logotipo deve ter metade da largura do "G".

Legibilidade

Apresente uma assinatura clara, legível e na variação de cor adequada ao segundo plano. Garanta o contraste correto para a variação de logotipo selecionada.

Cor

Em segundo plano branco ou claro que usa um intervalo de 0% a 40% de tonalidade de preto, o texto deve ser no cinza 700 do Google Material.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Em segundo plano escuro ou em fotografia e padrões simples, use branco para a assinatura e a atribuição.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Fonte

Use Roboto.

CSS de exemplo

Aplique o CSS a seguir no texto "Google" para gerar um resultado com a fonte, a cor e o espaçamento apropriados em segundo plano branco ou claro.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;