Interfejs Places API obsługuje 2 wersje: Places API to istniejące interfejsy API, a Places API (nowość) to nowa wersja interfejsów API.
Po wprowadzeniu nowego interfejsu Places API Twoim pierwszym zadaniem jest wybór zestawu interfejsów API, których chcesz użyć. Jeśli jesteś nowym lub obecnym klientem, który korzysta już z tych interfejsów API. Ten przewodnik pomoże Ci zrozumieć najważniejsze różnice między tymi 2 interfejsami API.
Lista interfejsów API
Poniższa tabela zawiera oba zestawy interfejsów API. Jeśli jesteś obecnym klientem, skorzystaj z tej tabeli, aby określić nowy interfejs API, który zastąpi interfejs API, którego obecnie używasz.
| Places API | Places API (nowość) | Uwaga |
|---|---|---|
| Znajdź miejsce | Wyszukiwanie tekstowe (nowość) | Nie ma nowej wersji usługi Znajdź miejsce. Funkcja ta została zastąpiona przez funkcję wyszukiwania tekstowego (nową). |
| Wyszukiwanie w pobliżu | Wyszukiwanie w pobliżu (nowość) | Wszystkie żądania używające dotychczasowego interfejsu API, które zawierają zapytanie tekstowe, powinny korzystać z opcji Wyszukiwanie tekstowe (nowe), ponieważ Wyszukiwanie w pobliżu (nowość) nie obsługuje wprowadzania tekstu. |
| Wyszukiwanie tekstowe | Wyszukiwanie tekstowe (nowość) | |
| Szczegóły miejsca | Szczegóły miejsca (nowe) | |
| Zdjęcie miejsca | Zdjęcie miejsca (nowe) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowość) | |
| Autouzupełnianie zapytań | Autouzupełnianie (nowość) | Funkcje dodane do autouzupełniania (nowość) |
Wersja usługi Places API, którą włączysz w kluczu interfejsu API, decyduje o tym, które interfejsy API są używane przez Twoją aplikację:
Places API: włącza istniejące interfejsy API. Jeśli interfejs Places API będzie włączony tylko w projekcie powiązanym z kluczem interfejsu API używanym w Twojej aplikacji, aplikacja nie będzie miała dostępu do nowych interfejsów API.
Places API (nowość): włącza wszystkie nowe interfejsy API i funkcje opisane w artykule Kluczowe funkcje dodane do pakietu SDK Miejsc na iOS (nowość). Aplikacja utraci dostęp do istniejących interfejsów API.
Obie możliwości: włącza wszystkie funkcje i interfejsy API zarówno w pakiecie SDK Miejsc na iOS (nowym), jak i w pakiecie SDK Miejsc na iOS.
Więcej informacji o wyborze usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.
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 Wyszukiwarki w pobliżu (nowość)
- Migracja do wyszukiwania tekstowego (nowość)
- Migracja do szczegółów miejsca (nowość)
- Migracja do zdjęcia miejsca (nowość)
- Migracja do autouzupełniania (nowość)
Najważniejsze funkcje dodane do interfejsu Places API (nowość)
W tej sekcji omawiamy najważniejsze funkcje dodane do interfejsu Places API (nowość).
Wdrożony na standardowej platformie Google Cloud
Interfejs Places API (nowość) został zaimplementowany w infrastrukturze usług Google Cloud. Ta implementacja zapewnia bezpieczniejszą i zaufaną platformę z ulepszonymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy interfejs API zapewnia pewien poziom spójności interfejsów API, co zwiększa wydajność programowania za pomocą interfejsu Places API (nowego).
Poprawiona wydajność
Interfejs Places API (nowość) zwiększa wydajność, dlatego warto zastąpić aplikacje, które korzystają z obecnego interfejsu Places API.
Uproszczone ustalanie cen
W przypadku interfejsu Places API (nowego) cennik jest upraszczany, dzięki czemu płacisz tylko za dane, z których korzystasz. Uproszczone ustalanie cen jest implementowane za pomocą maski pola.
W przypadku szczegółów miejsca (nowość), Wyszukiwanie w pobliżu (nowość) i wyszukiwanie tekstowe (nowe) za pomocą maski pola możesz kontrolować listę pól, które mają zwrócić odpowiedź. Opłaty są naliczane tylko za dane, których dotyczy żądanie. Maskowanie pól to sprawdzona metoda projektowania, która pozwala uniknąć żądania zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat.
Spójne dane odpowiedzi dotyczące miejsca
W przypadku dotychczasowych interfejsów API interfejsy Place Details, Wyszukiwanie w pobliżu i Text Search API zwracały różne dane odpowiedzi dla każdego miejsca. Interfejs Places API (nowość) standaryzuje odpowiedź, dzięki czemu wszystkie te interfejsy API zwracają te same dane o miejscu.
Rozszerzone typy miejsc
Odpowiedź interfejsu API może teraz zawierać typ główny miejsca. Każde miejsce może mieć 1 wartość typu wskazaną jako główny typ miejsca, jak podano w tabeli A.
Oprócz tego nowy interfejs API dodaje typy miejsc podane w poniższej tabeli. Tych nowych i istniejących typów możesz używać w wyszukiwaniu w pobliżu przy użyciu funkcji Wyszukiwanie w pobliżu (nowe) i Wyszukiwanie tekstowe (nowe). Wszystkie 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 |
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:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dynamiczne dane miejsca
Interfejs Places API (nowość) obsługuje dynamiczne dane odpowiedzi, takie jak dostępność stacji ładowania pojazdów elektrycznych czy najnowsze ceny paliw na danej stacji. Użyj tych pól odpowiedzi, by utworzyć dynamiczne środowisko użytkowników.
Który interfejs API wybierzesz?
Zanim zaczniesz tworzyć aplikację, musisz wybrać interfejs API:
Jeśli jesteś nowym klientem, który dopiero rozpoczyna korzystanie z interfejsu Places API, zacznij od nowych interfejsów API.
Jeśli jesteś nowym klientem i nie ma jeszcze rozwiązania zastępującego istniejący interfejs API, taki jak autouzupełnianie miejsc lub autouzupełnianie zapytań, możesz użyć kombinacji nowych i istniejących interfejsów API.
Jeśli jesteś klientem, możesz nadal korzystać z istniejących interfejsów API. Aby jednak skorzystać z zwiększonej wydajności i udoskonaleń funkcji dostępnych w interfejsie Places API (nowość), możesz przejść na nowe interfejsy API.
Więcej informacji o migracji znajdziesz w artykule Omówienie migracji.