Interfejs Places API obsługuje 2 wersje interfejsu API: Places API to istniejące interfejsy API, a Places API (nowość) to interfejsy API nowej generacji.
Po wydaniu interfejsu Places API (New) pierwszym zadaniem jest wybranie zestawu interfejsów API, których chcesz używać. Dotyczy to nowych i obecnych klientów, którzy korzystają z interfejsów API. Z tego przewodnika dowiesz się, na czym polegają główne różnice między tymi interfejsami API.
Lista interfejsów API
W tabeli poniżej znajdziesz oba zestawy interfejsów API. Jeśli jesteś już klientem, możesz użyć 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 tekstu (nowa funkcja) | Nie ma nowej wersji Find Place. Został zastąpiony przez wyszukiwanie tekstu (nowa wersja). |
| 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 tekstu | Wyszukiwanie tekstowe (nowość) | |
| Szczegóły miejsca | Szczegóły miejsca (nowe) | |
| Zdjęcie miejsca | Place Photo (New) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowa wersja) | |
| Autouzupełnianie zapytań | Autouzupełnianie (nowa wersja) | Funkcje dodane do autouzupełniania (nowość) |
Wersja usługi Places API, którą włączysz w kluczu interfejsu API, steruje interfejsami API używanymi przez Twoją aplikację:
Places API: umożliwia korzystanie z dotychczasowych interfejsów 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 (nowy): umożliwia korzystanie ze wszystkich nowych interfejsów API i funkcji opisanych w artykule Najważniejsze nowe funkcje w pakiecie SDK do aplikacji mobilnych na iOS (nowy). Aplikacja utraci dostęp do istniejących interfejsów API.
Oba: umożliwia korzystanie ze wszystkich funkcji i interfejsów API zarówno w pakiecie SDK Miejsc na iOS (nowym), jak i w pakiecie SDK Miejsc na iOS.
Więcej informacji o wybieraniu 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 na wyszukiwanie w pobliżu (nowa wersja)
- Migracja do wyszukiwania tekstowego (nowa)
- Migracja do Szczegółów miejsca (nowa)
- Migracja na zdjęcie lokalizacji (nowa)
- Migracja na autouzupełnianie (nowa wersja)
Kluczowe funkcje dodane do interfejsu Places API (nowość)
Ta sekcja zawiera najważniejsze funkcje dodane do interfejsu Places API (New).
Wdrożone na platformie standardowej Google Cloud
Interfejs Places API (nowość) został zaimplementowany w infrastrukturze usług Google Cloud. Dzięki temu wdrożeniu użytkownicy będą mogli korzystać z bezpieczniejszej i bardziej zaufanej platformy z rozszerzonymi 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
Dzięki interfejsowi Places API (Nowy) ceny są uproszczone, więc płacisz tylko za używane dane. Uproszczone ustalanie cen jest wdrażane 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. Używanie maskowania pól jest dobrą praktyką projektowania, która pozwala uniknąć przesyłania niepotrzebnych danych, co z kolei 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 (New) 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ć główny typ miejsca. Każde miejsce może mieć 1 wartość typu wskazaną jako główny typ miejsca, jak podano w tabeli A.
Nowy interfejs API umożliwia też dodawanie typów miejsc widocznych w tabeli poniżej. Możesz używać tych nowych typów wyszukiwania oraz dotychczasowych typów w wyszukiwaniu z lokalizacją (nowy) i wyszukiwaniu tekstowym (nowy). 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 | 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 w przypadku interfejsu Places API do tabeli A dla interfejsu Places API (nowego). Oznacza to, że możesz teraz używać tych typów w ramach wyszukiwania:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dynamiczne dane o miejscach
Interfejs Places API (nowy) obsługuje dane odpowiedzi dynamicznej, takie jak dostępność stacji ładowania EV czy najnowsze ceny paliwa na stacji benzynowej. Użyj tych pól odpowiedzi, by utworzyć dynamiczne środowisko użytkowników.
Którego interfejsu API używasz?
Zanim zaczniesz tworzyć aplikację, musisz wybrać interfejs API:
Jeśli jesteś nowym klientem i zaczynasz dopiero korzystać z interfejsu Places API, zacznij od nowych interfejsów API.
Jeśli jesteś nowym klientem i nie masz jeszcze zastąpionego interfejsu API, takiego jak Autocomplete miejsc lub Autocomplete zapytań, możesz korzystać z połączenia nowych i dotychczasowych interfejsów API.
Jeśli jesteś obecnym klientem, możesz nadal korzystać z dotychczasowych interfejsów API. Aby jednak skorzystać z ulepszonego działania i funkcji interfejsu Places API (New), możesz przejść na nowe interfejsy API.
Więcej informacji o migracji znajdziesz w artykule Omówienie migracji.