Informações gerais

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

Introdução

Com o SDK do Places para Android, você pode criar apps com reconhecimento de local que respondem contextualmente às empresas locais e outros locais próximos ao dispositivo do usuário. Isso significa que você pode criar apps avançados com base em locais 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.

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 o local atual do dispositivo.
  • Autocomplete oferece widgets predefinidos para retornar previsões de local em resposta a consultas de pesquisa do usuário.

Um lugar é definido como um espaço físico que tem um nome. Outra forma de pensar em um lugar é algo que pode ser encontrado em um mapa. Exemplos incluem empresas locais, pontos de interesse e localizações geográficas. Na API, um lugar é 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 de lugar, o URL do site e muito mais.

Escolha sua versão do SDK

O SDK do Places para Android versão 3.3.0 é compatível com duas versões: o SDK do Places para Android e o SDK do Places para Android (novo), a versão de última geração do SDK.

Sua primeira tarefa é decidir qual SDK usar. Isso acontece quando você é 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 escolhida do SDK controla os preços do Place Details, do Text Search e do Place Photos. 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. Para informações detalhadas sobre preços de ambos os SDKs, consulte Uso e faturamento.

Perspectiva geral sobre APIs

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

  • O Place Autocomplete preenche automaticamente o nome e/ou o endereço de um local conforme os usuários digitam.
  • 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 informações mais detalhadas sobre um lugar.
  • A Text Search retorna locais com base em uma string de texto da pesquisa. O Text Search faz parte do SDK do Places para Android (novo).
  • O Place Photos retorna imagens de alta qualidade de um lugar.
  • IDs de lugares armazenam o ID exclusivo de um ou mais locais para recuperação de informações sob demanda.

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, Uso e faturamento, e Exibição de atribuições da Plataforma Google Maps.