Informacje o interfejsie Places API (nowość)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Interfejs Places API (nowy) obejmuje te interfejsy API:

Ten dokument zawiera omówienie tych nowych interfejsów API.

Informacje o miejscu (nowe)

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 miejsca zainteresowania, wysyłając żądanie informacje 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ć:

Zdjęcia miejsca (nowe)

Interfejs Zdjęcia miejsca (nowe) umożliwia dodawanie do aplikacji treści fotograficznych wysokiej jakości, ponieważ daje dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc Google. Za pomocą interfejsu Zdjęcia miejsca (nowe) możesz uzyskać dostęp do zdjęć i zmienić ich rozmiar na optymalny dla Twojej aplikacji.

Wszystkie żądania do interfejsu Place Photos (nowe) 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 (nowe), Wyszukaj tekst (nowe) lub Wyszukiwanie w pobliżu (nowe), dodaj pole photos do maski pola żądania.

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

Interfejs Places API obejmuje 2 interfejsy wyszukiwania:

  • Wyszukiwanie tekstu (nowe)

    Umożliwia określenie ciągu tekstowego, na podstawie którego ma zostać wyszukane miejsce. Na przykład: „Spicy Vegetarian Food in Sydney, Australia” lub „Fine seafood dining near Palo Alto, CA”.

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

  • Wyszukiwanie w pobliżu (nowe)

    Umożliwia określenie regionu, w którym ma zostać przeprowadzone wyszukiwanie, oraz listy 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 określ „pizza_restaurant” i „shopping_mall”, aby wyszukać pizzerię znajdującą się w centrum handlowym w określonym regionie.

Główna różnica między tymi 2 wyszukiwaniami polega na tym, że interfejs Wyszukiwanie tekstu (nowe) umożliwia określenie dowolnego ciągu wyszukiwania, a interfejs Wyszukiwanie w pobliżu (nowe) wymaga podania konkretnego obszaru, w którym ma zostać przeprowadzone 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 określ ciąg wyszukiwania tekstu i granice geograficzne, które kontrolują obszar wyszukiwania.

Tokeny sesji to generowane przez użytkownika ciągi znaków, które śledzą wywołania interfejsu Autouzupełnianie (nowe) jako sesje. Interfejs Autouzupełnianie (nowe) używa tokenów sesji do grupowania fazy zapytania i wyboru w wyszukiwaniu 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 miejscu. Te aspekty są opisane w kolejnych sekcjach.

Pola

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

Pole Opis
regularSecondaryOpeningHours Opisuje konkretne godziny niektórych operacji. Dodatkowe godziny otwarcia różnią się od głównych godzin otwarcia firmy. Na przykład restauracja może określić godziny otwarcia drive-thru lub godziny dostawy jako godziny dodatkowe.
paymentOptions Opcje płatności akceptowane w danym miejscu. Miejsce może akceptować więcej niż 1 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 konkretnym miejscem. Na przykład terminale lotniskowe są uważane za miejsca docelowe lotniska.
fuelOptions Najnowsze informacje o opcjach paliwa dostępnych na stacji benzynowej. Te informacje są regularnie aktualizowane. Dostępne opcje:
  • Olej napędowy
  • 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 do pojazdów elektrycznych mają wiele złączy, ale każda ładowarka może ładować tylko 1 pojazd naraz. W związku z tym to pole odzwierciedla liczbę dostępnych ładowarek do pojazdów elektrycznych 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 1 typ podstawowy. Pełną listę możliwych wartości znajdziesz w artykule Obsługiwane typy.
primaryTypeDisplayName Wyświetlana nazwa typu podstawowego, zlokalizowana na język żądania, jeśli to możliwe. Pełną listę możliwych wartości, zobacz Obsługiwane typy.

Atrybuty

Interfejs Places API (nowy) zawiera kilka nowych atrybutów:

Atrybut Opis
outdoorSeating Miejsce oferuje miejsca na zewnątrz.
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 odpowiednie dla dzieci.
allowsDogs Miejsce akceptuje psy.
restroom Miejsce ma toaletę.
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 na wózkach.
wheelchairAccessibleEntrance Miejsce ma wejście dla osób na wózkach.
wheelchairAccessibleRestroom Miejsce ma toaletę 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) wykorzystują funkcje modelu Gemini do zwracania podsumowań miejsc i obszarów, które mogą pomóc użytkownikom w podjęciu decyzji, gdzie się udać.

Podsumowania oparte na AI syntetyzują dane z różnych źródeł, aby pomóc użytkownikom w podejmowaniu bardziej świadomych decyzji dotyczących miejsca. Jeśli na przykład zastanawiasz się nad wypróbowaniem nowej restauracji, podsumowanie oparte na AI może wskazać najpopularniejsze pozycje w menu, dać Ci wyobrażenie o atmosferze 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 (nowego)

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

  • Podsumowania miejsc, czyli krótkie podsumowania dotyczące konkretnego miejsca.
  • Podsumowania opinii, czyli krótkie podsumowania tego, co recenzenci powiedzieli o danym miejscu.
  • Podsumowania obszarów, które zawierają informacje o pobliskich i popularnych miejscach w okolicy. Obejmują one podsumowania okolic i podsumowania stacji ładowania EV.

Google często generuje te podsumowania, aby były aktualne na podstawie najnowszych dostępnych informacji. Gdy wyślesz żądanie do interfejsu Places API (nowego), w aplikacji wyświetlą się najnowsze dane.

Migracja do nowych interfejsów Places API

Jeśli jesteś dotychczasowym klientem interfejsu Places API (nowego) i chcesz przenieść swoją aplikację na korzystanie z nowych interfejsów API, zapoznaj się z tymi dokumentami dotyczącymi migracji: