Informacje o interfejsie Places API (nowość)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Places API (nowość) obejmuje te interfejsy API:

Ten dokument zawiera opis tych nowych interfejsów API.

Informacje o miejscu (nowość)

Identyfikator miejsca jednoznacznie identyfikuje miejsce w bazie danych Miejsc Google i w Mapach Google. Za pomocą identyfikatora miejsca możesz poprosić o informacje o miejscu dotyczące konkretnego obiektu lub ważnego miejsca, wysyłając żądanie informacje o miejscu (nowe). Żądanie Place Details (New) zwraca kompleksowe informacje o wskazanym miejscu, takie jak pełny adres, numer telefonu, oceny i opinie użytkowników.

Identyfikator miejsca można uzyskać na wiele sposobów. Możesz użyć:

Zdjęcia miejsca (nowość)

Place Photos (nowość) umożliwiają dodawanie do aplikacji wysokiej jakości treści fotograficznych dzięki dostępowi do milionów zdjęć przechowywanych w bazie danych Miejsc Google. Za pomocą interfejsu Place Photos (New) API możesz uzyskać dostęp do zdjęć i zmienić ich rozmiar na optymalny dla Twojej aplikacji.

Wszystkie żądania wysyłane do interfejsu Place Photos (New) API muszą zawierać nazwę zasobu zdjęcia, która jednoznacznie identyfikuje zdjęcie do zwrócenia. Nazwę zasobu zdjęcia możesz uzyskać za pomocą tego polecenia:

Aby uwzględnić nazwę zasobu zdjęcia w odpowiedzi na żądanie Szczegóły miejsca (nowe), Wyszukiwanie tekstowe (nowe) lub Wyszukiwanie w pobliżu (nowe), w masce pola żądania uwzględnij pole photos.

Wyszukiwanie tekstu (nowość) i wyszukiwanie w pobliżu (nowość)

Interfejs Places API obejmuje 2 interfejsy wyszukiwania:

  • Wyszukiwanie tekstowe (nowość)

    Umożliwia określenie ciągu tekstowego, na podstawie którego ma zostać wyszukane miejsce. Na przykład: „Pikantne dania wegetariańskie w Sydney w Australii” lub „Eleganckie restauracje serwujące owoce morza w pobliżu Palo Alto w Kalifornii”.

    Możesz zawęzić wyszukiwanie, podając szczegóły, takie jak przedział cenowy, aktualny stan otwarcia, oceny lub konkretne typy miejsc. Możesz też określić, czy wyniki mają być bardziej dopasowane do konkretnej lokalizacji, lub ograniczyć 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 geograficzne punktu środkowego i promień w metrach.

    Określ co najmniej 1 typ miejsca, który definiuje jego charakterystykę. Na przykład wpisz „pizza_restaurant” i „shopping_mall”, aby wyszukać pizzerię w centrum handlowym w określonym regionie.

Główna różnica między tymi dwoma wyszukiwaniami polega na tym, że w przypadku wyszukiwania tekstowego (nowego) możesz określić dowolny ciąg wyszukiwania, a w przypadku wyszukiwania w pobliżu (nowego) musisz podać konkretny obszar, w którym ma się odbywać wyszukiwanie.

Autouzupełnianie (nowe) i tokeny sesji

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

Tokeny sesji to ciągi znaków generowane przez użytkownika, które śledzą wywołania Autouzupełniania (nowego) jako sesje. Autouzupełnianie (nowe) używa tokenów sesji do grupowania faz zapytania i wyboru w wyszukiwaniu autouzupełniania użytkownika w osobną 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, które dostarczają użytkownikom więcej informacji o miejscu. Te aspekty opisujemy w kolejnych sekcjach.

Pola

Interfejs Places API (nowy) 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 restauracja może określić godziny otwarcia dla klientów zmotoryzowanych 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 zostanie wyczyszczone. 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 określonym miejscem; Na przykład terminale lotniskowe są uważane za miejsca docelowe podrzędne względem lotniska.
fuelOptions Najnowsze informacje o rodzajach paliwa dostępnych na stacji paliw. Te informacje są regularnie aktualizowane. Dostępne opcje to:
  • Olej napędowy
  • Regular unleaded
  • Średniooktanowa
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • Metan
  • Biodiesel
  • Diesel do ciężarówek
