Подача новостей и флот NakBus теперь в партнёрской панели
Подключите свой аккаунт разработчика к аккаунту Nakordoni Partners с тем же email и управляйте там новостями и своим автобусным флотом (NakDriver / NakManager), с ролями команды. Ваши API-ключи, эндпоинты и приложения остаются без изменений, а страницы здесь продолжают работать. Открыть Nakordoni Partners

← Все эндпоинты

Shade Walking Route API Offline

Pedestrian routes ranked by how much of the way lies in building and tree shade at the time of the walk (heat) or in sun (cold). Each route comes with distance, duration, shade share, an asphalt surface temperature estimate and per-segment shade as GeoJSON, plus the best departure window in the next 6 hours. Pilot coverage: Poznan (PL); elsewhere plain routes with shade_routing=unavailable.

GET https://nakordoni.eu/api/v2/data/shade-route — класс квоты: heavy

ПараметрОписание
fromStart as lat,lon (required)
toDestination as lat,lon — omit and pass loop_km for a round walk
loop_kmRound-walk length in km (1-15) when to is omitted
departLocal ISO time of the walk, e.g. 2026-07-15T12:00 (default now)
modeauto | heat | cold (default auto)
alternativesExtra routes beyond the best and the direct one, 0-4 (default 2)
segments0 to omit per-segment GeoJSON (summary only)

Поля ответа — внутри объекта data в конверте ответа. [] обозначает список, поэтому data.items[].name — это поле name каждого элемента. Поле бывает null, отсутствует или пустой список, если значения у нас нет, — заглушки мы не подставляем.

ПолеОписание
context.shade_routingactive | suspended (cloud >= 70 %, ranked by length only) | night (sun below 3 deg) | unavailable (outside the covered cities or no data for that date).
context.mode_resolvedheat (prefer shade) | cold (prefer sun) | neutral, resolved from mode=auto by temperature and UV.
context.sunSun azimuth and elevation in degrees at the requested time.
context.weathertemp_c, uv_index, cloud_pct for the hour of the walk.
routes[].idcool (most shade for its length) / sunny (cold mode) / direct / alt1..
routes[].summarykm, min, shade_pct, sun_exposure_pct, peak_pavement_c (estimate), shade_confidence 0..1.
routes[].readinessgo | caution | wait.
routes[].segmentsGeoJSON FeatureCollection of ~50 m LineStrings with shade, sun_exposure, pavement_c. Not on the Explorer plan (summary only).
best_windowBest 15-min departure in the next 6 h for the first route: time_local, shade_pct, peak_pavement_c, readiness.
curl "https://nakordoni.eu/api/v2/data/shade-route?from=52.4013,16.9115&to=52.4084,16.9336&depart=2026-07-15T12:00" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Войдите как разработчик, чтобы протестировать этот эндпоинт вживую в песочнице — 50 бесплатных тестовых вызовов в день. Войти

Обновлено