Escolha a versão do SDK

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 especificado nas dependências do pacote e nas APIs ativadas na chave de API. Neste guia, explicamos as diferenças entre as versões e como selecionar qual delas 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 que foram adicionados a uma versão específica. Por exemplo, o Autocomplete (novo) só está disponível no SDK versão 9.0.0 ou superior.

Para mais informações sobre as alterações introduzidas em cada versão do SDK, consulte a página do Notas da versão do SDK 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, também é preciso selecionar a API Places serviço da API que o SDK chama no console do Google Cloud: a API Places ou API Places (nova). Junto com o número da versão do SDK, o serviço de API que você select determina qual versão de recursos específicos estão disponíveis no aplicativo, como Autocomplete ou Autocomplete (novo). Embora só seja possível especificar um SDK você poderá ativar a API Places e a API Places (nova) no seu e a chave de API ao mesmo tempo. No entanto, na maioria dos casos, você vai querer ativar o API Places (nova) e use as versões (novas) 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:

  1. No projeto do Google Cloud, ative a API Places, a API Places (nova) ou os dois. Para mais informações, consulte Ativar APIs
  2. Nas restrições da chave de API, ative a API Places, a API Places (nova) ou os dois. Para mais informações, consulte Como restringir a API chaves.
  3. 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 sua 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 SDK Atributo:

Recurso 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, então: 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 as melhorias do SDK do Places para iOS (novo), ative a API Places (novo) e use o novo SDK. Não há necessidade de migração ao migrar para o novo SDK, basta seguir as etapas em Selecionar a versão do SDK e a API e serviços.
  • A API Places (nova) não ativa alguns recursos como o Atualidades Place, GMSPlace.isOpen e GMSPlaceisOpenAtDate

Usar a versão de pré-lançamento do GooglePlacesSwift

As etapas a seguir são necessárias para usar o GooglePlacesSwift:

  1. Ative a API Places (Novo).
  2. Adicione o método GooglePlacesSwiftSDK às dependências.
  3. Inicializar o cliente Places com PlacesClient

Para saber mais sobre o GooglePlacesSwift, consulte a referência Documentação.

Migrar para as novas APIs

Se você estiver usando uma API existente e quiser migrar para a nova, consulte guias de migração a seguir para cada API:

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 no serviço infraestrutura 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 entre os SDKs, o que melhora a eficiência do desenvolvimento com o SDK do Places para iOS (novo).

Desempenho aprimorado

O SDK do Places para iOS (novo) tem melhor desempenho, tornando vale a pena substituir os aplicativos que usam o SDK existente.

Novos recursos

O SDK do Places para iOS (novo) inclui as versões mais recentes do todos os recursos do SDK:

Preços simplificados

Os preços foram simplificados com o SDK do Places para iOS (novo) para que você só paga pelos dados que usa. O preço simplificado é implementado usando campos também chamadas de máscaras de campo.

Com o SDK do Places para iOS e Text Search você usa listas de campos para controlar a lista de para retornar na resposta. Você será cobrado apenas pelos dados solicitado. Usar uma lista de campos é uma boa prática de design para garantir que você não solicitar dados desnecessários, o que ajuda a evitar tempo de processamento desnecessário e cobranças de faturamento adicionais.

Para obter 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 dos Place Details e Resposta do Text Search. Você também pode usar esses novos tipos, e os tipos existentes em uma pesquisa com Text Search. Os novos tipos estão incluídos na Tabela R:

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 da API Places (nova). Isso significa que agora você pode usar esses tipos como parte de uma pesquisar:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality