Nowy interfejs Places API zawiera następujące interfejsy API:
- Szczegóły miejsca (nowe)
- Zdjęcie miejsca (nowe)
- Wyszukiwanie w pobliżu (nowość)
- Wyszukiwanie tekstowe (nowość)
- Autouzupełnianie (nowość)
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ć:
- Wyszukiwanie tekstowe (nowość)
- Wyszukiwanie w pobliżu (nowość)
- Geocoding API
- Interfejs Routes API
- Adres API weryfikacji adresów
- Autouzupełnianie miejsc
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:
|
parkingOptions |
Parking jest dostępny w hotelu. Dostępne opcje:
|
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:
|
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: