Visão geral da migração

O SDK do Places para iOS (novo) oferece melhor desempenho e um novo modelo de preços, o que torna interessante atualizar os apps que usam o SDK do Places para iOS (legado). Para mais detalhes sobre a comparação de recursos, consulte Escolher seu SDK.

Use este guia para entender as principais diferenças entre o SDK do Places para iOS (novo) e o SDK do Places para iOS (legado), 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.

Erro: kGMSPlacesRateLimitExceeded

Ativar o SDK do Places para iOS (novo)

O SDK do Places para iOS depende do serviço da API Places. Para usar os recursos do SDK do Places para iOS (novo), 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:

  • Usa um novo modelo de preços. Para informações de preços de todas as APIs, consulte Preços do SDK do Places para iOS (novo).

  • O Place Details (novo), o Nearby Search (novo) e o Text Search (novo) exigem máscaras de campo para especificar quais campos você quer que sejam retornados na resposta.

  • O GMSPlacesClient contém novos métodos para chamar essas novas APIs.

  • Novas classes foram adicionadas para definir a solicitação de cada uma das novas APIs.

  • A instância de resposta GMSPlace contém a nova propriedade reviews do tipo GMSPlaceReview. Quando o app mostra informações obtidas da instância GMSPlace, como fotos e avaliações, ele também precisa exibir as atribuições necessárias.

    Para mais informações, consulte a documentação sobre atribuições.

Mudanças específicas da API

Esta seção inclui os seguintes guias de migração para cada API: