Interfejs Places API obsługuje dwie wersje: Interfejs Places API to istniejące interfejsy API oraz Places API (Nowe) są następne wersji generatywnej interfejsów API.
Po wprowadzeniu nowego interfejsu Places API Twoim pierwszym zadaniem jest określenie, z zestawem interfejsów API, które mają być używane. Jeśli jesteś nowym lub obecnym klientem klient już korzysta z interfejsów API. Z tego przewodnika dowiesz się, jak działają klucze różnice między tymi dwoma 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 ten 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 korzystające z dotychczasowego interfejsu API, które zawierają zapytanie tekstowe, powinny używać tego interfejsu. Wyszukiwanie tekstowe (nowość) 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 włączonych przez Ciebie interfejsu Places API; w kluczu interfejsu API kontroluje interfejsy API używane przez aplikację:
Places API: włącza istniejące interfejsy API. Jeśli tylko Interfejs Places API został włączony w projekcie powiązanym z klucza interfejsu API użytego w aplikacji, aplikacja nie będzie miała dostępu do nowych interfejsów API.
Places API (nowość): włącza wszystkie nowe interfejsy API oraz funkcje opisane w artykule Kluczowe funkcje dodane do Pakiet SDK Miejsc na iOS (nowość). Aplikacja nie będzie dostęp do istniejących interfejsów API.
Obie: włącza wszystkie funkcje i interfejsy API w obu usługach Pakiet SDK Miejsc na iOS (nowość) i Pakiet SDK Miejsc na iOS
Więcej informacji na temat wyboru usługi Places API znajdziesz Więcej informacji znajdziesz w artykule na temat konfigurowania projektu Google Cloud.
Migracja do nowych interfejsów API
Jeśli używasz istniejącego interfejsu API i chcesz przejść na nowy interfejs API, zapoznaj się z te przewodniki po migracji dla każdego interfejsu API:
- 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ść) jest zaimplementowany infrastruktura usługowa w Google Cloud. Ta implementacja zapewnia większe bezpieczeństwo i wiarygodność z ulepszonymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy interfejs API projektowanie zapewnia pewien poziom spójności interfejsów API, co zwiększa wydajność za pomocą interfejsu Places API (nowość).
Poprawiona wydajność
Interfejs Places API (nowość) zwiększa wydajność, warto zastąpić aplikacje korzystające z obecnego interfejsu Places API.
Uproszczone ustalanie cen
Upraszczamy ceny za pomocą interfejsu Places API (nowego), dzięki czemu tylko płacić za dane, których używasz. Uproszczone ustalanie cen jest implementowane za pomocą maski pola.
Ze szczegółami miejsca (nowymi) Wyszukiwanie w pobliżu (nowość) i Wyszukiwanie tekstowe (nowość) do kontrolowania maski pola. listę pól do zwrócenia w odpowiedzi. Opłaty są naliczane tylko za te dane. poproszono o dostęp. Dobrą praktyką przy projektowaniu jest stosowanie maskowania pól, nie żądają zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania; i płatności.
Spójne dane odpowiedzi dotyczące miejsca
W przypadku istniejących interfejsów API sekcja szczegółów miejsc Wyszukiwanie w pobliżu i wyszukiwanie tekstowe Interfejsy API zwróciły różne dane odpowiedzi dla tego miejsca. Places API (nowość) ustandaryzuje odpowiedź, tak aby wszystkie te interfejsy API zwracały te same dane dla określonego miejsca.
Rozszerzone typy miejsc
Odpowiedź interfejsu API może teraz zawierać typ główny miejsca. W każdym miejscu można jednego typu określonego jako głównego typu miejsca, jak określono w Tabela A.
Oprócz tego nowy interfejs API dodaje typy miejsc podane w poniższej tabeli. Dostępne opcje tych nowych, a także istniejących typów, w wyszukiwaniu z użyciem Wyszukiwanie w pobliżu (nowość) i Wyszukiwanie tekstowe (nowość). Wszystkie nowe typy są uwzględniane Tabela 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 interfejsu Places API do tabeli A dla interfejsu Places API (nowego). Oznacza to, że możesz teraz korzystać z tych typów treści w ramach szukaj:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dynamiczne dane miejsca
Interfejs Places API (nowość) obsługuje dane odpowiedzi dynamicznych, takie jak dostępność stacji ładowania EV lub najnowsze ceny paliwa na danej stacji. Używaj te pola odpowiedzi, by tworzyć dynamiczne treści dla użytkowników.
Który interfejs API wybierzesz?
Zanim zaczniesz tworzyć aplikację, musisz wybrać interfejs API:
Jeśli jesteś nowym klientem i dopiero zaczynasz korzystać z interfejsu Places API, a potem zacząć od nowych interfejsów API.
Jeśli jesteś nowym klientem i nie został jeszcze zamiennik istniejący interfejs API, taki jak autouzupełnianie miejsc lub zapytanie. autouzupełniania, możesz użyć kombinacji nowych i istniejących interfejsów API.
Jeśli jesteś klientem, możesz nadal korzystać z dotychczasowej API. Jednakże, aby skorzystać z udoskonalonej wydajności oraz ulepszeń funkcji interfejsu Places API (nowość), można przenieść je do nowych interfejsów API.
Więcej informacji na temat migracji znajdziesz w artykule Migracja .