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 szczegóły dotyczące konkretnego obiektu lub punktu orientacyjnego, wysyłając żądanie Szczegóły miejsca (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 miejsc (nowość)

Zdjęcia miejsc (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 tekstowe (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 wyszukiwanie tekstowe (nowe) umożliwia określenie dowolnego ciągu wyszukiwania, a wyszukiwanie w pobliżu (nowe) wymaga podania konkretnego obszaru, w którym ma się odbywać wyszukiwanie.

Autouzupełnianie (nowe) i tokeny sesji

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

Tokeny sesji to wygenerowane przez użytkownika ciągi znaków, które śledzą wywołania Autocomplete (New) 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 są opisane 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 obsługi w ramach 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 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 są te opcje:
  • 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 W tym miejscu można zjeść deser.
servesCoffee Miejsce serwuje kawę.
goodForChildren Miejsce odpowiednie dla dzieci.
allowsDogs Można wejść z psem.
restroom W miejscu znajduje się 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 (nowość) 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 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 miejsc. Jeśli na przykład zastanawiasz się nad wypróbowaniem nowej restauracji, 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ń.

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

Podsumowania oparte na AI są obsługiwane przez te usługi: Szczegóły miejsca (nowość), Wyszukiwanie tekstowe (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ą łatwymi do przyswojenia 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 zawierały najnowsze dostępne informacje. Gdy wysyłasz żądanie do interfejsu Places API (nowego), w aplikacji wyświetlają się najnowsze dane.

Przechodzenie na nowe interfejsy Places API

Jeśli korzystasz już z interfejsu Places API (nowego) i chcesz przenieść aplikację, aby używać nowych interfejsów API, zapoznaj się z tą dokumentacją migracji: