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

Wymagany. 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, np. nazwy miejsca w danym regionie (jeśli jest dostępny). 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. Dane logowania używane w przypadku 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 pominiesz parametr sessionToken lub użyjesz ponownie tokenu sesji, sesja zostanie obciążona opłatą tak, jakby nie podano tokenu sesji (każda prośba jest rozliczana osobno).

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.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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