Формат ответа

Ответ API содержит область достижимости с мультиполигон-геометрией.

  https://isoline.api.maps.yandex.ru/v1/driving?ll=55.280222457968712,25.234369457896325&duration=900&apikey=YOUR_API_KEY

В этом случае ответ будет выглядеть следующим образом:

Ответ
{
  "hull": {
    "jams_type": "historical",
    "geometry": {
      "type": "MultiPolygon",
      "coordinates": [
        [
          [
            [55.195999, 25.119061],
            ...
            [55.202614999999994, 25.123709]
          ]
        ]
      ]
    }
  }
}

Параметры ответа

hull

Информация о построенной изохроны.

jams_type
Необязательный, приходит только при построении авто изохроны ( mode=driving ).

Тип информации о пробках используемых при расчете изохроны. Возможные значения:

  • historical — учитываются исторические данные о пробках.
  • realtime — используются актуальные данные о дорожной ситуации в реальном времени.
  • disabled — пробки не учитываются.
geometry

MultiPolygon GeoJSON геометрия (см RFC 7946, Section 3.1.7).

type

Тип геометрии. Возможные значения: MultiPolygon

coordinates

Точки, составляющие мультиполигон.

Указаны в десятичных градусах (стандарт WGS84). Каждая точка описывается парой координат в следующем формате: <долгота,широта>

Сообщения об ошибках

Code Description
400 Запрос не содержит одного или нескольких обязательных параметров.
401 Запрос не содержит параметр apikey или указан неверный ключ.
429 Превышено количество запросов.
500 или 504 Системная ошибка сервера. Повторите запрос с небольшой задержкой.

Если при обработке запроса происходит ошибка, API возвращает сообщение с описанием ошибки в поле errors:

{"errors":["Error with parameter \"ll\": Required"]}
{"errors": ["parameter 'apikey' is missing"]}
{"errors": ["Apikey above quota limit"]}
Предыдущая
Следующая