Wybierz wersję pakietu SDK

pakietu Places SDK dla iOS, które są dostępne na aplikacje są określane na podstawie kombinacji numeru wersji pakietu SDK (np. 9.0.0), który określone w zależnościach pakietu i interfejsach API włączonych w kluczu interfejsu API. Z tego przewodnika dowiesz się, czym różnią się poszczególne wersje i jak wybrać jest włączona w Twojej 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 konkretnej wersji. Na przykład autouzupełnianie (nowość) jest dostępne tylko w pakiecie SDK wersji 9.0.0 lub nowszej.

Więcej informacji o zmianach wprowadzonych w poszczególnych wersjach pakietu SDK znajdziesz w sekcji Miejsca Informacje o wersji pakietu SDK na iOS

Wersje interfejsu Places API dla pakietu SDK Places na iOS

Oprócz określenia wersji pakietu SDK musisz też wybrać usługa interfejsu API wywoływana przez pakiet SDK w konsoli Google Cloud: interfejs Places API lub Places API (nowość). Wraz z numerem wersji pakietu SDK i usługą interfejsu API określa, która wersja określonych funkcji jest dostępna w aplikacji, takich jak Autouzupełnianie lub Autouzupełnianie (nowość). Możesz określić tylko jeden pakiet SDK. możesz włączyć zarówno interfejs Places API, jak i Places API (nowość), klucz interfejsu API. Jednak w większości przypadków warto włączyć Interfejs Places API (nowość) i korzystaj z nowych wersji funkcji pakietu SDK w swojej aplikacji.

Wybierz wersję pakietu SDK i usługi interfejsu API

Aby wybrać funkcje pakietu SDK dostępne w Twojej aplikacji:

  1. W projekcie Google Cloud włącz interfejs Places API, Places API (nowość) lub i jednym, i drugim. Więcej informacji znajdziesz w sekcji Włączanie Interfejsy API
  2. W ograniczeniach klucza interfejsu API włącz Places API, Places API (nowość) lub i jednym, i drugim. Więcej informacji znajdziesz w artykule o ograniczaniu interfejsu API .
  3. Podczas instalowania pakietu SDK podaj numer wersji. Aby dowiedzieć się więcej, Więcej informacji znajdziesz w artykule na temat konfigurowania projektu Xcode.

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

Funkcje pakietu SDK dostępne w poszczególnych wersjach

W tabeli poniżej pokazujemy, które wersje pakietu SDK i interfejsu API są wymagane w przypadku poszczególnych pakietów SDK cecha:

Funkcja Interfejs Places API został włączony w kluczu interfejsu API Minimalna wersja pakietu SDK
Autouzupełnianie (nowość) Places API (nowość) 9.0.0
Szczegóły miejsca (nowe) Places API (nowość) 9.0.0
Wyszukiwanie w pobliżu (nowość) Places API (nowość) 9.0.0
Zdjęcia miejsc (nowość) Places API (nowość) 9.0.0
Wyszukiwanie tekstowe (nowość) Places API (nowość) 8.5.0
Autouzupełnianie miejsc Places API 3.0.0
Aktualne miejsce Places API 3.0.0
Szczegóły miejsca Places API 3.0.0
Zdjęcia miejsc Places API 3.0.0

Uwagi dotyczące wyboru wersji do włączenia

  • Jeśli jesteś nowym klientem i dopiero zaczynasz korzystać z pakietu SDK Miejsc na iOS: użyj interfejsu Places API (nowego) i nowego pakietu SDK.
  • Jeśli jesteś obecnym klientem, możesz dalej korzystać z obecnego pakietu SDK. Jednak aby zacząć korzystać z udoskonaleń wydajności i funkcji ulepszeń pakietu SDK Miejsc dla systemu iOS (nowość), należy włączyć interfejs Places API (nowego) i użyj nowego pakietu SDK. W przypadku przejścia na nową wersję nie jest wymagana migracja nowego pakietu SDK, wykonaj czynności opisane w sekcji Wybór wersji pakietu SDK i interfejsu API usługi.
  • Interfejs Places API (nowość) nie włącza niektórych funkcje, takie jak Currents Miejsce GMSPlace.isOpen. oraz GMSPlaceisOpenAtDate

Korzystanie z wersji testowej GooglePlacesSwift

Aby korzystać z GooglePlacesSwift, należy wykonać te czynności:

  1. Włączanie interfejsu Places API (Nowość).
  2. Dodaj parametr GooglePlacesSwiftSDK do zależności.
  3. Zainicjuj klienta Miejsc za pomocą PlacesClient

Więcej informacji o GooglePlacesSwift znajdziesz w dokumentacji dokumentacji.

Migracja do nowych interfejsów API

Jeśli używasz istniejącego interfejsu API i chcesz przejść na nowy interfejs API, zapoznaj się z te przewodniki po migracji dla każdego interfejsu API:

Ulepszenia pakietu SDK Miejsc na iOS (nowość)

W tej sekcji omawiamy najważniejsze funkcje dodane do pakietu SDK Miejsc na iOS. (Nowość).

Wdrożony na standardowej platformie Google Cloud

W usłudze wdrożono pakiet SDK Miejsc na iOS (nowość) infrastruktura w Google Cloud. Ta implementacja zapewnia bezpieczniejszą i bezpieczniejszą platformę. Ta standardowa konstrukcja zapewnia pewien poziom spójności we wszystkich pakietach SDK, wydajność programowania z pakietem SDK Miejsc na iOS (Nowość).

Poprawiona wydajność

Pakiet Places SDK na iOS (nowość) podnosi wydajność, dzięki czemu warto zastąpić aplikacje korzystające z dotychczasowych pakietów SDK.

Nowe funkcje

Pakiet SDK Miejsc na iOS (nowy) zawiera najnowsze wersje wszystkie funkcje pakietu SDK:

Uproszczone ustalanie cen

W przypadku pakietu SDK Miejsc na iOS (nowego) cennik jest upraszczany, zapłacisz tylko za dane, których używasz. Uproszczone ustalanie cen jest implementowane za pomocą pola list nazywanych też maskami pola.

Pakiet SDK Miejsc na iOS i Wyszukiwanie tekstowe wykorzystuje listy pól do kontrolowania listy które mają być zwracane w odpowiedzi. Opłaty są naliczane tylko za te dane. poproszono o dostęp. Dobrą praktyką jest użycie listy pól, dzięki której żądać zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania opłaty rozliczeniowe.

Szczegółowe informacje o cenach obu pakietów SDK znajdziesz w artykule Korzystanie z Płatności.

Rozszerzone typy miejsc

Nowy pakiet SDK dodaje typy miejsc podane w tabeli poniżej. Te typy są zwracanych w ramach szczegółów miejsca, a Odpowiedź dotycząca wyszukiwania tekstowego. Możesz również używać nowych typów metod, i ich istniejących typów. Nowe typy zostały uwzględnione w tabeli O.

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

Oprócz tych nowych typów interfejs Places API (nowość) przeniósł następujące typy z tabeli 2 interfejsu Places API do tabeli A dla interfejsu Places API (nowego). Oznacza to, że możesz teraz korzystać z tych typów treści w ramach szukaj:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality