Funkcje pakietu Places SDK na iOS dostępne w Twojej aplikacji zależą od kombinacji numeru wersji pakietu SDK (np. 9.0.0) podanego w zależnościach pakietów z interfejsami API włączonymi w kluczu interfejsu API. Z tego przewodnika dowiesz się, czym różnią się poszczególne wersje i jak wybrać, które z nich mają być włączone 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 w konkretnej wersji. Na przykład nowe ustawienie autouzupełniania jest dostępne 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 informacjach o wersji pakietu SDK Miejsc na iOS.
Wersje interfejsu Places API dla pakietu SDK Places na iOS
Oprócz określenia numeru wersji pakietu SDK musisz też wybrać usługę Places API, którą SDK wywołuje w konsoli Google Cloud: Places API lub Places API (nową). Wybrana usługa interfejsu API wraz z numerem wersji pakietu SDK określa, która wersja określonych funkcji (np. Autouzupełnianie lub Autouzupełnianie (nowa) jest dostępna w aplikacji). Możesz określić tylko jeden numer wersji pakietu SDK, ale możesz jednocześnie włączyć w kluczu interfejsu Places API i Places API (nową) wersję. Jednak w większości przypadków warto włączyć interfejs Places API (nowość) i użyć (nowych) wersji funkcji pakietu SDK w aplikacji.
Wybierz wersję pakietu SDK i usługi interfejsu API
Aby wybrać funkcje pakietu SDK dostępne w Twojej aplikacji:
- W swoim projekcie Google Cloud włącz interfejs Places API, Places API (nowy) lub oba te interfejsy. Więcej informacji znajdziesz w artykule o włączaniu interfejsów API.
- W ograniczeniach klucza interfejsu API włącz Places API, Places API (nowy) lub oba te elementy. Więcej informacji znajdziesz w artykule na temat ograniczania kluczy interfejsu API.
- Podczas instalowania pakietu SDK podaj numer wersji. Więcej informacji znajdziesz w artykule o konfigurowaniu projektu Xcode.
Więcej informacji o wyborze usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.
Funkcje pakietu SDK dostępne w poszczególnych wersjach
W tabeli poniżej podano, które wersje pakietu SDK i interfejsu API są wymagane w przypadku poszczególnych funkcji pakietu SDK:
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, zacznij od nowego interfejsu Places API i nowego pakietu SDK.
- Jeśli jesteś obecnym klientem, możesz dalej korzystać z obecnego pakietu SDK. Aby jednak skorzystać z udoskonaleń pakietu Places SDK dla iOS (nowego) i udoskonalonych funkcji, należy włączyć interfejs Places API (nowość) i użyć nowego pakietu SDK. Przy przejściu na nowy pakiet SDK nie musisz przeprowadzać migracji. Wystarczy wykonać czynności opisane w artykule Wybieranie wersji pakietu SDK i usług interfejsu API.
- Interfejs Places API (nowość) nie włącza niektórych dotychczasowych funkcji, takich jak Bieżące miejsce,
GMSPlace.isOpen
czyGMSPlaceisOpenAtDate
.
Korzystanie z wersji testowej GooglePlacesSwift
Aby korzystać z GooglePlacesSwift, należy wykonać te czynności:
- Włącz Places API (nowość).
- Dodaj do zależności pakiet GooglePlacesSwiftSDK.
- Zainicjuj klienta Miejsc przy użyciu polecenia
PlacesClient
.
Więcej informacji o GooglePlacesSwift znajdziesz w dokumentacji referencyjnej.
Migracja do nowych interfejsów API
Jeśli używasz dotychczasowego interfejsu API i chcesz przejść na nowy, zapoznaj się z poniższymi przewodnikami po migracji dotyczącymi każdego z nich:
- Migracja do szczegółów miejsca (nowość)
- Migracja do zdjęcia miejsca (nowość)
- Migracja do autouzupełniania (nowość)
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
Pakiet Places SDK na iOS (nowość) został zaimplementowany w infrastrukturze usług Google Cloud. Ta implementacja zapewnia bezpieczniejszą i bezpieczniejszą platformę. Ten standardowy wygląd zapewnia pewien poziom spójności między pakietami SDK, co zwiększa wydajność programowania przy użyciu pakietu Places SDK na iOS (nowość).
Poprawiona wydajność
Pakiet Places SDK na iOS (nowość) zapewnia większą wydajność, dlatego warto zastąpić aplikacje, które korzystają z dotychczasowego pakietu SDK.
Nowe funkcje
Pakiet Places SDK na iOS (nowość) zawiera najnowsze wersje wszystkich funkcji pakietu SDK:
- Autouzupełnianie (nowość)
- Szczegóły miejsca (nowe)
- Wyszukiwanie w pobliżu (nowość)
- Zdjęcia miejsc (nowość)
- Wyszukiwanie tekstowe (nowość)
Uproszczone ustalanie cen
W przypadku pakietu SDK Miejsc na iOS (nowego) cennik jest upraszczany, dzięki czemu płacisz tylko za dane, z których korzystasz. Uproszczone ceny są implementowane za pomocą list pól, nazywanych też maskimi pól.
W przypadku pakietu Places SDK na iOS i wyszukiwania tekstowego możesz korzystać z list pól do kontrolowania listy pól, które mają zwrócić w odpowiedzi. Opłaty są naliczane tylko za dane, których dotyczy żądanie. Korzystanie z listy pól to sprawdzona metoda projektowania, dzięki której nie żądasz zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat.
Szczegółowe informacje o cenach obu pakietów SDK znajdziesz w artykule Korzystanie i rozliczenia.
Rozszerzone typy miejsc
Nowy pakiet SDK dodaje typy miejsc podane w tabeli poniżej. Te typy są zwracane w odpowiedziach „Szczegóły miejsca” i „Wyszukiwanie tekstowe”. Tych nowych i dotychczasowych typów możesz też używać w wyszukiwaniu tekstowym. Nowe typy zostały uwzględnione 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 | targ | 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 w przypadku interfejsu Places API do tabeli A dla interfejsu Places API (nowego). Oznacza to, że w ramach wyszukiwania możesz teraz korzystać z następujących typów:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality