Visão geral

Selecione a plataforma: Android iOS JavaScript Web Service

Antes de começar : para usar o SDK do Places para Android, você precisa de um projeto com uma conta de faturamento e a API Places ativada. Recomendamos ter vários proprietários de projetos e administradores de faturamento para que sempre haja alguém disponível com essas funções na sua equipe. Para saber mais, consulte Configurar no console do Cloud.

Introdução

Com o SDK do Places para Android, você pode criar apps com reconhecimento de local que respondem contextualmente às empresas locais e a outros lugares perto do dispositivo do usuário. Isso significa que você pode criar apps avançados com base em lugares que significam algo para o usuário, para complementar os serviços geográficos simples oferecidos pelos Serviços de localização do Android.

Observação:o SDK do Places (novo) é a versão atual do SDK do Places para Android. O SDK do Places agora é legado e não pode ser ativado. A documentação legada e os guias de migração estão disponíveis na guia Legacy.

Conceitos

As interfaces a seguir oferecem os principais pontos de entrada do SDK do Places para Android:

• Places concede acesso programático ao banco de dados do Google, que tem informações sobre lugares e empresas, bem como o local atual do dispositivo.
• O Autocomplete oferece widgets pré-criados para retornar previsões de lugares em resposta a consultas de pesquisa do usuário.

Um lugar é definido como um espaço físico com nome. Outra maneira de pensar sobre um lugar é que ele é tudo o que você pode encontrar em um mapa. Exemplos incluem empresas locais, pontos de interesse e locais geográficos. Na API, um lugar é representado pela interface Place. Ele inclui informações como o nome e o endereço do lugar, a localização geográfica, o ID do lugar, o número de telefone, o tipo de lugar, o URL do site e muito mais.

Observação:sempre que o app mostra informações sobre lugares provenientes do SDK do Places para Android, ele também precisa mostrar todas as atribuições relevantes retornadas pela API. Consulte a documentação sobre como mostrar atribuições.

Visão geral da API

Ajude os clientes a descobrir onde eles estão e o que há por perto:

• O Place Autocomplete preenche automaticamente o nome e/ou o endereço de um lugar conforme os usuários digitam.
• Place Details (Detalhes do lugar) retornam e mostram informações mais detalhadas sobre um lugar.
• A Pesquisa de locais por perto retorna uma lista de lugares com base em um local e um raio de pesquisa.
• Fotos do lugar retorna imagens de alta qualidade de um lugar.
• A Pesquisa de texto retorna lugares com base em uma string de texto de pesquisa.
• Os IDs de lugar armazenam o ID exclusivo de um ou mais lugares para recuperar as informações do lugar sob demanda.

Observação:o Google coleta estatísticas de uso anônimas.

Políticas e termos

Todos os aplicativos que usam o SDK do Places para Android precisam obedecer aos requisitos descritos nos Termos de Serviço da Plataforma Google Maps, em Uso e faturamento e em Exibição de atribuição.