O SDK Places permite pesquisar e extrair informações de vários tipos de lugar usando uma string de texto ou proximidade. O SDK do Places é a versão legada do SDK do Places (novo).
Use este guia para entender as principais diferenças entre as versões do SDK do Places e migrar para o SDK do Places (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 | API Places ativada na chave de API | Método de inicialização | Versão mínima do SDK |
|---|---|---|---|
| Preenchimento automático (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Detalhes do lugar (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Pesquisa por proximidade (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Photos (novo) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Pesquisa de texto (nova) | API Places (nova) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places | initialize() |
|
| Current Place | API Places | initialize() |
|
| Detalhes do lugar | API Places | initialize() |
|
| Place Photos | API Places | initialize() |
Migrar para as novas APIs
Para migrar para as novas APIs, consulte estes guias de migração:
- Migrar para o Place Details (novo)
- Migrar para o Place Photo (novo)
- Migrar para o preenchimento automático (novo)
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ços do Google Cloud. Essa implementação oferece uma plataforma mais segura e confiável. Esse design padrão traz um nível de consistência entre os SDKs que melhoram a eficiência do desenvolvimento com o SDK do Places para Android (novo).
Desempenho aprimorado
O SDK do Places para Android (novo) oferece melhor desempenho, o que torna a substituição de apps que usam o SDK atual mais vantajosa.
Novos recursos
O SDK do Places para Android (novo) inclui as versões mais recentes de todos os recursos do SDK:
- Preenchimento automático (novo)
- Detalhes do lugar (novo)
- Pesquisa por proximidade (novo)
- Place Photos (novo)
- Pesquisa de texto (nova)
Novo serviço de pesquisa de texto
A Pesquisa de texto (nova) retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo", "loja de sapatos perto do Rio de Janeiro" ou "Avenida Brasil, 123". O serviço responde com uma lista de lugares correspondentes à string de texto e a todos os direcionamentos de localização definidos.
Novos dados de resposta adicionados a Place Details (novo) e Place Photos (novo)
Place Details (novo) agora inclui a nova classe Review no objeto
Placeda resposta. A classe Place contém o novo métodogetReviews()para oferecer suporte a esse campo. ChamegetReviews()para retornar até cinco avaliações de um lugar.Place Photo (novo) adiciona o
AuthorAttributionsà classePhotoMetadata.AuthorAttributionscontém umListde objetosAuthorAttribution.
Nova resposta de URI adicionada a "Place Photos" (nova)
Agora é possível usar Place Photo (novo) para retornar um URI para um bitmap de imagem. Antes, só era possível retornar o bitmap da imagem.
Precificação simplificada
O preço é simplificado com o SDK do Places para Android (novo), para que você pague apenas pelos dados que usa. O preço simplificado é implementado usando listas de campos, também chamadas de máscaras de campo.
Com os detalhes do lugar e a pesquisa de texto, você usa listas de campos para controlar a lista de campos a serem retornados na resposta. A cobrança é feita apenas pelos dados solicitados. Usar uma lista de campos é uma boa prática de design para garantir que você não peça dados desnecessários, o que ajuda a evitar tempo de processamento e cobranças.
Para informações detalhadas sobre os preços dos dois SDKs, consulte Uso e faturamento.
Tipos de lugar expandidos
O novo SDK inclui novos tipos de lugar, que são retornados como parte da resposta de Place Details e Text Search. Você também pode usar esses novos tipos e os existentes em uma pesquisa com a Pesquisa de texto. Os novos tipos estão incluídos na Tabela A.