Informacje o interfejsie Places API (nowość)

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

Ten dokument zawiera opis tych nowych interfejsów API.

Informacje o miejscu (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 o konkretnym instytucji lub ciekawego miejsca poprzez zainicjowanie szczegółów miejsca (nowego); użytkownika. Żądanie Szczegóły miejsca (Nowe) zwraca kompleksowe informacje o wybranym miejscu, takie jak pełny adres, numer telefonu, ocena 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 umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych, zapewniając dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc Google. Za pomocą interfejsu API Zdjęcie miejsca (nowa wersja) możesz uzyskać dostęp do zdjęć i zmienić ich rozmiar na optymalny dla Twojej 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ć, używając:

Aby uwzględnić nazwę zasobu zdjęcia w odpowiedzi na żądanie dotyczące szczegółów miejsca (nowa wersja), wyszukiwania tekstowego (nowa wersja) lub wyszukiwania w pobliżu (nowa wersja), dodaj pole photos do maski pola żądania.

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

Interfejs Places API obejmuje dwa interfejsy API wyszukiwania:

  • Wyszukiwanie tekstu (nowa funkcja)

    Umożliwia określenie ciągu tekstowego, który będzie używany do wyszukiwania miejsca. Przykład: „Spicy wegetariański posiłek w Sydney w Australii” lub „Wyśmienite owoce morza w pobliżu Palo Alto w Kalifornii”.

    Możesz zawęzić wyszukiwanie, podając szczegóły, takie jak poziomy cen, aktualny stan otwarcia, oceny lub określone typy miejsc. 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 jako okrąg określony przez współrzędne geograficzne punktu środkowego i promień w metrach.

    Określ co najmniej 1 typ miejsca, który definiuje jego cechy. 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 (nowa wersja) to usługa internetowa, która zwraca prognozy miejsc i prognozy 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 (nowy) zawiera nowe pola, atrybuty i opcje ułatwień dostępu, aby zapewnić użytkownikom więcej informacji o danym miejscu. Te aspekty są opisane w dalszej części tego artykułu.

Pola

Interfejs Places API (nowość) 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. Na przykład restauracja może podać godziny otwarcia okienka drive-thru lub godziny dostawy jako godziny dodatkowe.
paymentOptions Opcje płatności akceptowane w danym miejscu. Miejsce może akceptować więcej niż jedną opcję płatności. Jeśli dane opcji płatności są niedostępne, pole opcji płatności będzie puste. Dostępne opcje:
  • Karta kredytowa
  • Karta debetowa
  • Płatność tylko gotówką
  • płatność NFC
parkingOptions Goście mogą korzystać z parkingu. Dostępne opcje:
  • Bezpłatne parkingi
  • płatne parkingi;
  • Bezpłatny parking przy ulicy
  • Parking z obsługą
  • Bezpłatny parking zadaszony
  • Płatny parking podziemny
subDestinations Unikalne miejsca powiązane z danym miejscem. Na przykład terminale lotniska są uważane za podmiejsca docelowe lotniska.
fuelOptions Najnowsze informacje o dostępnych rodzajach paliwa na stacji benzynowej. Te informacje są regularnie aktualizowane. Dostępne opcje:
  • Olej napędowy
  • bezołowiowa,
  • Ś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. Chociaż niektóre ładowarki EV mają kilka złączy, każda z nich może ładować tylko jedno pojazd naraz. W związku z tym to pole odzwierciedla liczbę dostępnych ładowarek EV w danym momencie.
shortFormattedAddress Krótki adres zrozumiały dla człowieka.
primaryType Główny 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żliwych wartości znajdziesz w artykule 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 w sekcji Obsługiwane typy.

Atrybuty

Nowy interfejs Places API zawiera kilka nowych atrybutów:

Atrybut Opis
outdoorSeating Miejsce ma miejsca do siedzenia na świeżym powietrzu.
liveMusic Miejsce oferuje muzykę na żywo.
menuForChildren Miejsce ma menu dla dzieci.
servesCocktails Miejsce serwuje koktajle.
servesDessert Miejsce serwuje 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 nadaje się do oglądania sportu.

Opcje ułatwień dostępu

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

Pole Opis
wheelchairAccessibleParking Miejsce oferuje parking dla osób na wózkach.
wheelchairAccessibleEntrance Wejście do obiektu jest przystosowane dla osób na wózku.
wheelchairAccessibleRestroom Na miejscu jest toaleta dla osób poruszających się na wózkach.
wheelchairAccessibleSeating Miejsce ma miejsca dla osób na wózkach.

Migracja do nowych interfejsów Places API

Jeśli jesteś klientem interfejsu Places API i chcesz przenieść swoją aplikację na nowe interfejsy API, zapoznaj się z tą dokumentacją migracji: