Visão geral da migração

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

Use este guia para entender as principais diferenças no SDK do Places para iOS (novo) em comparação com 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

Essa orientação se aplica se o uso da API for alto o suficiente para passar para o nível 2 de preços. Ao migrar para uma versão mais recente de uma API, você também vai receber uma cobrança por uma SKU diferente. Para evitar o aumento de custos durante o mês da sua 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ê atinja os níveis de preço mensais mais econômicos durante o mês de migração. Para mais informações sobre os níveis de preços, consulte a página de preços e as Perguntas frequentes sobre preços.

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 seu 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).

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

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

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

  • A instância GMSPlace da resposta 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 mostrar 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: