Visão geral do SDK do Places para Android (legado)

Use este guia para entender as principais diferenças entre as versões do SDK do Places e migrar para o SDK do Places para Android (novo).

Recursos do SDK disponíveis em cada versão

A tabela a seguir mostra quais versões do SDK e da API são necessárias para cada recurso do SDK:

Recurso Versão da API Places Método de inicialização Versão mínima do SDK
Preenchimento automático (novo) API Places (nova) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (novo) API Places (nova) initializeWithNewPlacesApiEnabled() 3.3.0
Nearby Search (novo) API Places (nova) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (novo) API Places (nova) initializeWithNewPlacesApiEnabled() 3.4.0
Text Search (novo) API Places (nova) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete API Places (legada) initialize() (descontinuado)
Current Place API Places (legada) initialize() (descontinuado)
Place Details API Places (legada) initialize() (descontinuado)
Place Photos API Places (legada) initialize() (descontinuado)

Migrar para as novas APIs

Para migrar para as novas APIs, consulte os seguintes guias de migração:

Melhorias no SDK do Places para Android (novo)

Esta seção aborda os principais recursos adicionados ao SDK do Places para Android (novo).

Implementado na plataforma padrão do Google Cloud

O SDK do Places para Android (novo) é implementado na infraestrutura de serviço do Google Cloud. Essa implementação oferece uma plataforma mais segura e confiável. Esse design padrão oferece um nível de consistência nos SDKs que melhora a eficiência do desenvolvimento com o SDK do Places para Android (novo).

Desempenho aprimorado

O SDK do Places para Android (novo) oferece desempenho aprimorado, o que vale a pena substituir apps que usam o SDK atual.

Novos recursos

O SDK do Places para Android (novo) inclui as versões mais recentes de todos os recursos do SDK:

Text Search (novo)

Text Search (novo) retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo" ou "loja de sapatos perto do Rio de Janeiro" ou "Avenida Brasil, 123". O serviço responde com uma lista de locais correspondentes à string de texto e a todos os direcionamentos de localização definidos.

Novos dados de resposta adicionados ao Place Details (novo) e ao Place Photos (novo)

Nova resposta de URI adicionada ao Place Photos (novo)

Agora é possível usar Place Photos (novo) para retornar um URI a um bitmap de imagem. Antes, só era possível retornar o próprio bitmap da imagem.

Preços simplificados

Os preços são simplificados com o SDK do Places para Android (novo), para que você pague apenas pelos dados usados. Os preços simplificados são implementados usando listas de campos, também chamadas de máscaras de campo.

Com o Place Details (novo) e o Text Search (novo), você usa listas de campos para controlar a lista de campos a serem retornados na resposta. A cobrança é feita apenas pelos dados solicitados. O uso de uma lista de campos é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar tempo de processamento e cobranças desnecessárias.

Para mais informações sobre preços, consulte Uso e faturamento.

Tipos de lugares expandidos

O novo SDK inclui novos tipos de lugares, que são retornados como parte da resposta do Place Details (novo) e do Text Search (novo). Também é possível usar esses novos tipos e os atuais em uma pesquisa com o Text Search (novo). Os novos tipos estão incluídos em Tabela A.