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 oraz w Mapy Google. Dzięki identyfikatorowi miejsca możesz poprosić o szczegółowe informacje o konkretnym instytucji lub ciekawego miejsca poprzez zainicjowanie szczegółów miejsca (nowego); użytkownika. Żądanie „Place Details” (Nowe informacje o miejscu) zwraca kompleksowe informacje na temat: wskazane miejsce, takie jak jego pełny adres, numer telefonu, ocenę 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 (Nowy interfejs API Place Photo) pozwala dodawać wysokiej jakości treści fotograficzne do aplikacji, dając Ci dostęp do milionów zdjęć przechowywanych w Baza danych Miejsc Google. Za pomocą interfejsu API Place Photo (New) możesz uzyskać dostęp do zdjęcia i zmień rozmiar obrazu na optymalny dla danej aplikacji.
Wszystkie żądania wysyłane do interfejsu Place Photo (New) API muszą zawierać nazwę zasobu zdjęcia, jednoznacznie identyfikują zdjęcie do zwrócenia. Zasób ze zdjęciami można zdobyć można użyć za pomocą:
Aby dołączyć nazwę zasobu zdjęcia w odpowiedzi z poziomu szczegółów miejsca (nowość):
Wyszukiwanie tekstowe (nowe) lub Wyszukiwanie w pobliżu (nowe) – należy uwzględnić
w polu photos
maski pola żądania.
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 potrawy wegetariańskie w Sydney, Australia” lub „Wykwintne owoce morza w pobliżu Palo Alto, Kalifornia”.
Możesz zawęzić wyszukiwanie, określając szczegóły, takie jak poziomy cen, status otwarcia, oceny lub rodzaj konkretnego miejsca. Możesz też należy określić, aby wskazywać na wyniki dotyczące konkretnej lokalizacji, lub ograniczyć wyszukiwanie, w konkretne miejsce.
Wyszukiwanie w pobliżu (nowość)
Umożliwia określenie regionu do wyszukiwania wraz z listą typów miejsc. Określ region za pomocą okręgu zdefiniowanego przez szerokość i długość geograficzną współrzędne punktu środkowego i promień w metrach.
Podaj co najmniej jeden typ miejsca definiujący cechy miejsce. Wpisz na przykład „
pizza_restaurant
” i „shopping_mall
” do wyszukaj pizzerię znajdującą się w centrum handlowym na określonym obszarze i regionie.
Główna różnica między tymi dwoma wyszukiwaniami polega na tym, że wyszukiwanie tekstowe (nowe) pozwala możesz określić dowolny ciąg wyszukiwania, natomiast Wyszukiwanie w pobliżu (Nowe) wymaga podania w obszarze których ma być przeprowadzany wyszukiwanie.
Autouzupełnianie (nowe) i tokeny sesji
Autouzupełnianie (nowość) to usługa internetowa, która zwraca prognozy dotyczące miejsc i zapytań w odpowiedzi na żądanie HTTP. W żądaniu wpisz tekst ciąg znaków i granice geograficzne, które kontrolują obszar wyszukiwania.
Tokeny sesji to generowane przez użytkownika ciągi tekstowe, które śledzą wywołania autouzupełniania (nowe) jako sesji. Autouzupełnianie (nowość) korzysta z tokenów sesji do grupowania zapytań i podczas wybierania fazy wyszukiwania autouzupełniania do dyskretnej sesji w celach rozliczeniowych.
Nowe pola, atrybuty i opcje ułatwień dostępu
Interfejs Places API (nowość) zawiera nowe pola, atrybuty i opcje ułatwień dostępu . Te aspekty są opisane w dalszej części tego artykułu.
Pola
Nowy interfejs Places API zawiera kilka nowych pól:
Pole | Opis |
---|---|
regularSecondaryOpeningHours |
Opisuje konkretne godziny dla określonych operacji. Drugorzędne godziny pracy są inne niż główne godziny otwarcia firmy. Dla: Na przykład restauracja może określić godziny pracy z samochodem lub dostawę jako godziny dodatkowe. |
paymentOptions |
Opcje płatności akceptowane w danym miejscu. Miejsce akceptuje więcej niż
jedną opcję płatności. Jeśli dane opcji płatności są niedostępne,
pole opcji płatności zostanie odznaczone. Dostępne opcje:
|
parkingOptions |
Parking jest dostępny w hotelu. Dostępne opcje:
|
subDestinations |
Wyjątkowe miejsca związane z konkretnym miejscem. Dla: np. terminale lotniskowe są uznawane za podrzędne miejsca docelowe na lotnisku. |
fuelOptions |
Najnowsze informacje o opcjach paliwowych dostępnych na
stacji benzynowej. Te informacje są regularnie aktualizowane. Dostępne opcje:
następujące:
|
evChargeOptions |
Liczba ładowarki pojazdów elektrycznych (EV) na tej stacji. Choć niektóre ładowarki pojazdów elektrycznych mają wiele złączy, a każda ładowarka może ładuj jeden pojazd naraz; w rezultacie to pole odzwierciedla liczby dostępnych ładowarek EV w danym momencie. |
shortFormattedAddress |
Krótki, zrozumiały dla człowieka adres miejsca. |
primaryType |
Podstawowy typ danego wyniku. Na przykład miejsce może
sklasyfikowana jako cafe lub airport . O
miejsce może mieć tylko jeden typ główny. Pełną listę
możliwe wartości znajdziesz w sekcji Obsługiwane typy. |
primaryTypeDisplayName |
Wyświetlana nazwa typu głównego zlokalizowana w związku z żądaniem (w stosownych przypadkach). Pełną listę możliwych wartości znajdziesz zobacz Obsługiwane typy plików. |
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 z nowych interfejsów API, zapoznaj się z tą dokumentacją migracji: