A API Places (nova) oferece melhor performance e um novo modelo de precificação, o que torna a atualização dos apps que usam a API Places vantajosa. Para mais detalhes sobre a comparação de recursos, consulte Escolher sua API.
Use este guia para entender as principais diferenças entre a API Places (nova) e a API Places, além de como lidar com as mudanças necessárias.
Práticas recomendadas de faturamento para migração
Essa orientação se aplica se o uso da API for alto o suficiente para passar para o nível 2 de preços. Ao migrar para uma versão mais recente de uma API, você também vai receber uma cobrança por uma SKU diferente. Para evitar o aumento de custos durante o mês da sua 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ê atinja os níveis de preço mensais mais econômicos durante o mês da migração. Para mais informações sobre os níveis de preços, consulte a página de preços e as perguntas frequentes sobre preços.
Ativar a API Places (nova)
Para usar os recursos da API Places (nova), 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) à chave de API usada pelo app. Para mais informações, consulte Usar chaves de API.
Mudanças gerais
Algumas mudanças gerais que se aplicam a várias APIs incluem:
- Todas as novas APIs oferecem suporte a chaves de API e tokens OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta.
- A máscara de campo é necessária para Place Details (novo), Nearby Search (novo) e Text Search (novo) para especificar quais campos você quer que sejam retornados na resposta. Para mais informações, consulte FieldMask.
- As APIs Nearby Search (New) e Text Search (New) agora retornam todos os detalhes do lugar para corresponder aos detalhes retornados por Place Details (New).
- O formato da resposta JSON das APIs Place Details (New), Nearby Search (New) e Text Search (New) mudou em relação ao formato das APIs atuais. Para mais detalhes, consulte Migrar a resposta da API Places.
Mudanças específicas da API
Esta seção inclui os seguintes guias de migração para cada API: