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.
Mostrar o logotipo do Google e atribuições
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.
| Para uso em segundo plano claro | Para uso em segundo plano escuro |
|---|---|
|
|
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:
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.
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 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 ( |
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 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 ( |
| Ver avaliações | Use o link contido no campo googleMapsLinks.reviewsUri da resposta. |
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.
#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.
#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;