Introdução
A API Places (nova) oferece melhor performance e um novo modelo de preços, o que torna a atualização de apps que usam a API Places (legada) uma boa ideia. 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 (legada), 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 será cobrado 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 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 na nuvem do Google Cloud. Para mais informações, consulte Configurar seu projeto do Google Cloud project.
Em seguida, adicione 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 aceitam chaves de API e OAuth como mecanismo de autenticação.
- Apenas JSON é aceito como formato de resposta.
- A máscara de campo é exigida pela API Place Details (nova), Nearby Search (nova) e Text Search (nova) para especificar quais campos você quer que sejam retornados na resposta. Para mais informações, consulte FieldMask.
- As APIs Nearby Search (nova) e Text Search (nova) agora retornam os detalhes completos do lugar para corresponder aos detalhes retornados por Place Details (nova).
- O formato de resposta JSON das APIs Place Details (nova), Nearby Search (nova), e Text Search (nova) 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:
- Migrar para a API Nearby Search (nova)
- Migrar para a API Text Search (nova)
- Migrar para a API Place Details (nova)
- Migrar para a API Place Photos (nova)
- Migrar para a API Autocomplete (nova)