Interfejs Places API obsługuje 2 wersje interfejsu API: Places API to istniejące interfejsy API, a Places API (New) to nowa generacja interfejsów API.
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ę, jakie są 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, użyj tej tabeli, aby określić nowy interfejs API, który zastąpi używany przez Ciebie interfejs API.
| Places API | Places API (nowość) | Uwaga |
|---|---|---|
| Znajdź miejsce | Wyszukiwanie tekstu (nowa funkcja) | Nie ma nowej wersji Find Place. Został on 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) | |
| Umieszczanie zdjęcia | Place Photo (Nowy) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowa wersja) | |
| Autouzupełnianie zapytań | Autouzupełnianie (nowa wersja) | Dodaliśmy funkcje do autouzupełniania (nowe) |
Wersja usługi interfejsu Places API, którą włączysz w kluczu interfejsu API, decyduje o interfejsach API używanych przez Twoją aplikację:
Places API: umożliwia korzystanie z dotychczasowych interfejsów API. Jeśli w projekcie powiązanym z kluczem API używanym przez Twoją aplikację włączony jest tylko interfejs Places API, aplikacja nie będzie mieć dostępu do nowych interfejsów API.
Interfejs API Miejsc (nowy): umożliwia korzystanie ze wszystkich nowych interfejsów API i funkcji opisanych w artykule Najważniejsze funkcje dodane do pakietu SDK Miejsc na iOS (nowy). Twoja aplikacja nie będzie mieć dostępu do dotychczasowych interfejsów API.
Oba: 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 wybieraniu usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.
Przejście na nowe interfejsy API
Jeśli korzystasz z dotychczasowego interfejsu API i chcesz przejść na nowy, zapoznaj się z tymi wskazówkami dotyczącymi migracji:
- Migracja na wyszukiwanie w pobliżu (nowa wersja)
- Przejście na wyszukiwanie tekstowe (nowa wersja)
- Migracja do szczegółów miejsca (nowa wersja)
- Migracja na zdjęcie lokalizacji (nowa)
- Migracja na autouzupełnianie (nowa wersja)
Najważniejsze funkcje dodane do 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 na infrastrukturze usługi w Google Cloud. Dzięki temu będzie to bezpieczniejsza i bardziej zaufana platforma z ulepszonymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność interfejsów API, co zwiększa efektywność rozwoju za pomocą interfejsu Places API (New).
Poprawiona wydajność
Interfejs Places API (nowy) zapewnia lepszą wydajność, dzięki czemu warto zastąpić aplikacje korzystające z obecnego interfejsu Places API.
Uproszczone ceny
Ceny w interfejsie Places API (Nowy) są uproszczone, dzięki czemu płacisz tylko za używane dane. Uproszczone ustalanie cen jest stosowane 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ą zostać zwrócone 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.
Rozwinięte 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 | 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 |
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
Places API (Nowy) obsługuje dane odpowiedzi dynamicznej, takie jak dostępność stacji ładowania EV czy najnowsze ceny paliwa na stacji benzynowej. Za pomocą tych pól odpowiedzi możesz tworzyć dynamiczne wrażenia użytkowników.
Który interfejs API wybrać?
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.