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.
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 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 de resposta JSON para as APIs Place Details (novo), Nearby Search (novo) e Text Search (novo) foi alterado do 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: