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) especificado nas dependências do pacote e das APIs ativadas na chave de API. Neste guia, explicamos as diferenças entre as versões e como selecionar quais versões estão ativadas no app.
Números de versão do SDK
O número da versão do SDK especificado nas dependências do pacote determina se o app tem acesso aos recursos adicionados em uma versão específica. Por exemplo, o Autocomplete (novo) só está disponível na versão 9.0.0 ou mais recente do SDK.
Para mais informações sobre as mudanças feitas 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: a API Places ou a API Places (nova). Junto com o número da versão do SDK, o serviço de API que você seleciona determina qual versão de recursos específicos estão disponíveis no app, como Autocomplete ou Autocomplete (novo). Embora você possa especificar apenas um número de versão do SDK, você pode ativar a API Places e a API Places (nova) na sua chave de API ao mesmo tempo. No entanto, na maioria dos casos, convém ativar a API Places (nova) e usar as versões (nova) dos recursos do SDK no seu app.
Selecione a versão do SDK e os serviços da API
Para selecionar os recursos do SDK 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 saber mais, 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:
Engenharia de | API Places ativada na chave de API | Versão mínima do SDK |
---|---|---|
Autocomplete (novo) | API Places (nova) | 9.0.0 |
Place Details (novo) | API Places (nova) | 9.0.0 |
Nearby Search (novo) | API Places (nova) | 9.0.0 |
Place Photos (novo) | API Places (nova) | 9.0.0 |
Text Search (novo) | API Places (nova) | 8.5.0 |
Place Autocomplete | API Places | 3.0.0 |
Current Place | API Places | 3.0.0 |
Place Details | API Places | 3.0.0 |
Place Photos (em inglês) | API Places | 3.0.0 |
Considerações para escolher quais versões ativar
- Se você é um novo cliente e está começando a usar o SDK do Places para iOS, comece com a API Places (nova) e o novo SDK.
- Se você já for cliente, poderá continuar usando o SDK atual. No entanto, para aproveitar as melhorias de desempenho e 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 da API.
- A API Places (nova) não ativa alguns recursos atuais, como o Current Place,
GMSPlace.isOpen
eGMSPlaceisOpenAtDate
.
Usar a versão de pré-lançamento do GooglePlacesSwift
As etapas a seguir são necessárias para usar o GooglePlacesSwift:
- Ative a API Places (nova).
- Adicione o GooglePlacesSwiftSDK às dependências.
- Inicialize o cliente do Places com
PlacesClient
.
Para saber mais sobre o GooglePlacesSwift, consulte a documentação de referência.
Migrar para as novas APIs
Se você estiver usando uma API existente e quiser migrar para a nova, consulte os seguintes guias de migração para cada API:
- Migrar para o Place Details (novo)
- Migrar para o Place Photo (novo)
- Migrar para o Autocomplete (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) está implementado na infraestrutura de serviços no Google Cloud. Essa implementação traz uma plataforma mais segura e confiável. Esse design padrão traz um nível de consistência para os SDKs, o que melhora a eficiência do desenvolvimento com o SDK do Places para iOS (novo).
Tem desempenho aprimorado
O SDK do Places para iOS (novo) melhora o desempenho, então vale a pena substituir os apps que usam o SDK atual.
Novos recursos
O SDK do Places para iOS (novo) inclui as versões mais recentes de todos os recursos do SDK:
- Autocomplete (novo)
- Place Details (novo)
- Nearby Search (novo)
- Place Photos (novo)
- Text Search (novo)
Preços simplificados
Os preços foram simplificados com o SDK do Places para iOS (novo), para que você pague apenas pelos dados que usar. A precificação simplificado é implementada 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. Você será cobrado apenas pelos dados solicitados. O uso de uma lista de campos é uma boa prática de design para garantir que você não solicite dados desnecessários. Isso ajuda a evitar cobranças desnecessárias no tempo de processamento e nas cobranças.
Para informações detalhadas sobre preços de ambos os 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 do Place Details e do Text Search. Você também pode usar esses novos tipos e os tipos existentes em uma pesquisa com o Text Search. 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 | Heliport | para playgrounds. | vegetarian_restaurant |
convention_center | hiking_area | pré-escolar | 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 |
Junto com esses novos tipos, a API Places (nova) moveu os tipos a seguir da Tabela 2 para a API Places para a tabela A na API Places (novo). Isso significa que agora você pode usar esses tipos como parte de uma pesquisa:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality