Informacje o interfejsie Places API (nowość)

Interfejs Places API (nowy) obejmuje te 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óły dotyczące konkretnego obiektu lub punktu użyteczności publicznej, inicjując żądanie Szczegóły miejsca (nowe). Żą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 (nowość)

Interfejs Place Photo (New) API umożliwia dodawanie do aplikacji wysokiej jakości treści fotograficznych dzięki dostępowi do milionów zdjęć przechowywanych w bazie danych Google Places. 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 z zdjęciem w odpowiedzi na żądanie dotyczące szczegółów miejsca (nowej), wyszukiwania tekstowego (nowej) lub wyszukiwania w pobliżu (nowej), dodaj pole photos do maski pola żądania.

Wyszukaj tekst (nowość) i Wyszukiwanie w pobliżu (nowość)

Interfejs Places API obejmuje 2 interfejsy wyszukiwania:

  • Wyszukiwanie tekstu (nowa funkcja)

    Umożliwia określenie ciągu tekstowego, na podstawie którego ma zostać wyszukane miejsce. 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ż określić, aby wyniki były bardziej trafne dla konkretnej lokalizacji lub ograniczyć wyszukiwanie do konkretnej lokalizacji.

  • Wyszukiwanie w pobliżu (nowość)

    Umożliwia określenie regionu do wyszukiwania oraz listy 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. Na przykład, aby wyszukać restaurację serwującą pizzę w centrum handlowym w określonym regionie, użyj parametrów „pizza_restaurant” i „shopping_mall”.

Główna różnica między tymi dwoma rodzajami wyszukiwania polega na tym, że wyszukiwanie tekstowe (nowa wersja) umożliwia określenie dowolnego ciągu znaków, a wyszukiwanie w pobliżu (nowa wersja) wymaga wskazania konkretnego obszaru wyszukiwania.

Autouzupełnianie (nowe) i tokeny sesji

Autouzupełnianie (nowy) to usługa internetowa, która zwraca prognozy miejsc i prognozy zapytań w odpowiedzi na żądanie HTTP. W żądaniu podaj tekstowy ciąg wyszukiwania i granice geograficzne określające obszar wyszukiwania.

Tokeny sesji to ciągi znaków utworzone przez użytkownika, które śledzą wywołania autouzupełniania (Nowe) jako sesje. Autouzupełnianie (nowa wersja) używa tokenów sesji, aby grupować fazy zapytania i wyboru w ramach wyszukiwania autouzupełniania użytkownika w oddzielną sesję na potrzeby rozliczeń.

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 następnych sekcjach.

Pola

Interfejs Places API (nowość) zawiera kilka nowych pól:

Pole Opis
regularSecondaryOpeningHours Opisuje konkretne godziny dla określonych operacji. Godziny otwarcia w przypadku firmy, w której godziny otwarcia różnią się od głównych godzin otwarcia. Na przykład restauracja może podać godziny otwarcia okienka drive-thru lub godziny dostawy jako godziny dodatkowe.
paymentOptions opcje płatności akceptowane przez daną firmę. 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 opcje parkowania oferowane przez miejsce. 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 zadaszony
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
  • Ciężarówka na olej napędowy
evChargeOptions Liczba ładowarek do pojazdów elektrycznych 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ótka, zrozumiała dla człowieka nazwa adresu miejsca.
primaryType Główny typ danego wyniku. Miejsce może na przykład zostać sklasyfikowane jako cafe lub airport. Miejsce może mieć tylko jeden podstawowy typ. Pełną listę możliwych wartości znajdziesz w artykule Obsługiwane typy.
primaryTypeDisplayName Wyświetlana nazwa głównego typu, zlokalizowana pod kątem języka żądania (w stosownych przypadkach). Pełną listę możliwych wartości znajdziesz w sekcji Obsługiwane typy.

Atrybuty

Interfejs Places API (nowy) 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 Miejsce jest dobre dla dzieci.
allowsDogs Miejsce, w którym można wejść z psem.
restroom Miejsce ma toaletę.
goodForGroups Miejsce dostosowane do grup.
goodForWatchingSports Miejsce odpowiednie do oglądania sportu.

Opcje ułatwień dostępu

Interfejs Places API (nowa wersja) zawiera te 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 Toaleta jest dostępna dla osób 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: