Visão geral

Selecione a plataforma: Android iOS JavaScript Serviço da Web

Antes de começar : antes de começar a usar o SDK do Places para Android, você precisa ter um projeto com uma conta de faturamento e ativar a API Places . 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 próximos ao 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 diretos baseados em localização geográfica 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 serviços da Web. Recomendamos usar a versão da biblioteca Places específica para sua plataforma. Ou seja, se você estiver desenvolvendo um app para Android, use a versão para Android do Places.

conceitos

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

• Places oferece acesso programático ao banco de dados do Google de informações sobre lugares e empresas, bem como a localização atual do dispositivo.
• Autocomplete fornece widgets predefinidos para retornar previsões de lugares em resposta a consultas de pesquisa do usuário.

Um lugar é definido como um espaço físico que tem um nome. Outra maneira de pensar em um lugar é como tudo o que pode ser encontrado em um mapa. Por exemplo, empresas locais, pontos de interesse e localizações geográficas. Na API, um local é representado pela interface Place. Ele inclui informações como o nome e endereço do local, a localização geográfica, o ID do lugar, o número de telefone, o tipo do lugar, o URL do site e muito mais.

Observação:sempre que seu app exibe informações sobre locais 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 exibição de atribuições.

Escolha 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 mais informações sobre as diferenças entre os SDKs do Places para Android e Android (novo), consulte Escolher a versão do SDK.

Sua primeira tarefa é decidir qual SDK usar. Isso é válido se você é um cliente novo ou atual que já usa o SDK. Para saber quais são 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 que você ativar vai controlar os preços pelo uso do SDK. O SDK do Places para Android (novo) é compatível com um modelo de preços simplificado para que você pague apenas pelos dados que usar. Se quiser informações detalhadas sobre os preços dos SDKs do Places para Android e Android (novo), consulte Uso e faturamento.

Visão geral da API

Ajude seus clientes a explorar onde eles estão e o que há ao redor:

• O Place Autocomplete preenche automaticamente o nome e/ou endereço de um lugar conforme a pessoa digita.
• Current Place retorna uma lista de locais em que o dispositivo do usuário foi localizado pela última vez, além de uma indicação da probabilidade relativa de cada lugar.
• Place Details retornam e mostram informações mais detalhadas sobre um lugar.
• Text Search retorna lugares com base em uma string de texto de pesquisa. O Text Search faz parte do SDK do Places para Android (novo).
• Place Photos retorna imagens de alta qualidade de um lugar.
• IDs de lugar armazenam o ID exclusivo de um ou mais locais para recuperação de informações 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 atender aos requisitos descritos nos Termos de Serviço da Plataforma Google Maps, Uso e faturamento e Exibição de atribuições.