Introdução
A API Places (nova) oferece melhor performance e um novo modelo de preços, o que torna interessante atualizar os apps que usam a API Places (legada). 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 recebe cobranças 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 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 seu 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.
- Apenas JSON é aceito como formato de resposta.
- O mascaramento de campo é obrigatório 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 (novo) e Text Search (novo) agora retornam os detalhes completos do lugar para corresponder aos detalhes retornados pelo Place Details (novo).
- O formato de 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:
- Migrar para a Pesquisa nas proximidades (novo)
- Migrar para a pesquisa de texto (novo)
- Migrar para o Place Details (novo)
- Migrar para o Place Photos (novo)
- Migrar para o preenchimento automático (novo)