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 dotychczasowych 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 korzystające z dotychczasowego interfejsu API, które zawierają zapytanie tekstowe, powinny używać interfejsu Text Search (New) (Wyszukiwanie w pobliżu (nowy)), ponieważ interfejs Nearby Search (New) (Wyszukiwanie w pobliżu (nowy)) nie obsługuje wprowadzania tekstu. |
| Wyszukiwanie tekstu | Wyszukiwanie tekstu (nowa funkcja) | |
| Szczegóły miejsca | Szczegóły miejsca (nowa) | |
| Place Photo | Place Photo (Nowy) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowa wersja) | |
| Autouzupełnianie zapytań | Autouzupełnianie (nowa wersja) | Dodaliśmy funkcje do autouzupełniania (nowa wersja). |
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 w przypadku projektu powiązanego z kluczem API używanym przez aplikację włączony jest tylko interfejs API Places, aplikacja nie będzie mieć 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). Twoja aplikacja nie będzie miała dostępu do dotychczasowych 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 korzystasz z dotychczasowego interfejsu API i chcesz przejść na nowy, zapoznaj się z tymi przewodnikami dotyczącymi migracji:
- Migracja na wyszukiwanie w pobliżu (nowa wersja)
- Migracja do wyszukiwania tekstowego (nowa wersja)
- 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 (nowy) jest implementowany w infrastrukturze usługi w 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 projekt interfejsu API zapewnia spójność interfejsów API, co zwiększa wydajność programowania za pomocą interfejsu Places API (New).
Poprawiona wydajność
Interfejs Places API (nowy) zapewnia lepszą wydajność, dlatego warto zastąpić aplikacje korzystające 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 zapytań Szczegóły miejsca (Nowość), Wyszukiwanie w pobliżu (Nowość) i Wyszukiwanie tekstowe (Nowość) możesz użyć maski pola, aby określić listę pól, które mają być zwracane w odpowiedzi. Następnie naliczymy opłatę tylko za żądane dane. Używanie maskowania pól to dobra praktyka 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 API Szczegóły miejsca, Wyszukaj w pobliżu i Wyszukaj tekst zwracały różne dane odpowiedzi dotyczące 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ć jedną wartość typu, która jest określana jako jego główny typ, 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 znajdują się 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 | lądowisko dla helikopterów | 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 |
Wraz z tymi nowymi typami interfejs Places API (New) przeniósł te typy z tabeli 2 interfejsu Places API do tabeli A interfejsu Places API (New). 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żywaj tych pól odpowiedzi, aby tworzyć dynamiczne wrażenia 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 korzystać 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 Przegląd migracji.