Method: places.get

Uzyskaj szczegółowe informacje o miejscu na podstawie jego nazwy zasobu, która jest ciągiem tekstowym 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: 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 lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, takich jak nazwa miejsca w danym regionie (jeśli jest dostępna). Parametr może wpływać na wyniki w zależności od 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 3-cyfrowe kody regionów nie są obecnie obsługiwane.

sessionToken

string

Opcjonalnie: Ciąg tekstowy identyfikujący sesję Autouzupełniania na potrzeby rozliczeń. Musi być bezpiecznym ciągiem znaków w formacie base64, który może zawierać maksymalnie 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT.

Sesja rozpoczyna się, gdy użytkownik zacznie wpisywać zapytanie, a kończy, gdy wybierze miejsce i wywoła szczegóły miejsca lub weryfikację adresu. Każda sesja może zawierać wiele zapytań, po których następuje jedno żądanie dotyczące szczegółów miejsca docelowego lub weryfikacji adresu. Identyfikatory zastosowane do każdego żądania w ramach sesji muszą należeć do tego samego projektu w Google Cloud Console. Po zakończeniu sesji token nie jest już ważny. Aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr sessionToken zostanie pominięty lub jeśli token sesji zostanie użyty ponownie, sesja zostanie obciążona tak, jakby nie podano tokena sesji (za każde żądanie naliczana jest opłata).

Zalecamy przestrzeganie tych wskazówek:

  • Używaj tokenów sesji we wszystkich wywołaniach autouzupełniania w Google Places.
  • generować nowy token dla każdej sesji; Zalecamy używanie identyfikatora UUID w wersji 4.
  • Upewnij się, że dane logowania używane do wszystkich żądań autouzupełniania, szczegółów miejsca i weryfikacji adresu w ramach sesji należą do tego samego projektu w Cloud Console.
  • Pamiętaj, aby w przypadku każdej nowej sesji przekazać unikalny token sesji. Użycie tego samego tokena w więcej niż 1 sesji spowoduje, że za każde żądanie zostanie naliczona osobna opłata.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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