News submission and NakBus fleet are now in the partner dashboard
Connect your developer account to a Nakordoni Partners account with the same email and manage news and your bus fleet (NakDriver / NakManager) there, with team roles. Your API keys, endpoints and apps are unchanged, and the pages here keep working. Open Nakordoni Partners
Shade Grid API Offline
Shade per H3 resolution-11 hex (about 25 m) for a small bounding box at a given time: share of open ground in building shade and in tree shade, and the combined value. Max 4 km2 / 3000 hexes per call. Pilot coverage: Poznan (PL).
GET https://nakordoni.eu/api/v2/data/shade-grid
— quota class: cheap
| Parameter | Description |
|---|---|
bbox | west,south,east,north (required, max 4 km2) |
t | Local ISO time (default now) |
mode | auto | heat | cold |
Response fields — inside the data object of the envelope. [] marks a list, so data.items[].name is the name field of each element. A field is null, absent or an empty list when we hold no value for it — never a placeholder.
| Field | Description |
|---|---|
context.shade_routing | active | 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_resolved | heat (prefer shade) | cold (prefer sun) | neutral, resolved from mode=auto by temperature and UV. |
context.sun | Sun azimuth and elevation in degrees at the requested time. |
context.weather | temp_c, uv_index, cloud_pct for the hour of the walk. |
summary | hexes, mean_shade, shaded_share (hexes with shade >= 0.5), mean_sun_exposure. |
grid | GeoJSON FeatureCollection of hex polygons: h3, shade, building, tree, sun_exposure (0..1), open_ground, height_confidence. Not on the Explorer plan (summary only). |
curl "https://nakordoni.eu/api/v2/data/shade-grid?bbox=16.918,52.405,16.928,52.410&t=2026-07-15T12:00" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. Log in
Updated