Method: places.get

Uzyskuj szczegółowe informacje o miejscu 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

To pole jest wymagane. Nazwa zasobu miejsca w formacie places/{placeId}.

Parametry zapytania

Parametry
languageCode

string

Opcjonalnie. Szczegóły miejsca będą wyświetlane w preferowanym języku (jeśli jest dostępny).

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

regionCode

string

Opcjonalnie. Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie. Służy on do wyświetlania szczegółowych informacji o miejscu, takich jak nazwa miejsca z danego regionu, jeśli jest dostępna. Parametr może wpływać na wyniki w zależności od obowiązującego prawa. Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów 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 adres URL i bezpieczny dla nazwy pliku ciąg base64 o długości nie większej niż 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja zaczyna się, gdy użytkownik zaczyna wpisywać zapytanie, a kończy się, gdy wybiera miejsce i wysyła żądanie informacji o miejscu lub weryfikacji adresu. Każda sesja może obejmować wiele zapytań, po których następuje 1 prośba o informacje o miejscu lub o weryfikację adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub ponownie użyjesz tokena sesji, opłata za sesję zostanie naliczona tak, jakby nie podano żadnego tokena sesji (każde żądanie jest rozliczane oddzielnie).

Zalecamy stosowanie tych wytycznych:

  • Używaj tokenów sesji dla wszystkich wywołań autouzupełniania miejsc.
  • Generuj nowy token dla każdej sesji. Zalecamy użycie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane we wszystkich żądaniach autouzupełniania miejsc, informacji o miejscu i weryfikacji adresu w ramach sesji należą do tego samego projektu Cloud Console.
  • 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 zostanie rozliczone indywidualnie.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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