A API Places (nova) apresenta uma performance aprimorada e um novo modelo de preços. Assim, vale a pena atualizar os apps que usam a API Places. 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.
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.
Depois, verifique se adicionou a API Places (nova) à chave de API usada pelo app. Para saber mais, consulte Usar chaves de API.
Mudanças gerais
Estas são algumas mudanças gerais que se aplicam a várias APIs:
- Todas as APIs novas aceitam as chaves de API e tokens do OAuth como mecanismo de autenticação.
- Somente JSON é aceito como formato de resposta.
- O mascaramento de campo é exigido pelo Place Details (novo), Nearby Search (New) e Text Search (New) para especificar quais campos você quer retornar na resposta. Para mais informações, consulte FieldMask.
- As APIs Nearby Search (New) e Text Search (New) agora retornam os detalhes completos do lugar para corresponder aos detalhes retornados pelo Place Details (New).
- O formato de resposta JSON para as APIs Place Details (New), Nearby Search (New) e Text Search (New) mudou do formato das APIs existentes. Para mais detalhes, consulte Migrar a resposta da API Places.
Mudanças específicas de APIs
Esta seção inclui os seguintes guias de migração para cada API: