Как получить информацию о парковке

Разработчики из Европейской экономической зоны (ЕЭЗ)

Метод SearchDestinations Geocoding API теперь включает подробную информацию о парковке в пунктах назначения. Эти данные помогают пользователям планировать поездки, поскольку они могут:

  • Узнать, какие парковки доступны по прибытии.
  • Оценка времени, которое потребуется на поиск парковки.

Запросить информацию о парковке

Чтобы получить информацию о парковке, необходимо включить в маску поля запроса destinations.parkingOptions. Чтобы указать, какие поля должны быть в ответе, используйте заголовок X-Goog-FieldMask.

Пример запроса cURL

curl -X POST -d '{
  "place": "places/ChIJcWnnWiz0wokRCB6aVdnDQEk"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.primary.place,destinations.parkingOptions" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

Как интерпретировать ответ

Если вы запросите эти данные, объект Destination в ответе будет содержать поле parkingOptions.

parkingOptions

Этот объект содержит сведения о парковке в пункте назначения.

  • Типы парковки. Логические флаги, указывающие на доступность определенных типов парковки:

    • onsiteParking – значение True, если в месте назначения есть парковка.
    • freeParkingLot: True, если есть бесплатная парковка.
    • paidParkingLot: True, если есть платная парковка.
    • freeStreetParking: True, если есть бесплатная уличная парковка.
    • paidStreetParking: True, если есть платная уличная парковка.
    • valetParking: True, если есть парковка с доставкой машины в заданное место.
    • freeGarageParking: true, если есть бесплатная крытая парковка.
    • paidGarageParking: true, если есть платная крытая парковка.

  • Availability. Перечисление, указывающее на общую сложность поиска парковки:

    • AVAILABILITY_UNSPECIFIED. Информация о наличии парковки недоступна.
    • PLENTY – обычно легко найти парковку.
    • SOMEWHAT_DIFFICULT: найти парковку может быть сложно.
    • DIFFICULT – найти парковку обычно очень сложно.

  • Парковки (parkingFacilities). Список объектов ParkingFacility, представляющих отдельные парковки (например, гараж или стоянку), связанные с пунктом назначения:

    • place – объект PlaceView, представляющий определенную парковку (включая ее place, placeId, displayName, location, formattedAddress и displayPolygon).
    • onsite: значение True, если парковка находится на территории основного пункта назначения.
    • popular: True, если парковка популярна среди посетителей основного места назначения.
    • straightLineDistanceMeters – расстояние по прямой в метрах от основного пункта назначения до этой парковки.

Пример фрагмента ответа

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJcWnnWiz0wokRCB6aVdnDQEk",
        "displayName": {
          "text": "Yankee Stadium",
          "languageCode": "en"
        }
        // ... other primary place fields
      },
      "parkingOptions": {
        "paidParkingLot": true,
        "freeStreetParking": true,
        "paidStreetParking": true,
        "paidGarageParking": true,
        "onsiteParking": true,
        "parkingFacilities": [
          {
            "place": {
              "place": "places/ChIJ8TdM8y70wokRToHbbtCEthQ",
              "placeId": "ChIJ8TdM8y70wokRToHbbtCEthQ",
              "displayName": {
                "text": "164th St Parking Garage",
                "languageCode": "en"
              },
              "primaryType": "parking_garage",
              "formattedAddress": "164th St Parking Garage, 65 W 164th St, Bronx, NY 10452, USA",
              "structureType": "POINT",
              "location": {
                "latitude": 40.830543999999996,
                "longitude": -73.924656
              }
              // ... other place fields
            },
            "onsite": true,
            "popular": false
          },
          {
            "place": {
              "place": "places/ChIJ-zvoYG71wokRElYeJWoI9GY",
              "placeId": "ChIJ-zvoYG71wokRElYeJWoI9GY",
              "displayName": {
                "text": "River Ave. Parking Garage",
                "languageCode": "en"
              },
              "primaryType": "parking_garage",
              "formattedAddress": "River Ave. Parking Garage, 999-943 River Ave, Bronx, NY 10452, USA",
              "structureType": "POINT",
              "location": {
                "latitude": 40.8298561,
                "longitude": -73.9245919
              }
              // ... other place fields
            },
            "onsite": false,
            "popular": false,
            "straightLineDistanceMeters": 12.754842758178711
          }
          // ... other parking facilities
        ]
      }
      // ... other destination fields
    }
  ]
}

Как оставить отзыв

Это экспериментальная функция Geocoding API. Мы будем рады получить ваши отзывы по адресу geocoding-feedback-channel@google.com.