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

O SDK do Places para Android permite 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 : a Plataforma Google Maps oferece versões separadas da biblioteca Places para Android, iOS, JavaScript e Web Services. Recomendamos que você use a versão da biblioteca Places específica para sua plataforma. Ou seja, se você estiver desenvolvendo um app Android, use a versão do Android do Places.

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, além do local atual do dispositivo.
• Autocomplete fornece 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.

Escolher a versão do SDK

Os recursos do SDK do Places para Android disponíveis no seu app são determinados por uma combinação do número da versão do SDK (por exemplo, 3.5.0) especificado na configuração do app, das APIs ativadas na chave de API e da forma como você inicializa o app. Para saber mais sobre as diferenças entre o SDK do Places para Android e o SDK do Places para Android (novo), consulte Escolher a versão do SDK.

Sua primeira tarefa é decidir qual SDK usar. Isso é verdadeiro se você for um cliente novo ou atual que já usa o SDK. Para saber as principais diferenças entre as duas versões do SDK, consulte Escolher a versão do SDK.

Preços de cada versão do SDK

A versão do SDK ativa controla o preço do uso do SDK. O SDK do Places para Android (novo) oferece suporte a um modelo de preços simplificado para que você pague apenas pelos dados que usa. Para informações detalhadas sobre preços do SDK do Places para Android e do SDK do Places para Android (novo), consulte Uso e faturamento.

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.
• Local atual: retorna uma lista de lugares onde o dispositivo do usuário foi localizado pela última vez, além de uma indicação da probabilidade relativa de cada lugar.
• Place Details (Detalhes do lugar) retornam e mostram informações mais detalhadas sobre um lugar.
• A Pesquisa de texto retorna lugares com base em uma string de texto de pesquisa. A pesquisa de texto faz parte do SDK do Places para Android (novo).
• Fotos do lugar retorna imagens de alta qualidade de um lugar.
• 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.