Informacje o interfejsie Places API (nowość)

Nowy interfejs Places API zawiera następujące interfejsy API:

Niniejszy dokument zawiera omówienie tych nowych interfejsów API.

Szczegóły miejsca (nowe)

Identyfikator miejsca jednoznacznie identyfikuje miejsce w bazie danych Miejsc Google i w Mapach Google. Dzięki identyfikatorowi miejsca możesz poprosić o szczegółowe informacje na temat konkretnej firmy lub ciekawego miejsca, wysyłając żądanie Szczegóły miejsca (nowe). Żądanie szczegółów miejsca (nowe) zwraca kompleksowe informacje na temat wskazanego miejsca, 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ć:

Zdjęcie miejsca (nowe)

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

Wszystkie żądania wysyłane do interfejsu Place 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ć, przy użyciu:

Aby uwzględnić nazwę zasobu zdjęcia w odpowiedzi na prośbę o szczegóły miejsca (nowe), wyszukiwanie tekstowe (nowe) lub wyszukiwanie w pobliżu (nowe), pamiętaj o uwzględnieniu pola photos w masce pola w żądaniu.

Wyszukiwanie tekstowe (nowość) i Wyszukiwanie w pobliżu (nowość)

Interfejs Places API obejmuje dwa interfejsy API wyszukiwania:

  • Wyszukiwanie tekstowe (nowość)

    Umożliwia określenie ciągu tekstowego, który będzie używany do wyszukiwania miejsca. Na przykład: „Pikantne dania wegetariańskie w Sydney” lub „Wykwintne owoce morza w pobliżu Pallo Alto w Kalifornii”.

    Możesz zawęzić wyszukiwanie, podając szczegóły, takie jak poziomy cen, aktualny status otwarcia, oceny lub typy miejsc. Możesz też wskazać, że wyniki mają się wyświetlać w konkretnej lokalizacji, lub zawęzić 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 jako okrąg zdefiniowany przez współrzędne punktu środkowego i promień w metrach.

    Określ co najmniej jeden typ miejsca, który określa jego cechy. Na przykład wpisz „pizza_restaurant” i „shopping_mall”, by wyszukać pizzerię znajdującą się w centrum handlowym w wybranym regionie.

Główna różnica między nimi polega na tym, że wyszukiwanie tekstowe (nowe) pozwala podać dowolny ciąg wyszukiwania, a Wyszukiwanie w pobliżu (nowa funkcja) wymaga wyszukiwania z określonego obszaru.

Autouzupełnianie (nowe) i tokeny sesji

Autouzupełnianie (nowa wersja) to usługa internetowa, która w odpowiedzi na żądanie HTTP zwraca prognozy dotyczące miejsc i zapytań. W żądaniu określ wyszukiwany tekst i granice geograficzne, które sterują obszarem wyszukiwania.

Tokeny sesji to ciągi wygenerowane przez użytkownika, które śledzą wywołania autouzupełniania (nowe) jako sesje. Autouzupełnianie (nowość) korzysta z tokenów sesji, aby grupować etapy zapytania i wyboru autouzupełniania wyszukiwania użytkownika w oddzielną sesję na potrzeby rozliczeń.

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

Interfejs Places API (nowość) zawiera nowe pola, atrybuty i opcje ułatwień dostępu, które dostarczają użytkownikom dodatkowych informacji o danym miejscu. Aspekty te zostały opisane w kolejnych sekcjach.

Pola

Nowy interfejs Places API zawiera kilka nowych pól:

Pole Opis
regularSecondaryOpeningHours Opisuje konkretne godziny dla określonych operacji. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład dla restauracji jako dodatkowe godziny otwarcia można podać godziny pracy zmotoryzowanych lub dostawy.
paymentOptions Opcje płatności akceptowane w danym miejscu. Dane miejsce może mieć więcej niż 1 opcję płatności. Jeśli dane o opcjach płatności są niedostępne, pole opcji płatności nie będzie skonfigurowane. Dostępne opcje:
  • Karta kredytowa
  • Karta debetowa
  • Płatność tylko gotówką
  • płatność NFC
parkingOptions Parking jest dostępny w hotelu. Dostępne opcje:
  • Bezpłatne parkingi
  • Płatne parkingi
  • Bezpłatny parking przy ulicy
  • Parking z obsługą
  • Bezpłatny parking podziemny
  • Płatny parking podziemny
subDestinations Wyjątkowe miejsca związane z konkretnym miejscem. Na przykład terminale lotniskowe są uznawane za podrzędne miejsca docelowe lotniska.
fuelOptions Najnowsze informacje o opcjach paliwowych dostępnych na stacji benzynowej. Te informacje są regularnie aktualizowane. Dostępne opcje:
  • Diesel
  • Zwykłe bezołowiowe
  • Ś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 ładowarki pojazdów elektrycznych (EV) na tej stacji. Niektóre ładowarki EV mają kilka złączy, ale każda z nich może ładować tylko 1 pojazd naraz. Oznacza to, że to pole uwzględnia 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 artykule Obsługiwane typy.
primaryTypeDisplayName Wyświetlana nazwa typu podstawowego, w stosownych przypadkach zlokalizowana na język żądania. 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 Do dyspozycji gości są miejsca do siedzenia na świeżym powietrzu.
liveMusic Miejsce z muzyką na żywo.
menuForChildren Miejsce ma menu dla dzieci.
servesCocktails Restauracja serwuje koktajle.
servesDessert To miejsce oferuje desery.
servesCoffee Miejsce serwuje kawę.
goodForChildren To dobre miejsce dla dzieci.
allowsDogs Miejsce zezwala na dostęp psów.
restroom W miejscu jest toaleta.
goodForGroups Miejsce jest przeznaczone dla grup.
goodForWatchingSports Miejsce odpowiednie do oglądania transmisji sportowych.

Opcje ułatwień dostępu

Interfejs Places API (nowość) zawiera następujące pola opcji ułatwień dostępu:

Pole Opis
wheelchairAccessibleParking Do dyspozycji gości jest parking dla osób na wózkach inwalidzkich.
wheelchairAccessibleEntrance Miejsce ma wejście dostępne dla osób na wózkach.
wheelchairAccessibleRestroom Na terenie obiektu znajduje się toaleta dla osób poruszających się na wózkach.
wheelchairAccessibleSeating W miejscu jest miejsce na wózek inwalidzki.

Migracja do nowych interfejsów Places API

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