Wybierz wersję pakietu SDK

Funkcje pakietu SDK do Places na iOS, które są dostępne w aplikacji, zależą od kombinacji numeru wersji pakietu SDK (np. 9.0.0), który określasz w zależnościach pakietu, oraz interfejsów API włączonych za pomocą klucza API. W tym przewodniku opisujemy różnice między wersjami i wyjaśniamy, jak wybrać wersje, które mają być włączone w aplikacji.

Numery wersji pakietu SDK

Numer wersji pakietu SDK określony w zależnościach pakietu określa, czy aplikacja ma dostęp do funkcji dodanych w konkretnej wersji. Na przykład funkcja Autouzupełnianie (nowa) jest dostępna tylko w pakiecie SDK w wersji 9.0.0 lub nowszej.

Więcej informacji o zmianach wprowadzonych w poszczególnych wersjach pakietu SDK znajdziesz w notatkach o wersjach pakietu SDK do usługi Places na iOS.

Wersje interfejsu Places API w pakiecie Places SDK na iOS

Oprócz podania numeru wersji pakietu SDK musisz też wybrać usługę interfejsu Places API, którą wywołuje pakiet SDK w Konsoli Google Cloud: Places API lub Places API (nowy). Wybrana przez Ciebie usługa interfejsu API wraz z numerem wersji pakietu SDK określa, która wersja poszczególnych funkcji jest dostępna w aplikacji, np. autouzupełnianie lub autouzupełnianie (nowa wersja). Chociaż możesz określić tylko jedną wersję pakietu SDK, możesz jednocześnie włączyć interfejsy API Places API i Places API (nowy) za pomocą klucza API. W większości przypadków warto jednak włączyć interfejs Places API (nowy) i korzystać w aplikacji z funkcji pakietu SDK (nowej wersji).

Wybierz wersję pakietu SDK i usługi interfejsu API

Aby wybrać funkcje pakietu SDK, które mają być dostępne w aplikacji:

  1. W projekcie Google Cloud włącz interfejs Places API, Places API (New) lub oba te interfejsy. Więcej informacji znajdziesz w artykule Włączanie interfejsów API.
  2. W ograniczeniach klucza interfejsu API włącz interfejs Places API, interfejs Places API (nowy) lub oba te interfejsy. Więcej informacji znajdziesz w artykule Ograniczanie dostępu do kluczy API.
  3. Podczas instalowania pakietu SDK określ jego numer wersji. Więcej informacji znajdziesz w artykule Konfigurowanie projektu Xcode.

Więcej informacji o wybieraniu usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.

Funkcje pakietu SDK dostępne w poszczególnych wersjach

W poniższej tabeli znajdziesz informacje o tym, których wersji pakietu SDK i wersji interfejsu API wymaga dana funkcja pakietu SDK:

Pakiet SDK Miejsc na iOS (nowy) Minimalna wersja pakietu SDK Pakiet SDK Miejsc na iOS Minimalna wersja pakietu SDK
Szczegóły miejsca (nowa) 9.0.0 Szczegóły miejsca 3.0.0
Place Photo (New) 9.0.0 Place Photo 3.0.0
Wyszukiwanie tekstu (nowa funkcja) 8.5.0
Wyszukiwanie w pobliżu (nowość) 9.0.0
Autouzupełnianie (nowa wersja) 9.0.0 Autouzupełnianie 3.0.0
Aktualne miejsce 3.0.0

Uwagi dotyczące wyboru wersji do włączenia

  • Jeśli jesteś nowym klientem i zaczynasz dopiero korzystać z pakietu Places SDK na iOS, zacznij od interfejsu Places API (nowy) i nowego pakietu SDK.
  • Jeśli jesteś obecnym klientem, możesz nadal używać dotychczasowego pakietu SDK. Aby jednak korzystać z ulepszonego działania i funkcji pakietu Places SDK na iOS (nowy), musisz włączyć interfejs Places API (nowy) i używać nowego pakietu SDK. Przejście na nowy pakiet SDK nie wymaga migracji. Wystarczy, że wykonasz czynności opisane w artykule Wybieranie wersji pakietu SDK i usług API.
  • Interfejs Places API (New) nie umożliwia korzystania z niektórych funkcji, takich jak Current Place (GMSPlace.isOpen) i GMSPlace.isOpenAtDate.

Korzystanie z pakietu SDK Miejsca Swift na iOS (wersja podglądowa)

Aby korzystać z pakietu SDK Miejsca Swift na iOS (wersja podglądowa), wykonaj te czynności:

  1. Włącz Places API (nowość).
  2. Dodaj pakiet Places Swift SDK na iOS (wersja podglądowa) do swoich zależności.
  3. Zainicjuj klienta Places za pomocą funkcji PlacesClient.

Aby dowiedzieć się więcej o pakiecie Places Swift SDK na iOS (wersja w podglądzie), zapoznaj się z omówieniem lub przewodnikiem po migracji.

Migracja do nowych interfejsów API

Jeśli korzystasz z dotychczasowego interfejsu API i chcesz przejść na nowy, zapoznaj się z tymi przewodnikami dotyczącymi migracji:

Ulepszenia w pakiecie SDK Miejsc na iOS (nowość)

W tej sekcji omówiono najważniejsze funkcje dodane do pakietu SDK Miejsca na iOS (nowość).

Wdrożone na platformie standardowej Google Cloud

Pakiet SDK Miejsc na iOS (nowy) jest implementowany w infrastrukturze usługi w Google Cloud. Dzięki temu wdrożeniu platforma jest bezpieczniejsza i bardziej zaufana. Ta standardowa konstrukcja zapewnia spójność pakietów SDK, co zwiększa efektywność tworzenia aplikacji za pomocą pakietu SDK Miejsc na iOS (nowy).

Poprawiona wydajność

Pakiet SDK Miejsc na iOS (nowy) zapewnia lepszą wydajność, dlatego warto zastąpić nim aplikacje korzystające z dotychczasowego pakietu SDK.

Nowe funkcje

Pakiet SDK Miejsca na iOS (nowy) zawiera najnowsze wersje wszystkich funkcji pakietu SDK:

Uproszczone ustalanie cen

W nowym pakiecie Places SDK na iOS uprościliśmy cennik, aby płacić tylko za dane, których używasz. Uproszczone ustalanie cen jest wdrażane za pomocą list pól, zwanych też maskami pól.

W pakiecie SDK Miejsc na iOS i w wyszukiwaniu tekstowym używasz list pól, aby kontrolować listę pól zwracanych w odpowiedzi. Następnie naliczymy opłatę tylko za żądane dane. Korzystanie z listy pól to dobra praktyka projektowania, która pozwala uniknąć żądania niepotrzebnych danych, co pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

Szczegółowe informacje o cenach obu pakietów SDK znajdziesz w sekcji Wykorzystanie i rozliczenia.

Rozszerzone typy miejsc

Nowy pakiet SDK dodaje typy miejsc widoczne w tabeli poniżej. Te typy są zwracane w ramach odpowiedzi na zapytanie dotyczące szczegółów miejsca i wyszukiwania tekstowego. Z nowych typów, a także z dotychczasowych, możesz też korzystać w wyszukiwaniu tekstowym. Nowe typy znajdują się w tabeli A.

Typ
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 gospodarstwo rolne korean_restaurant sporting_goods_store
barber_shop agroturystyka lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal market steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant krawiec
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
konsultant heliport plac zabaw vegetarian_restaurant
convention_center hiking_area przedszkole vietnamese_restaurant
chata historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center hostel resort_hotel hurtownia
dental_clinic hotel rest_stop

Wraz z tymi nowymi typami interfejs Places API (New) przeniósł te typy z tabeli 2 interfejsu Places API do tabeli A interfejsu Places API (New). Oznacza to, że możesz teraz używać tych typów w ramach wyszukiwania:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality