Method: places.get

Получите подробную информацию о месте на основе его имени ресурса, которое представляет собой строку в формате places/{placeId} .

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Обязательно. Название ресурса места в формате places/{placeId} .

Параметры запроса

Параметры
languageCode

string

(Необязательно) Информация о месте будет отображаться на предпочитаемом языке, если он доступен.

Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .

regionCode

string

Необязательный параметр. Код страны/региона Unicode (CLDR) местоположения, откуда поступает запрос. Этот параметр используется для отображения сведений о месте, таких как региональное название места, если таковое имеется. Параметр может влиять на результаты в зависимости от применимого законодательства. Для получения дополнительной информации см. https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html .

Обратите внимание, что трехзначные региональные коды в настоящее время не поддерживаются.

sessionToken

string

Необязательный параметр. Строка, идентифицирующая сессию автозаполнения для целей выставления счетов. Должна представлять собой безопасную для URL-адресов и имен файлов строку в формате base64 длиной не более 36 символов ASCII. В противном случае возвращается ошибка INVALID_ARGUMENT.

Сессия начинается, когда пользователь начинает вводить запрос, и завершается, когда он выбирает место и выполняется вызов функции проверки сведений о месте или адреса. Каждая сессия может содержать несколько запросов, за которыми следует один запрос на проверку сведений о месте или адреса. Учетные данные, используемые для каждого запроса в рамках сессии, должны принадлежать одному и тому же проекту Google Cloud Console. После завершения сессии токен становится недействительным; ваше приложение должно генерировать новый токен для каждой сессии. Если параметр sessionToken опущен или если вы повторно используете токен сессии, оплата за сессию производится так, как если бы токен сессии не был предоставлен (каждый запрос оплачивается отдельно).

Мы рекомендуем следующие рекомендации:

  • Используйте токены сессии для всех вызовов функции автозаполнения.
  • Для каждой сессии генерируйте новый токен. Рекомендуется использовать UUID версии 4.
  • Убедитесь, что учетные данные, используемые для всех запросов автозаполнения места, сведений о месте и проверки адреса в рамках одной сессии, относятся к одному и тому же проекту Cloud Console.
  • Обязательно передавайте уникальный токен сессии для каждой новой сессии. Использование одного и того же токена для нескольких сессий приведет к тому, что каждый запрос будет оплачиваться отдельно.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

В случае успеха тело ответа содержит экземпляр объекта Place .

Области полномочий

Требуется один из следующих диапазонов аутентификации 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