Формат ответа
Ответ 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"]}