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ść) |
Wersja usługi Places API, która jest włączona dla klucza interfejsu API, kontroluje interfejsy API używane przez aplikację:
Places API: włącza istniejące interfejsy API. Jeśli w projekcie powiązanym z kluczem interfejsu API używanym w Twojej aplikacji włączony jest tylko interfejs Places API, aplikacja nie będzie miała dostępu do nowych interfejsów API.
Places API (nowość): włącza wszystkie nowe interfejsy API i funkcje opisane w artykule Kluczowe funkcje dodane do pakietu SDK Miejsc na iOS (nowość). Twoja aplikacja nie będzie miała dostępu do istniejących interfejsów API.
Oba: włącza wszystkie funkcje i interfejsy API – Places SDK na iOS (nowość) i Places SDK 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 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:
- 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 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 |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
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:
Jeśli jesteś nowym klientem, który dopiero zaczynasz korzystać z interfejsu Places API, zacznij od nowych interfejsów API.
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.
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.