Neste documento, listamos os requisitos específicos de todos os aplicativos desenvolvidos com a API Places, inclusive o serviço Place Autocomplete que faz parte dessa API. Veja mais informações gerais para desenvolvedores do Google Maps nos Termos de Serviço da Plataforma Google Maps.
Fornecimento de termos de uso e política de privacidade
Se você desenvolver um aplicativo da API Places, será necessário disponibilizar os Termos de Uso e a Política de Privacidade com seu aplicativo, de acordo com as diretrizes descritas no seu Contrato com o Google:
- Os Termos de Uso e a Política de Privacidade precisam ser disponibilizados publicamente.
- Você precisa declarar explicitamente nos Termos de Uso do aplicativo que, ao usá-lo, os usuários estão sujeitos aos Termos de Serviço do Google.
- Na sua Política de Privacidade, informe aos usuários que você está usando as APIs Google Maps e incorpore a Política de Privacidade do Google para referência.
O local recomendado para disponibilizar os Termos de Uso e a Política de Privacidade depende da plataforma do aplicativo.
Apps para dispositivos móveis
Ao desenvolver um app para dispositivos móveis, é recomendável fornecer um link para os Termos de Uso e a Política de Privacidade na página de download na app store relevante e no menu de configurações dele.
Aplicativos da Web
Ao desenvolver um aplicativo da Web, é recomendável incluir um link para os Termos de Uso e a Política de Privacidade no rodapé do site.
Pré-busca, armazenamento em cache ou armazenamento de conteúdo
Os aplicativos que usam a API Places estão sujeitos aos termos do seu Contrato com o Google. Sujeito aos termos do seu Contrato, não é permitido fazer uma pré-busca, indexar, armazenar ou armazenar em cache qualquer Conteúdo, exceto sob as condições limitadas estabelecidas 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 de lugar é retornado no campo "place_id" nas respostas da API Places. Saiba como salvar, atualizar e gerenciar IDs de lugares no Guia de IDs de lugares.
Mostrar resultados da API Places
Você pode exibir os resultados da API Places em um mapa do Google ou sem um mapa. Para mostrar os resultados da API Places em um mapa, eles precisam ser mostrados em um mapa do Google. É proibido usar os dados da API Places em mapas que não sejam do Google.
Exibição do logotipo e das atribuições do Google
Se o aplicativo exibir dados em um mapa do Google, o logotipo do Google será incluído e não poderá ser alterado. Aplicativos que exibem dados do Google na mesma tela que um mapa do Google não precisam fornecer mais atribuições ao Google.
Se seu aplicativo exibir dados em uma página ou visualização que não exibe também um mapa do Google Maps, será necessário exibir um logotipo do Google com esses dados. Por exemplo, se o aplicativo exibe dados do Google em uma guia e um mapa do Google com esses dados em outra, a primeira guia precisa mostrar o logotipo do Google. Se o app usa campos de pesquisa com ou sem preenchimento automático, o logotipo precisa ser exibido inline.
O logotipo do Google deve ser colocado no canto inferior esquerdo do mapa, com as informações de atribuição posicionadas no canto inferior direito, sendo que ambas precisam ser apresentadas no mapa como um todo, e não abaixo do mapa ou de outro lugar dentro do app. O exemplo de mapa a seguir mostra o logotipo do Google no canto inferior esquerdo do mapa e a atribuição no canto inferior direito.
Para uso em um fundo claro | Para uso com fundo escuro |
---|---|
O arquivo ZIP a seguir contém o logotipo do Google nos tamanhos corretos para apps para computador, Android e iOS. Não é permitido redimensionar nem modificar esses logotipos de forma alguma.
Fazer o 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 logotipos do Google inline (por exemplo, "Estes mapas são do [Google_logo]").
Mantenha a atribuição próxima. Se estiver usando capturas de tela de imagens do Google fora de incorporações diretas, inclua a atribuição padrão como aparece na imagem. Se necessário, você pode personalizar o estilo e o posicionamento do texto de atribuição, desde que ele esteja próximo ao conteúdo e legível para o espectador ou leitor médio. Não é permitido afastar a atribuição do conteúdo, como ao final do livro, aos créditos de arquivos ou programas ou ao rodapé do site.
Inclua provedores de dados de terceiros. Alguns dados e imagens dos nossos produtos de mapeamento vêm de outros provedores, além do Google. Se você usa essas imagens, o texto da atribuição precisa mostrar o nome "Google" e os provedores de dados relevantes, como "Dados do mapa: Google, Maxar Technologies". Quando há provedores de dados de terceiros citados com as imagens, a atribuição adequada apenas de "Google" ou do logotipo do Google não é considerada.
Se você está usando a Plataforma Google Maps em um dispositivo em que a exibição da atribuição não é prática, entre em contato com a equipe de vendas do Google para conversar sobre licenças apropriadas para seu caso de uso.
Outros requisitos de atribuição
Siga estas instruções para recuperar atribuições de terceiros e para exibir as atribuições no seu app.
Recuperar atribuições de um lugar
Se o seu app exibe informações coletadas chamando o Place Details com um ID de lugar, ele também precisa mostrar atribuições de terceiros para os detalhes do local obtidos.
As atribuições no objeto
Place
de uma resposta são representadas por um
objeto
Attribution
. Para adicionar o 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 ou uma string vazia se não houver atribuições a
serem mostradas.
Exibir atribuições para uma foto
Se o app exibe fotos, é necessário mostrar atribuições de autor para cada foto que as tiver.
Os detalhes sobre a foto em um objeto
Place
de uma resposta estão contidos na matriz photos
. 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 ou uma
string vazia se não houver atribuições a serem mostradas.
Exibir uma avaliação
Um objeto Place
em uma resposta pode conter até cinco avaliações. Também é possível exibir essas avaliações no
seu app.
Ao exibir avaliações de contribuições de usuários do Google, coloque o nome do autor próximo. Quando disponível no campo de atribuição de autor
do objeto Review
, recomendamos incluir a foto do autor
e o link para o perfil dele. A imagem a seguir mostra um exemplo da 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 avaliaçã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 vão ficar vazios se não houver
atribuição a ser mostrada.
Diretrizes de estilo para a atribuição do Google
Confira a seguir as diretrizes de estilo para atribuições do Google em CSS e HTML, caso você não consiga usar o logotipo do Google disponível para download.
área de respiro
A quantidade de espaço livre ao redor do logotipo completo precisa ser igual ou maior que a altura do "G" no Google.
O espaço entre o texto da atribuição e o logotipo do Google precisa ter metade da largura do "G".
Legibilidade
A assinatura precisa sempre ser clara, legível e aparecer na variação de cor certa para um determinado plano de fundo. Sempre ofereça contraste suficiente para a variação de logotipo selecionada.
Cor
Use o texto Google Material Gray 700 em um fundo branco ou claro que use um intervalo de 0% a 40% de tonalidade máxima de preto.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Em planos de fundo mais escuros e sobre padrões de fotografia ou de não preenchimento, use texto branco para assinatura e atribuição.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Fonte
Use a fonte Roboto.
Exemplo de CSS
O CSS a seguir, quando aplicado ao texto "Google", renderiza "Google" com a fonte, a cor e o espaçamento apropriados em um fundo 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;