Wybierz wersję pakietu SDK

Pakiet SDK Miejsc na iOS w wersji 8.5.0 obsługuje 2 wersje pakietu SDK: Places SDK na iOS to istniejący Pakiet SDK Miejsc na iOS (nowy) to nowa wersja pakietu SDK.

Po udostępnieniu pakietu Places SDK dla iOS w wersji 8.5.0 Twoim pierwszym zadaniem jest wybór odpowiedniego pakietu SDK. Dotyczy to zarówno nowych, jak i dotychczasowych klientów, którzy korzystają już z pakietu SDK. Z tego przewodnika dowiesz się, jakie są główne różnice między tymi dwoma pakietami SDK.

Jak wybrać wersję pakietu SDK

Pakiet SDK Miejsc na iOS korzysta z usługi Places API. Aby korzystać z pakietu SDK Miejsc na iOS, musisz włączyć usługę Places API w projekcie Google Cloud.

Wersja interfejsu Places API, która jest włączona, kontroluje wersję pakietu SDK używaną przez Twoją aplikację:

  • Places API: włącza istniejący pakiet SDK Miejsc na iOS. Jeśli w projekcie powiązanym z kluczem interfejsu API używanym w Twojej aplikacji włączony jest tylko interfejs Places API, nie będzie ona miała dostępu do nowych funkcji dodanych w pakiecie Places SDK na iOS w wersji 8.5.0 i nowszych.

  • Places API (nowość): włącza pakiet SDK Miejsc na iOS (nowy), w tym wyszukiwarkę tekstową oraz wszystkie nowe funkcje opisane w sekcji Kluczowe funkcje dodane do pakietu Places SDK na iOS (nowość). Nie włącza istniejących funkcji, takich jak Szczegóły miejsca, Zdjęcia miejsca, Bieżące miejsce i Autouzupełnianie miejsc.

  • Oba: włącza wszystkie funkcje zarówno pakietu Places SDK na iOS (nowość), jak i pakietu Places SDK na iOS.

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

Który pakiet SDK wybierasz?

Aby zdecydować, którą wersję wybrać:

  1. Jeśli jesteś nowym klientem, który dopiero zaczynasz korzystać z pakietu SDK Miejsc na iOS, zacznij od interfejsu Places API (nowego) i interfejsu Places API, aby mieć dostęp do wszystkich funkcji.

  2. Jeśli jesteś obecnym klientem, możesz nadal korzystać z dotychczasowego pakietu SDK. Aby jednak korzystać z ulepszonej wydajności i ulepszonego pakietu SDK Miejsc na iOS, możesz użyć nowego pakietu SDK.

    Przejście na nowy pakiet SDK nie wymaga żadnej migracji. Musisz tylko włączyć pakiet Places SDK na iOS (nowość) w kluczu interfejsu API używanym w Twojej aplikacji. Jeśli używasz zarówno pakietu Places SDK na iOS, jak i pakietu SDK Miejsc na iOS (nowość), włącz obie wersje w kluczu interfejsu API. Więcej informacji znajdziesz w artykule o korzystaniu z kluczy interfejsu API.

Najważniejsze funkcje dodane do pakietu Places SDK na iOS (nowość)

W tej sekcji omawiamy kluczowe funkcje dodane do pakietu SDK Miejsc na iOS (nowość).

Wdrożone na standardowej platformie Google Cloud

Pakiet SDK Miejsc na iOS (nowy) jest zaimplementowany w infrastrukturze usługi w Google Cloud. Taka implementacja zapewnia bezpieczniejszą i zaufaną platformę. Ten standardowy wygląd zapewnia spójność wszystkich pakietów SDK, co zwiększa wydajność programowania dzięki pakietowi SDK Miejsc Google na iOS (nowość).

Poprawiona wydajność

Pakiet SDK Miejsc na iOS zapewnia większą wydajność, dzięki czemu warto zastąpić aplikacje, które korzystają z dotychczasowego pakietu SDK.

Wyszukiwanie tekstowe zwraca informacje o zestawie miejsc na podstawie ciągu znaków, np. „pizza w Krakowie”, „sklepy z obuwiem w pobliżu Ottawy” lub „ulica Główna 123”. W odpowiedzi usługa przedstawia listę miejsc pasujących do ciągu tekstowego i ustawione odchylenie do lokalizacji.

Uproszczone ceny

Ceny zostały uproszczone dzięki pakietowi SDK Miejsc Google na iOS (nowość), dzięki czemu płacisz tylko za dane, których użyjesz. Uproszczone ceny są wdrażane za pomocą list pól, zwanych też maskami pól.

Za pomocą pakietu SDK Miejsc na iOS i wyszukiwarki tekstu możesz używać list pól do kontrolowania listy pól, które mają być zwracane w odpowiedzi. Zapłacisz tylko za dane, których dotyczy żądanie. Korzystanie z listy pól to dobra praktyka projektowa, by uniknąć żądania 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 płatności.

Rozszerzone typy miejsc

Nowy pakiet SDK dodaje typy miejsc wymienione w poniższej tabeli. Te typy są zwracane w odpowiedziach na żądania: szczegóły miejsca i wyniki wyszukiwania tekstowego. Tych nowych i istniejących już rodzajów można też używać w wyszukiwaniu tekstowym. Nowe typy znajdziesz 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 playground 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 nowymi typami interfejsu Places API (nowość) przenieśliśmy następujące typy z tabeli B z tabeli A. Oznacza to, że podczas wyszukiwania możesz teraz używać tych typów:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality