Сведения о месте (новое)

Выберите платформу: Android iOS Веб-служба JavaScript

Получив идентификатор места , вы можете запросить более подробную информацию о конкретном заведении или достопримечательности, инициировав запрос сведений о месте (новое) . Запрос «Сведения о месте (новое)» возвращает более полную информацию об указанном месте, такую ​​как его полный адрес, номер телефона, рейтинг пользователей и отзывы.

Есть много способов получить идентификатор места. Вы можете использовать:

API Explorer позволяет вам делать запросы в реальном времени, чтобы вы могли ознакомиться с API и опциями API:

Попробуйте!

Запросы сведений о месте (новые)

Запрос сведений о месте — это HTTP-запрос GET в форме:

https://places.googleapis.com/v1/places/PLACE_ID

Передайте все параметры как параметры URL или в заголовках как часть запроса GET. Например:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Или в команде cURL: 

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Детали места (новое) ответы

Place Details (New) возвращает в качестве ответа объект JSON . В ответ:

  • Ответ представлен объектом Place . Объект Place содержит подробную информацию о месте.
  • FieldMask , переданный в запросе, определяет список полей, возвращаемых в объекте Place .

Полный объект JSON имеет вид: 

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Обязательные параметры

  • Маска поля

    Укажите список полей, которые будут возвращены в ответе, создав маску поля ответа . Передайте маску поля ответа методу, используя параметр URL $fields или fields или HTTP-заголовок X-Goog-FieldMask . В ответе нет списка возвращаемых полей по умолчанию. Если вы опустите маску поля, метод вернет ошибку.

    Маскирование полей — это хорошая практика проектирования, позволяющая избежать запроса ненужных данных, что помогает избежать ненужного времени обработки и затрат на выставление счетов.

    Укажите разделенный запятыми список типов данных о местах, которые необходимо вернуть. Например, чтобы получить отображаемое имя и адрес места.

    X-Goog-FieldMask: displayName,formattedAddress

    Используйте * , чтобы получить все поля.

    X-Goog-FieldMask: *

    Укажите одно или несколько из следующих полей:

    • Следующие поля активируют SKU «Сведения о месте (только идентификаторы)» :

      attributions , id , name * , photos

      * Поле name содержит имя ресурса места в форме: places/ PLACE_ID . Используйте displayName для доступа к текстовому названию места.

    • Следующие поля активируют SKU «Сведения о месте (только местоположение)» :

      addressComponents , adrFormatAddress , formattedAddress , location , plusCode , shortFormattedAddress , types , viewport

    • Следующие поля активируют SKU «Сведения о месте (базовый)» :

      accessibilityOptions , businessStatus , containingPlaces , displayName , googleMapsLinks * , googleMapsUri , iconBackgroundColor , iconMaskBaseUri , primaryType , primaryTypeDisplayName , pureServiceAreaBusiness , subDestinations , utcOffsetMinutes

      * Поле googleMapsLinks находится на стадии предварительной версии GA, и за нее не взимается плата, то есть оплата за использование во время предварительной версии составляет 0 долларов США.

    • Следующие поля активируют SKU сведений о месте (расширенный) :

      currentOpeningHours , currentSecondaryOpeningHours , internationalPhoneNumber , nationalPhoneNumber , priceLevel , priceRange , rating , regularOpeningHours , regularSecondaryOpeningHours , userRatingCount , websiteUri

    • Следующие поля активируют SKU сведений о месте (предпочтительно) :

      allowsDogs , curbsidePickup , delivery , dineIn , editorialSummary , evChargeOptions , fuelOptions , goodForChildren , goodForGroups , goodForWatchingSports , liveMusic , menuForChildren , parkingOptions , paymentOptions , outdoorSeating , reservable , restroom , reviews , routingSummaries , * servesBeer , servesBreakfast , servesBrunch , servesCocktails , servesCoffee , servesDessert , servesDinner , servesLunch , servesVegetarianFood , servesWine , takeout

      * Только текстовый поиск и поиск поблизости.

  • идентификатор места

    Текстовый идентификатор, уникально идентифицирующий место, возвращаемый в результате текстового поиска (новое) или поиска поблизости (новое) . Дополнительную информацию об идентификаторах мест см. в обзоре идентификаторов мест .

    Строка places/ PLACE_ID также называется именем ресурса места. В ответе на запрос сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое) эта строка содержится в поле name ответа. Идентификатор отдельного места содержится в поле id ответа.

Дополнительные параметры

  • языковой код

    Язык, на котором возвращаются результаты.

    • См . список поддерживаемых языков . Google часто обновляет поддерживаемые языки, поэтому этот список может быть неполным.
    • Если languageCode не указан, API по умолчанию имеет значение en . Если вы укажете неверный код языка, API вернет ошибку INVALID_ARGUMENT .
    • API делает все возможное, чтобы предоставить почтовый адрес, который будет удобен для чтения как пользователем, так и местными жителями. Для достижения этой цели он возвращает адреса на местном языке, транслитерированные в сценарий, который при необходимости читается пользователем, с учетом предпочтительного языка. Все остальные адреса возвращаются на предпочитаемом языке. Все компоненты адреса возвращаются на одном языке, выбранном из первого компонента.
    • Если имя недоступно на предпочитаемом языке, API использует наиболее близкое совпадение.
    • Предпочитаемый язык оказывает небольшое влияние на набор результатов, которые API выбирает для возврата, и порядок их возврата. Геокодер интерпретирует сокращения по-разному в зависимости от языка, например сокращения типов улиц или синонимы, которые могут быть допустимы на одном языке, но недопустимы на другом.

  • Код региона

    Код региона, используемый для форматирования ответа в виде двухсимвольного значения кода CLDR . Значения по умолчанию нет.

    Если название страны в поле formattedAddress в ответе соответствует regionCode , код страны опускается в formattedAddress . Этот параметр не влияет на adrFormatAddress , который всегда включает название страны, или на shortFormattedAddress , который никогда его не включает.

    Большинство кодов CLDR идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, нДВУ Соединенного Королевства — «uk» (.co.uk), а его код ISO 3166-1 — «gb» (технически для организации «Соединенное Королевство Великобритании и Северной Ирландии»). Параметр может повлиять на результаты в соответствии с действующим законодательством.

  • сессионный токен

    Токены сеанса — это созданные пользователем строки, которые отслеживают вызовы автозаполнения (новые) как «сеансы». Автозаполнение (новое) использует токены сеанса для группировки запроса и размещения этапов выбора пользовательского поиска с автозаполнением в отдельный сеанс для целей выставления счетов. Токены сеанса передаются в вызовы Place Details (New), которые следуют за вызовами Autocomplete (New). Дополнительные сведения см. в разделе Токены сеанса .

Пример сведений о месте

В следующем примере запрашиваются сведения о месте по placeId :

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Обратите внимание, что заголовок X-Goog-FieldMask указывает, что ответ содержит следующие поля данных: id,displayName . Тогда ответ имеет вид:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Добавьте дополнительные типы данных в маску поля, чтобы вернуть дополнительную информацию. Например, добавьте formattedAddress,plusCode , чтобы включить в ответ адрес и код Plus :

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Теперь ответ имеет вид: 

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Попробуйте!

API Explorer позволяет вам создавать примеры запросов, чтобы вы могли ознакомиться с API и опциями API.

Чтобы сделать запрос:

  1. Выберите значок API, Разверните API Explorer. , в правой части страницы.
  2. При необходимости установите для параметра name : 
    places/PLACE_ID
  3. При необходимости разверните Показать стандартные параметры и установите для параметра fields маску поля .
  4. Нажмите кнопку «Выполнить» . Во всплывающем окне выберите учетную запись, которую вы хотите использовать для отправки запроса.

  5. На панели API Explorer выберите значок развертывания, Разверните API Explorer. , чтобы развернуть окно API Explorer.