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 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ć:

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:
  • 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. 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:
  • Olej napędowy
  • 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. 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: