Informacje o interfejsie Places API (nowość)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

Ten dokument zawiera omówienie 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 informacji o miejscu (nowe) zwraca kompleksowe informacje o wskazanym 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ę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. Korzystając z interfejsu Place Photos (New), 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ść)

Places API (nowość) 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 „Wykwintne 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ć faworyzowane w określonej lokalizacji, lub ograniczyć wyszukiwanie do konkretnej lokalizacji.

  • Wyszukiwanie w pobliżu (nowość)

    Umożliwia określenie regionu 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 cechy. 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 chcesz wyszukiwać.

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 zapytań. W żądaniu podaj ciąg tekstowy wyszukiwania i granice geograficzne, które kontrolują obszar wyszukiwania.

Tokeny sesji to wygenerowane przez użytkownika ciągi znaków, 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

Places API (nowość) 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 drive-through lub dostawy jako godziny dodatkowe.
paymentOptions Opcje płatności akceptowane w tym miejscu. Miejsce może akceptować więcej niż jedną formę płatności. Jeśli dane formy 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 podrzędne miejsca docelowe lotniska.
fuelOptions Najnowsze informacje o rodzajach paliwa dostępnych na stacji benzynowej. 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 (EV) na tej stacji. Niektóre ładowarki EV mają wiele złączy, ale każda z nich może ładować tylko jeden 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, przetłumaczona na język żądania (w stosownych przypadkach). Pełną listę możliwych wartości znajdziesz w artykule Obsługiwane typy.
entrances wejścia do miejsca docelowego; Wejście to pojedyncza para współrzędnych geograficznych (szerokość i długość), która określa lokalizację punktu wejścia i wyjścia z miejsca.
navigationPoints Punkty nawigacyjne do miejsca docelowego. Punkt nawigacyjny to miejsce obok drogi, w którym może zakończyć się nawigacja, w tym obsługiwane tryby podróży i sposoby korzystania.

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 oferuje parking dostępny dla osób na wózkach.
wheelchairAccessibleEntrance Miejsce ma wejście dostępne 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 możliwości modelu Gemini, aby zwracać podsumowania dotyczące 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 danego miejsca. Jeśli na przykład chcesz wypróbować nową restaurację, podsumowanie oparte na AI może wyświetlić 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ć przegląd pobliskich atrakcji i udogodnień.

Dodanie funkcji opartych na AI do interfejsu Places API (nowość)

Podsumowania oparte na AI są obsługiwane przez te 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 dotyczące okolicy i stacji ładowania EV.

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

Przejście na Places API (nowość)

Jeśli korzystasz już z interfejsu Places API (starszego) i chcesz przenieść aplikację na interfejs Places API (nowy), zapoznaj się z tą dokumentacją migracji: