A versão 8.5.0 do SDK do Places para iOS é compatível com duas versões: SDK do Places para iOS é o atual SDK do Places para iOS (novo) e é a versão de última geração do SDK.
Com o lançamento da versão 8.5.0 do SDK do Places para iOS, sua primeira tarefa é decidir qual SDK usar. Isso é válido se você é um cliente novo ou atual que já usa o SDK. Use este guia para entender as principais diferenças entre os dois SDKs.
Como selecionar a versão do SDK
O SDK do Places para iOS depende do serviço da API Places. Antes de usar o SDK do Places para iOS, ative o serviço da API Places no seu projeto do Google Cloud.
A versão do serviço da API Places ativada controla a versão do SDK usada pelo app:
API Places: ativa o SDK do Places para iOS. Se apenas a API Places estiver ativada no projeto associado à chave de API usada no seu app, ele não vai ter acesso aos novos recursos adicionados no SDK do Places para iOS versão 8.5.0 e mais recentes.
API Places (nova): ativa o SDK do Places para iOS (novo), incluindo Pesquisa de texto e todos os novos recursos descritos em Principais recursos adicionados ao SDK do Places para iOS (novo). Não ativa recursos atuais, como Place Details, Place Photos, Current Place e Place Autocomplete.
Ambos: ativa todos os recursos do SDK do Places para iOS (novo) e do SDK do Places para iOS.
Para mais informações sobre como selecionar o serviço da API Places, consulte Configurar seu projeto do Google Cloud.
Qual SDK você deve escolher?
Para ajudar a decidir qual versão escolher:
Se você é um novo cliente e está começando a usar o SDK do Places para iOS, comece com a API Places (nova) e a API Places para ter acesso a todos os recursos.
Se você for um cliente atual, poderá continuar usando o SDK atual. No entanto, se quiser aproveitar as melhorias de performance e os recursos do SDK do Places para iOS (novo), use o novo SDK.
Não é necessário migrar para o novo SDK. Você só precisa ativar o SDK do Places para iOS (novo) na chave de API usada no seu app. Se você usa o SDK do Places para iOS e o SDK do Places para iOS (novo), ative as duas versões na chave de API. Para mais informações, consulte Usar chaves de API.
Principais recursos adicionados ao 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 de serviços 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, o que melhora a eficiência de desenvolvimento com o SDK do Places para iOS (novo).
Tem desempenho aprimorado
O SDK do Places para iOS (novo) oferece um desempenho aprimorado, fazendo com que vale a pena substituir apps que usam o SDK existente.
Novo serviço Text Search
A Pesquisa por texto retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo", "loja de sapatos perto do Rio de Janeiro" ou "Avenida Brasil, 123". O serviço responde com uma lista de lugares correspondentes à string de texto e a todos os direcionamentos de localização definidos.
Preços simplificados
Os preços foram simplificados com o SDK do Places para iOS (novo), assim você paga apenas pelos dados que usar. O preço simplificado é implementado usando listas de campo, também chamadas de máscaras de campo.
Com o SDK do Places para iOS e o Text Search, você usa listas de campos para controlar a lista de campos a serem retornados na resposta. Você só será cobrado 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 cobranças de faturamento e tempo de processamento desnecessários.
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 já 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 | heliporto | playground | 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 |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality