Os recursos do SDK do Places para iOS disponíveis no seu app são determinados por uma combinação do número da versão do SDK (por exemplo, 9.0.0) que você especifica nas dependências do pacote e as APIs ativadas na chave de API. Este guia explica as diferenças entre as versões e como selecionar quais versões são ativadas no app.
Números de versão do SDK
O número da versão do SDK especificado nas dependências de pacote determina se o app tem acesso a recursos adicionados em uma versão específica. Por exemplo, a Autocompletar (Nova) só está disponível no SDK versão 9.0.0 ou mais recente.
Para mais informações sobre as mudanças introduzidas em cada versão do SDK, consulte as Notas da versão do SDK do Places para iOS.
Versões da API Places para o SDK do Places para iOS
Além de especificar um número de versão do SDK, você também precisa selecionar o serviço da API Places que o SDK chama no Console do Google Cloud: API Places ou API Places (nova). Junto com o número da versão do SDK, o serviço de API selecionado determina qual versão de recursos específicos está disponível no app, como o Autocompletar ou o Autocompletar (Novo). Embora você só possa especificar um número de versão do SDK, é possível ativar a API Places e a API Places (nova) na chave de API ao mesmo tempo. No entanto, na maioria dos casos, é recomendável ativar a API Places (nova) e usar as versões (novas) dos recursos do SDK no app.
Selecionar a versão do SDK e os serviços da API
Para selecionar quais recursos do SDK estão disponíveis no app, faça o seguinte:
- No projeto do Google Cloud, ative a API Places, a API Places (nova) ou ambas. Para mais informações, consulte Ativar APIs.
- Nas restrições da chave de API, ative a API Places, a API Places (nova) ou ambas. Para mais informações, consulte Como restringir chaves de API.
- Ao instalar o SDK, especifique o número da versão. Para mais informações, consulte Configurar um projeto do Xcode.
Para mais informações sobre como selecionar o serviço da API Places, consulte Configurar seu projeto do Google Cloud.
Recursos do SDK disponíveis em cada versão
A tabela a seguir mostra quais versões do SDK e da API são necessárias para cada recurso do SDK:
| SDK do Places para iOS (novo) | Versão mínima do SDK | SDK do Places para iOS | Versão mínima do SDK |
|---|---|---|---|
| Detalhes do lugar (novo) | 9.0.0 | Detalhes do lugar | 3.0.0 |
| Place Photo (novo) | 9.0.0 | Place Photo | 3.0.0 |
| Pesquisa de texto (nova) | 8.5.0 | ||
| Pesquisa por proximidade (novo) | 9.0.0 | ||
| Preenchimento automático (novo) | 9.0.0 | Preenchimento automático | 3.0.0 |
| Current Place | 3.0.0 |
Considerações para escolher quais versões ativar
- Se você é um cliente novo que está começando a usar o SDK do Places para iOS, comece com a API Places (nova) e o novo SDK.
- Se você já é cliente, pode continuar usando o SDK atual. No entanto, para aproveitar as melhorias de desempenho e os aprimoramentos de recursos do SDK do Places para iOS (novo), ative a API Places (nova) e use o novo SDK. Não é necessário migrar para o novo SDK. Basta seguir as etapas em Selecionar a versão do SDK e os serviços de API.
- A API Places (nova) não ativa alguns recursos
existentes, como Current
Place,
GMSPlace.isOpeneGMSPlace.isOpenAtDate.
Usar o SDK do Places Swift para iOS (pré-lançamento)
As etapas a seguir são necessárias para usar o SDK do Places Swift para iOS (pré-lançamento):
- Ative a API Places (nova).
- Adicione o SDK do Places Swift para iOS (pré-lançamento) às suas dependências.
- Inicialize o cliente do Places com
PlacesClient.
Para saber mais sobre o SDK do Places Swift para iOS (pré-lançamento), consulte a visão geral ou o guia de migração.
Migrar para as novas APIs
Se você estiver usando uma API e quiser migrar para a nova, consulte os seguintes guias de migração para cada uma delas:
- Migrar para o Place Details (novo)
- Migrar para o Place Photo (novo)
- Migrar para o preenchimento automático (novo)
Melhorias no SDK do Places para iOS (novo)
Esta seção aborda os principais recursos adicionados ao SDK do Places para iOS (novo).
Implementado na plataforma padrão do Google Cloud
O SDK do Places para iOS (novo) é implementado na infraestrutura do serviço no Google Cloud. Essa implementação oferece uma plataforma mais segura e confiável. Esse design padrão traz um nível de consistência entre os SDKs que melhoram a eficiência do desenvolvimento com o SDK do Places para iOS (novo).
Desempenho aprimorado
O SDK do Places para iOS (novo) oferece melhor desempenho, o que torna a substituição de apps que usam o SDK atual mais vantajosa.
Novos recursos
O SDK do Places para iOS (novo) inclui as versões mais recentes de todos os recursos do SDK:
- Preenchimento automático (novo)
- Detalhes do lugar (novo)
- Pesquisa por proximidade (novo)
- Place Photos (novo)
- Pesquisa de texto (nova)
Precificação simplificada
O preço é simplificado com o SDK do Places para iOS (novo), para que você pague apenas pelos dados que usar. O preço simplificado é implementado usando listas de campos, também chamadas de máscaras de campo.
Com o SDK do Places para iOS e a Pesquisa de texto, você usa listas de campos para controlar a lista de campos a serem retornados na resposta. A cobrança é feita apenas pelos dados solicitados. Usar uma lista de campos é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar tempo de processamento e cobranças.
Para informações detalhadas sobre os preços dos dois SDKs, consulte Uso e faturamento.
Tipos de lugar expandidos
O novo SDK adiciona os tipos de lugar mostrados na tabela a seguir. Esses tipos são retornados como parte da resposta de Place Details e Text Search. Você também pode usar esses novos tipos e os tipos atuais em uma pesquisa com a Pesquisa de texto. Os novos tipos estão incluídos na Tabela A.
| Tipo | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | fazenda | korean_restaurant | sporting_goods_store |
| barber_shop | Hotel-fazenda | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | mercado | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | alfaiate |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| consultor | heliporto | playground | vegetarian_restaurant |
| convention_center | hiking_area | pré-escola | vietnamese_restaurant |
| casa de campo | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | albergue | resort_hotel | atacadista |
| dental_clinic | hotel | rest_stop |
Além desses novos tipos, a API Places (nova) mudou os seguintes tipos da Tabela 2 para a Tabela A. Isso significa que agora você pode usar estes tipos como parte de uma pesquisa:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality