O SDK do Places para Android (novo) oferece melhor desempenho e um novo modelo de preços, o que torna interessante atualizar os apps que usam o SDK do Places para Android (legado). Para mais detalhes sobre a comparação de recursos, consulte Escolher seu SDK.
Use este guia para entender as principais diferenças entre o SDK do Places para Android (novo) e o SDK do Places para Android (legado), além de como lidar com as mudanças necessárias.
Práticas recomendadas de faturamento para migração
Esta orientação se aplica se o uso da API for alto o suficiente para passar para o preço de segundo nível. Ao migrar para uma versão mais recente de uma API, você também recebe cobranças por uma SKU diferente. Para evitar custos maiores durante o mês da transição, recomendamos mudar para as novas APIs em produção o mais próximo possível do início do mês. Isso garante que você alcance os níveis de preços mensais mais econômicos durante o mês da migração. Para informações sobre níveis de preços, consulte a página de preços e as perguntas frequentes sobre preços.
Ativar a API Places (nova)
O SDK do Places para Android (legado) depende do serviço da API Places. Para usar os recursos do SDK Places para Android (novo), primeiro ative a API Places (nova) no projeto do Google Cloud. Para mais informações, consulte Configurar seu projeto do Google Cloud.
Em seguida, verifique se você adicionou a API Places (nova) à lista de APIs autorizadas na chave usada pelo seu app. Para mais informações, consulte Usar chaves de API.
Verifique se você tem cota suficiente na API Places (novo)
Verifique se há cota suficiente na API Places (New) para cobrir seu tráfego atual. Para revisar e gerenciar suas cotas e limites de uso, consulte Cotas e alertas de cota.
Observe a diferença:
- A cota do SDK do Places para Android (legado) depende da cota do serviço da API Places. É a soma de todos os métodos da API Places.
- A cota do SDK do Places para Android (novo) depende da cota do serviço da API Places (novo). Há uma cota separada para cada método de API.
Verifique se o contrato negociado inclui a API Places (novo)
Se você tiver um contrato negociado, verifique se ele abrange a API Places (New) com os preços esperados. Caso contrário, entre em contato com seu representante de vendas no Google ou com seu parceiro para discutir como incluir essa API.
Mudanças gerais
Algumas mudanças gerais que se aplicam a várias APIs incluem:
Usa um novo modelo de preços. Para informações de preços de todas as APIs, consulte SDK do Places para Android (novo).
Inicialize o app chamando o método
Places.initializeWithNewPlacesApiEnabled()
. Para mais informações sobre como selecionar o serviço da API Places, consulte Configurar seu projeto do Google Cloud.O Place Details (novo), o Nearby Search (novo) e o Text Search (novo) exigem máscaras de campo para especificar quais campos você quer que sejam retornados na resposta.
Novas classes foram adicionadas para definir as solicitações ou adicionar novos campos à resposta.
O objeto de resposta
Place
contém o novo métodogetReviews()
que retorna uma lista de objetosReview
. Quando seu app mostra informações obtidas do objetoPlace
, como fotos e avaliações, ele também precisa mostrar as atribuições necessárias.Para mais informações, consulte a documentação sobre atribuições.
Mudanças específicas da API
Esta seção inclui os seguintes guias de migração para cada API:
- Migrar de Place Details (legado) para Place Details (novo)
- Migrar do Place Photo (legado) para o Place Photo (novo)
- Migrar do preenchimento automático (legado) para o preenchimento automático (novo)
- Migrar do Current Place (legado) para a Pesquisa nas proximidades (novo)