evChargeOptions Liczba ładowarek do pojazdów elektrycznych na tej stacji. Niektóre ładowarki EV mają wiele złączy, ale każda z nich może ładować tylko 1 pojazd naraz. W związku z tym to pole odzwierciedla liczbę dostępnych ładowarek EV w danym momencie.
shortFormattedAddress Krótki, zrozumiały dla człowieka adres miejsca.
primaryType Główny typ danego wyniku. Na przykład miejsce może być sklasyfikowane jako cafe lub airport. Miejsce może mieć tylko jeden typ podstawowy. Pełną listę możliwych wartości znajdziesz w artykule Obsługiwane typy.
primaryTypeDisplayName Wyświetlana nazwa typu podstawowego, zlokalizowana w języku żądania (w stosownych przypadkach). Pełną listę możliwych wartości znajdziesz w artykule Obsługiwane typy.

Atrybuty

Places API (nowość) zawiera kilka nowych atrybutów:

Atrybut Opis
outdoorSeating Dostępne są miejsca do siedzenia na świeżym powietrzu.
liveMusic W tym miejscu można posłuchać muzyki na żywo.
menuForChildren Miejsce ma menu dla dzieci.
servesCocktails W tym miejscu serwowane są koktajle.
servesDessert Miejsce serwuje desery.
servesCoffee Miejsce serwuje kawę.
goodForChildren Miejsce jest odpowiednie dla dzieci.
allowsDogs Można wejść z psem.
restroom W tym miejscu jest toaleta.
goodForGroups Miejsce jest przystosowane do obsługi grup.
goodForWatchingSports Miejsce nadaje się do oglądania sportu.

Opcje ułatwień dostępu

Interfejs Places API (nowy) zawiera te pola opcji ułatwień dostępu:

Pole Opis
wheelchairAccessibleParking Miejsce ma parking dostępny dla osób na wózkach.
wheelchairAccessibleEntrance Miejsce ma wejście dla osób poruszających się na wózku.
wheelchairAccessibleRestroom Miejsce ma toaletę dostępną dla osób na wózkach.
wheelchairAccessibleSeating Miejsce ma miejsca dla osób na wózkach.

Podsumowania oparte na AI

Podsumowania oparte na AI w interfejsie Places API (nowym) korzystają z funkcji modelu Gemini, aby zwracać podsumowania miejsc i obszarów, które mogą pomóc użytkownikom w podjęciu decyzji, gdzie się wybrać.

Podsumowania oparte na AI syntetyzują dane z różnych źródeł, aby pomagać użytkownikom w podejmowaniu bardziej świadomych decyzji dotyczących miejsc. Jeśli na przykład zastanawiasz się nad wypróbowaniem nowej restauracji, podsumowanie oparte na AI może wyróżnić najpopularniejsze pozycje w menu, dać Ci wyobrażenie o atmosferze panującej w lokalu lub zebrać tematy z opinii użytkowników. Jeśli odwiedzasz nowe miasto, podsumowanie oparte na AI może zawierać informacje o pobliskich atrakcjach i udogodnieniach.

Funkcje oparte na AI dodane do interfejsu Places API (nowość)

Podsumowania oparte na AI są obsługiwane przez usługi informacje o miejscu (nowość), Wyszukaj tekst (nowość) i Wyszukiwanie w pobliżu (nowość). W odpowiedziach interfejsu Places API (New) dostępne są te podsumowania oparte na AI:

  • Podsumowania miejsc, czyli krótkie podsumowania dotyczące konkretnego miejsca.
  • Podsumowania opinii, które są krótkimi streszczeniami tego, co użytkownicy napisali o danym miejscu.
  • Podsumowania obszarów, które zawierają przegląd pobliskich i popularnych miejsc w okolicy. Obejmują one podsumowania dzielnic i stacji ładowania EV.

Google często odświeża te podsumowania, aby były aktualne i oparte na najnowszych dostępnych informacjach. Gdy wysyłasz żądanie do interfejsu Places API (nowego), w aplikacji wyświetlają się najnowsze dane.

Przechodzenie na nowe interfejsy Places API

Jeśli jesteś obecnym klientem interfejsu Places API (nowego) i chcesz przenieść aplikację, aby korzystać z nowych interfejsów API, zapoznaj się z tą dokumentacją migracji: