Wybierz wersję interfejsu API

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 interfejs API, z którego korzystasz 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:

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 tekstu (nowość) za pomocą maski pola do kontrolowania listę pól, które mają zwrócić odpowiedź. Opłaty są naliczane tylko za te dane. poproszono o dostęp. Dobrą praktyką podczas projektowania 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:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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:

  1. Jeśli jesteś nowym klientem i dopiero zaczynasz korzystać z interfejsu Places API, a potem zacząć od nowych interfejsów API.

  2. 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.

  3. 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 .