A API Places (nova) oferece melhor desempenho e um novo modelo de preços. Assim, vale a pena atualizar os apps que usam essa API. Para ver 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 e saber como lidar com as mudanças necessárias.
Ativar 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 são compatíveis com chaves de API e tokens OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta.
- O mascaramento de campo é exigido por Place Details (novo), Nearby Search (novo) e Text Search (novo) para especificar quais campos você quer retornar na resposta. Para mais informações, consulte FieldMask.
- As APIs Nearby Search (novo) e Text Search (novo) agora retornam todos os detalhes do lugar para corresponder aos detalhes retornados por Place Details (novo).
- O formato de resposta JSON para as APIs Place Details (novo), Nearby Search (novo) e Text Search (novo) foi alterado do formato das APIs atuais. Se quiser 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: