Method: places.get

Pobierz szczegóły miejsca na podstawie jego nazwy zasobu, która jest ciągiem znaków w formacie places/{placeId}.

Żądanie HTTP

GET https://places.googleapis.com/v1/{name=places/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu miejsca w formacie places/{placeId}.

Parametry zapytania

Parametry
languageCode

string

Opcjonalnie. Jeśli są dostępne, szczegóły miejsca będą wyświetlane w preferowanym języku.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opcjonalnie. Kod kraju/regionu Unicode (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. Parametr może wpływać na wyniki na podstawie obowiązujących przepisów. Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że kody regionów składające się z 3 cyfr nie są obecnie obsługiwane.
sessionToken

string

Opcjonalnie. Ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny dla adresu URL i nazwy pliku ciąg znaków w formacie base64 o długości nieprzekraczającej 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja rozpoczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybierze miejsce i wywoła funkcję informacje o miejscu lub Weryfikacja adresów. Każda sesja może zawierać wiele zapytań, po których następuje 1 żądanie informacji o miejscu lub Weryfikacji adresów. Dane logowania używane w każdym żądaniu w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli użyjesz ponownie tokena sesji, sesja zostanie obciążona tak, jakby nie podano tokena sesji (każde żądanie jest rozliczane osobno).

Zalecamy stosowanie się do tych wytycznych:

  • Używaj tokenów sesji w przypadku wszystkich wywołań autouzupełniania miejsc.
  • Generuj nowy token dla każdej sesji. Zalecamy używanie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane w przypadku wszystkich żądań autouzupełniania miejsc, informacji o miejscu i weryfikacji adresów w ramach sesji należą do tego samego projektu w konsoli Cloud.
  • Pamiętaj, aby przekazywać unikalny token sesji dla każdej nowej sesji. Używanie tego samego tokena w więcej niż 1 sesji spowoduje, że każde żądanie będzie rozliczane osobno.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Place.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform