Informacje o nowych interfejsach API Miejsc

Nowy interfejs Places API zawiera te interfejsy API:

Ten dokument zawiera omówienie nowych interfejsów API.

Interfejs Place Details API

Identyfikator miejsca jednoznacznie identyfikuje miejsce w bazie danych Miejsc Google i w Mapach Google. Dzięki identyfikatorowi miejsca możesz poprosić o informacje o konkretnym obiekcie lub ciekawym miejscu, przesyłając prośbę o szczegóły miejsca (nowe). Prośba o szczegóły dotyczące miejsca (nowego) zwraca szczegółowe informacje o wybranym miejscu, takie jak pełny adres, numer telefonu, oceny użytkowników i opinie.

Identyfikator miejsca można uzyskać na wiele sposobów. Możesz użyć:

Interfejs Place Photo API

Interfejs Place Photo (nowość) API pozwala dodawać do aplikacji wysokiej jakości fotografie, zapewniając dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc Google. Za pomocą interfejsu Place Photo (New) API możesz uzyskać dostęp do zdjęć i zmienić ich rozmiar na optymalny dla danej aplikacji.

Wszystkie żądania wysyłane do interfejsu Places Photo (New) API muszą zawierać nazwę zasobu zdjęcia, która jednoznacznie identyfikuje zdjęcie do zwrócenia. Nazwę zasobu zdjęcia możesz uzyskać w ten sposób:

Aby uwzględnić nazwę zasobu zdjęcia w odpowiedzi na żądanie Szczegółowe informacje o miejscu (nowość), wyszukiwanie tekstowe (nowość) lub wyszukiwanie w pobliżu (nowe), pamiętaj, by w masce pola żądania uwzględnić pole photos.

Wyszukiwanie tekstowe i wyszukiwanie w pobliżu

Places API obejmuje 2 interfejsy API wyszukiwania:

  • Wyszukiwanie tekstowe (nowość)

    Umożliwia określenie ciągu tekstowego, za pomocą którego ma zostać wyszukane miejsce. Na przykład: „Wyśmienite dania wegetariańskie w Sydney w Australii” lub „Wyśmienite owoce morza w pobliżu Palo Alto w Kalifornii”.

    Możesz zawęzić wyszukiwanie, określając szczegóły, takie jak poziomy cen, obecny status otwarcia, oceny lub konkretne typy miejsc. Możesz też określić strony, na podstawie których wyniki będą się wyświetlać w konkretnej lokalizacji, lub ograniczyć wyszukiwanie do konkretnej lokalizacji.

  • Wyszukiwanie w pobliżu (nowość)

    Umożliwia określenie regionu do wyszukiwania wraz z listą typów miejsc. Określ region w formie okręgu zdefiniowanego we współrzędnych szerokości i długości geograficznej punktu środkowego oraz promienia w metrach.

    Określ co najmniej jeden typ miejsca definiujący cechy danego miejsca. Na przykład wpisz „pizza_restaurant” i „shopping_mall”, aby wyszukać pizzerię w centrum handlowym w wybranym regionie.

Główna różnica między tymi dwoma wyszukiwaniami polega na tym, że wyszukiwanie tekstowe (nowe) umożliwia określenie dowolnego ciągu wyszukiwania, a wyszukiwanie w pobliżu (nowe) wymaga określonego obszaru wyszukiwania.

Interfejs Autocomplete API i tokeny sesji

Interfejs Autocomplete (New) API to usługa internetowa, która w odpowiedzi na żądanie HTTP zwraca prognozy dotyczące miejsc i zapytań. W żądaniu podaj ciąg tekstowy wyszukiwania i granice geograficzne, które kontrolują obszar wyszukiwania.

Tokeny sesji to ciągi tekstowe generowane przez użytkownika, które śledzą (nowe) wywołania autouzupełniania jako sesje. Funkcja autouzupełniania (nowa) używa tokenów sesji do grupowania faz zapytania i wyboru autouzupełniania wyszukiwania użytkownika w oddzielną sesję na potrzeby płatności.

Nowe pola, atrybuty i opcje ułatwień dostępu

Interfejs Places API (nowość) zawiera nowe pola, atrybuty i opcje ułatwień dostępu, dzięki którym użytkownicy mogą dowiedzieć się więcej o danym miejscu. Te aspekty opisujemy w sekcjach poniżej.

Pola

Interfejs Places API (nowość) zawiera kilka nowych pól:

Pole Opis
regularSecondaryOpeningHours Opisuje konkretne godziny wykonywania pewnych operacji. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład w przypadku restauracji możesz podać godziny otwarcia samochodu lub dostawy jako dodatkowe godziny.
paymentOptions Opcje płatności akceptowane w tym miejscu. W danym miejscu akceptowana jest więcej niż 1 opcja płatności. Jeśli dane opcji płatności są niedostępne, pole opcji płatności nie będzie ustawione. Dostępne opcje:
  • Karta kredytowa
  • Karta debetowa
  • Płatność tylko gotówką
  • płatność NFC
parkingOptions Opcje parkingu dostępne w tym miejscu. Dostępne opcje:
  • Bezpłatne parkingi
  • Płatne parkingi
  • Bezpłatny parking przy ulicy
  • Parking z obsługą
  • Bezpłatny parking w garażu
  • Płatny parking w garażu
subDestinations Unikalne miejsca związane z danym miejscem. Na przykład terminale lotniskowe są uważane za podrzędne miejsca docelowe lotniska.
fuelOptions Najnowsze informacje o opcjach paliw dostępnych na stacji. Te informacje są regularnie aktualizowane. Dostępne opcje:
  • Olej napędowy
  • Regularnie bez lidera
  • Średniooktanowa
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • To miejsce oferuje paliwo LPG
  • E80
  • E85
  • Metan
  • Biodiesel
  • Olej napędowy do ciężarówek
evChargeOptions Liczba ładowarek pojazdów elektrycznych (EV) na tej stacji. Chociaż niektóre ładowarki pojazdów EV mają kilka złączy, każda ładowarka umożliwia ładowanie tylko 1 pojazdu naraz. W związku z tym pole to odzwierciedla liczbę dostępnych ładowarek EV w danym momencie.
shortFormattedAddress Krótki, zrozumiały dla człowieka adres miejsca.
primaryType Podstawowy typ danego wyniku. Miejsce może być na przykład sklasyfikowane jako cafe lub airport. Miejsce może mieć tylko 1 typ główny. Pełną listę możliwych wartości znajdziesz w sekcji Obsługiwane typy.
primaryTypeDisplayName Wyświetlana nazwa typu głównego zlokalizowana w języku żądania, jeśli ma to zastosowanie. Pełną listę możliwych wartości znajdziesz w sekcji Obsługiwane typy.

Atrybuty

Nowy interfejs Places API zawiera kilka nowych atrybutów:

Atrybut Opis
outdoorSeating Goście mają do dyspozycji stoliki na świeżym powietrzu.
liveMusic W hotelu można posłuchać muzyki na żywo.
menuForChildren Na miejscu dostępne jest menu dla dzieci.
servesCocktails Bar serwujący koktajle.
servesDessert Lokal serwuje desery.
servesCoffee Lokal serwuje kawę.
goodForChildren Miejsce odpowiednie dla dzieci.
allowsDogs W tym miejscu można przebywać z psami.
restroom Na miejscu jest toaleta.
goodForGroups Miejsce jest przeznaczone dla grup.
goodForWatchingSports Miejsce jest odpowiednie do oglądania transmisji sportowych.

Opcje ułatwień dostępu

Interfejs Places API (nowość) zawiera te pola opcji ułatwień dostępu:

Pole Opis
wheelchairAccessibleParking Na terenie obiektu znajduje się parking dla osób na wózkach.
wheelchairAccessibleEntrance Miejsce ma wejście dla niepełnosprawnych.
wheelchairAccessibleRestroom Na miejscu znajduje się toaleta dla osób poruszających się na wózku inwalidzkim.
wheelchairAccessibleSeating Miejsce z miejscem dla osób poruszających się na wózku inwalidzkim.

Przejście na nowe interfejsy Places API

Jeśli jesteś klientem Places API i chcesz przenieść swoją aplikację, aby korzystać z nowych interfejsów API, zapoznaj się z tą dokumentacją migracji: