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 szczegółowe informacje o konkretnej firmie lub ważnym miejscu, wysyłając żądanie informacji o miejscu (nowe). Żądanie informacji o miejscu (nowe) zwraca wyczerpujące 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ć:

Place Photos (New)

Zdjęcia miejsc (nowa wersja) umożliwiają dodawanie do aplikacji wysokiej jakości zdjęć 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ą:

Aby uwzględnić nazwę zasobu zdjęcia w odpowiedzi na żądanie informacji o miejscu (nowa wersja), wyszukiwania tekstowego (nowa wersja) lub wyszukiwania w pobliżu (nowa wersja), upewnij się, że w masce pola żądania znajduje się pole photos.

Wyszukiwanie tekstu (nowe) i Wyszukiwanie w pobliżu (nowe)

Places API (nowość) obejmuje 2 interfejsy API wyszukiwania:

  • Text Search (New)

    Umożliwia określenie ciągu tekstowego, na podstawie którego ma zostać wyszukane miejsce. Na przykład: „Pikantne jedzenie wegetariańskie w Sydney, Australia” lub „Wykwintne owoce morza w pobliżu Palo Alto, Kalifornia”.

    Możesz zawęzić wyszukiwanie, podając szczegóły, takie jak poziomy cen, aktualny stan otwarcia, oceny lub konkretne typy miejsc. Możesz też określić, czy wyniki mają być dostosowane do konkretnej lokalizacji, lub ograniczyć wyszukiwanie do konkretnej lokalizacji.

  • Nearby Search (New)

    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 cechy miejsca. Na przykład podaj „pizza_restaurant” i „shopping_mall”, aby wyszukać pizzerię w centrum handlowym w określonym regionie.

Główna różnica między tymi 2 rodzajami wyszukiwania polega na tym, że wyszukiwanie tekstowe (nowe) umożliwia podanie dowolnego ciągu wyszukiwania, a wyszukiwanie w pobliżu (nowe) wymaga określenia konkretnego obszaru wyszukiwania.

Autouzupełnianie (nowe) i tokeny sesji

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

Tokeny sesji to generowane 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 wyszukiwania z autouzupełnianiem przez użytkownika w osobną sesję na potrzeby rozliczeń.

Nowe pola, atrybuty i opcje ułatwień dostępu

Places API (New) zawiera nowe pola, atrybuty i opcje ułatwień dostępu, dzięki którym użytkownicy mogą uzyskać więcej informacji o miejscu. Te aspekty opisujemy w kolejnych sekcjach.

Pola

Interfejs Places API (nowy) zawiera kilka nowych pól:

Pole Opis
regularSecondaryOpeningHours Określa konkretne godziny dla niektórych operacji. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny obsługi drive-through lub dostawy jako dodatkowe godziny otwarcia.
paymentOptions Formy płatności akceptowane w danym miejscu. W danym miejscu może być akceptowana więcej niż 1 forma płatności. Jeśli dane o formie płatności są niedostępne, pole formy płatności nie zostanie ustawione. 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 konkretnym miejscem. Na przykład terminale lotniska są uważane za miejsca docelowe podrzędne względem lotniska.
fuelOptions Najnowsze informacje o opcjach paliwa dostępnych na stacji benzynowej. Te informacje są regularnie aktualizowane. Dostępne opcje:
  • Olej napędowy
  • Zwykła benzyna bezołowiowa
  • Średniooktanowa
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • Metan
  • Biodiesel
  • Olej napędowy do ciężarówek
evChargeOptions Liczba ładowarek do pojazdów elektrycznych na tej stacji. Niektóre ładowarki EV mają kilka złączy, ale każda z nich może ładować tylko jeden pojazd naraz. Dlatego 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 główny. Pełną listę możliwych wartości znajdziesz w sekcji Obsługiwane typy.
primaryTypeDisplayName Wyświetlana nazwa typu podstawowego, w razie potrzeby przetłumaczona na język żądania. Pełną listę możliwych wartości znajdziesz w sekcji Obsługiwane typy.
entrances Wejścia do miejsca docelowego. Wejście to pojedyncza para współrzędnych szerokości i długości geograficznej, która określa lokalizację punktu wejścia i wyjścia z miejsca.
navigationPoints Punkty nawigacyjne miejsca docelowego. Punkt nawigacyjny to lokalizacja obok drogi, w której może zakończyć się nawigacja, w tym obsługiwane środki transportu i zastosowania.

Atrybuty

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

Atrybut Opis
outdoorSeating W miejscu tym dostępna jest strefa wypoczynkowa na świeżym powietrzu.
liveMusic W miejscu można posłuchać muzyki na żywo.
menuForChildren W tym miejscu jest menu dla dzieci.
servesCocktails W tym miejscu można wypić koktajl.
servesDessert W tym miejscu można zjeść deser.
servesCoffee W tym miejscu można napić się kawy.
goodForChildren Miejsce jest odpowiednie dla dzieci.
allowsDogs Można wejść z psem.
restroom W miejscu jest toaleta.
goodForGroups Miejsce jest odpowiednie dla grup.
goodForWatchingSports Miejsce jest odpowiednie 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 poruszających się na wózku.
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 poruszających się na wózku.
wheelchairAccessibleSeating Miejsce ma miejsca siedzące dostępne dla osób poruszających się na wózku.

Podsumowania oparte na AI

Podsumowania oparte na AI w Places API (New) wykorzystują możliwości modelu Gemini, aby zwracać podsumowania dotyczące miejsc i obszarów, które mogą pomóc użytkownikom zdecydować, gdzie się udać.

Podsumowania oparte na AI syntetyzują dane z różnych źródeł, aby pomóc użytkownikom podejmować bardziej świadome decyzje dotyczące miejsc. Jeśli na przykład zastanawiasz się nad wypróbowaniem nowej restauracji, podsumowanie oparte na AI może wyświetlić najpopularniejsze dania z menu, dać Ci wyobrażenie o atmosferze lub zebrać motywy z opinii użytkowników. Jeśli odwiedzasz nowe miasto, podsumowanie oparte na AI może dostarczyć Ci informacji o pobliskich atrakcjach i udogodnieniach.

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

Podsumowania oparte na AI są obsługiwane przez informacje o miejscu (nowe), Wyszukiwanie tekstowe (nowe) i Wyszukiwanie w pobliżu (nowe). W odpowiedziach Places API (New) dostępne są te podsumowania oparte na AI:

  • Podsumowania miejsc, które są krótkimi podsumowaniami dotyczącymi konkretnego miejsca.
  • podsumowania opinii, które są łatwymi do przyswojenia podsumowaniami tego, co użytkownicy powiedzieli o danym miejscu;
  • Podsumowania obszaru, które zawierają przegląd pobliskich i popularnych miejsc w okolicy. Obejmują one podsumowania dotyczące okolicy i stacji ładowania EV.

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

Migracja do Places API (nowość)

Jeśli jesteś już klientem Places API (starsza wersja) i chcesz przenieść aplikację do Places API (nowość), zapoznaj się z tą dokumentacją dotyczącą migracji: