Nachrichteneinreichung und NakBus-Flotte sind jetzt im Partner-Dashboard
Verknüpfen Sie Ihr Entwicklerkonto mit einem Nakordoni-Partners-Konto mit derselben E-Mail-Adresse und verwalten Sie dort Nachrichten sowie Ihre Busflotte (NakDriver / NakManager) mit Teamrollen. Ihre API-Schlüssel, Endpunkte und Apps bleiben unverändert, und die Seiten hier funktionieren weiterhin. Nakordoni Partners öffnen
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
— Kontingentklasse: heavy
| Parameter | Beschreibung |
|---|---|
from | Start as lat,lon (required) |
to | Destination as lat,lon — omit and pass loop_km for a round walk |
loop_km | Round-walk length in km (1-15) when to is omitted |
depart | Local ISO time of the walk, e.g. 2026-07-15T12:00 (default now) |
mode | auto | heat | cold (default auto) |
alternatives | Extra routes beyond the best and the direct one, 0-4 (default 2) |
segments | 0 to omit per-segment GeoJSON (summary only) |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
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. |
routes[].id | cool (most shade for its length) / sunny (cold mode) / direct / alt1.. |
routes[].summary | km, min, shade_pct, sun_exposure_pct, peak_pavement_c (estimate), shade_confidence 0..1. |
routes[].readiness | go | caution | wait. |
routes[].segments | GeoJSON FeatureCollection of ~50 m LineStrings with shade, sun_exposure, pavement_c. Not on the Explorer plan (summary only). |
best_window | Best 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"
🔑 Melden Sie sich als Entwickler an, um diesen Endpunkt live in der Sandbox auszuprobieren — 50 kostenlose Testaufrufe pro Tag. Anmelden
Aktualisiert