Wybierz wersję interfejsu API

Interfejs Places API obsługuje 2 wersje API: Places API to istniejące interfejsy API, a Places API (nowość) to ich nowa wersja.

Po wprowadzeniu nowego interfejsu Places API Twoim pierwszym zadaniem jest wybór zestawu interfejsów API, którego chcesz używać. Dotyczy to nowych lub obecnych klientów, którzy korzystają już z interfejsów API. Z tego przewodnika dowiesz się, jakie są główne 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, którego obecnie używasz.

Places API Places API (nowość) Uwaga
Znajdź miejsce Wyszukiwanie tekstowe (nowość) Nie ma nowej wersji aplikacji Znajdź miejsce. Wyszukiwanie tekstowe (nowość) je zastąpiło.
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ć wyszukiwania tekstowego (nowego), ponieważ funkcja Wyszukiwanie w pobliżu (nowa wersja) nie obsługuje wprowadzania tekstu.
Wyszukiwanie tekstowe Wyszukiwanie tekstowe (nowość)
Szczegóły miejsca Szczegóły miejsca (nowość)
Zdjęcie miejsca Zdjęcie miejsca (nowość)
Autouzupełnianie miejsc Autouzupełnianie (nowość) W trybie podglądu
Autouzupełnianie zapytań Autouzupełnianie (nowość) Funkcje dodane do wersji testowej autouzupełniania (nowość)

Jeśli używasz dotychczasowego interfejsu API i chcesz przejść na nowy interfejs API, zapoznaj się z tymi przewodnikami po migracji dotyczącymi poszczególnych interfejsów API:

Najważniejsze funkcje dodane do interfejsu Places API (nowość)

W tej sekcji omawiamy kluczowe funkcje dodane do interfejsu Places API (nowość).

Wdrożone na standardowej platformie Google Cloud

Nowy interfejs Places API jest wdrożony w infrastrukturze usług w Google Cloud. Ta implementacja zapewnia bezpieczniejszą i zaufaną platformę z ulepszonymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy interfejs API zapewnia poziom spójności między interfejsami API, co zwiększa wydajność programowania za pomocą interfejsu Places API (nowość).

Poprawiona wydajność

Nowy interfejs Places API zapewnia większą wydajność, dzięki czemu warto zastąpić aplikacje korzystające z obecnego interfejsu Places API.

Uproszczone ceny

Ceny zostały uproszczone za pomocą interfejsu Places API (nowość), dzięki czemu płacisz tylko za dane, których użyjesz. Uproszczone ceny są implementowane za pomocą maski pól.

Korzystając ze szczegółów miejsca (nowego), wyszukiwania w pobliżu (nowego) i wyszukiwania tekstowego (nowego), używasz maski pola do kontrolowania listy pól, które mają być zwracane w odpowiedzi. Zapłacisz tylko za dane, których dotyczy żądanie. Użycie maskowania pól to dobra praktyka projektowa, która pozwala uniknąć żądania zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat.

Spójne dane odpowiedzi dotyczące miejsca

Dotychczasowe interfejsy API te zwracały różne dane odpowiedzi dla danego miejsca. Places API (nowość) standaryzuje odpowiedź, aby wszystkie te interfejsy zwracały te same dane o miejscu.

Rozszerzone typy miejsc

Odpowiedź interfejsu API może teraz zawierać typ podstawowy miejsca. Każde miejsce może mieć jedną wartość typu, która jest określona jako podstawowy typ miejsca, jak podano w tabeli A.

Nowy interfejs API dodaje też typy miejsc wymienione w poniższej tabeli. Tych nowych oraz dotychczasowych typów możesz używać w wyszukiwaniu za pomocą funkcji wyszukiwania w pobliżu (nowość) i wyszukiwania tekstowego (nowość). 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 targ 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 playground 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
Razem z tymi nowymi typami pakiet SDK Miejsc na Androida (nowość) przeniósł z tabeli A następujące typy danych: Oznacza to, że podczas wyszukiwania możesz teraz używać tych typów:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

Dynamiczne dane miejsc

Interfejs Places API (nowy) obsługuje dynamiczne dane, np. dostępność stacji ładowania pojazdów elektrycznych lub najnowsze ceny paliw na stacji benzynowej. Wykorzystaj te pola odpowiedzi, aby tworzyć dynamiczne wrażenia użytkowników.

Który interfejs API wybierasz?

Zanim zaczniesz tworzyć aplikacje, musisz wybrać interfejs API:

  1. Jeśli jesteś nowym klientem, który dopiero zaczynasz korzystać z interfejsu Places API, zacznij od nowych interfejsów API.

  2. Jeśli jesteś nowym klientem i nie zastąpiliśmy jeszcze dotychczasowego interfejsu API (np. autouzupełniania miejsc lub autouzupełniania zapytań), możesz korzystać z kombinacji nowych i istniejących interfejsów API.

  3. Jeśli jesteś obecnym klientem, możesz nadal korzystać z istniejących interfejsów API. Jednak aby skorzystać z ulepszonej wydajności i ulepszeń funkcji dostępnych w nowym interfejsie Places API, możesz przejść na nowe interfejsy API.

    Więcej informacji o migracji znajdziesz w omówieniu migracji.