Одобрени доклади за състоянието на пътищата близо до границите и по основните коридори: дупки, пътни ремонти, затваряния, лед, опасности — комбиниращи доклади от шофьори с автоматични засичания от акселерометър от нашето навигационно приложение.
GEThttps://nakordoni.eu/api/v1/data/road-conditions
— клас квота: cheap
Параметър
Описание
country
ISO код на държава (по избор)
ppid
ID на граничния пункт, напр. id_13 (по избор). Ограничава отговора до коридора на този пункт: последните 50 км от главния път към него от ДВЕТЕ страни на границата
condition_type
pothole|speed_bump|roadwork|closure|hazard|ice|… (по избор)
severity
low|moderate|major|critical (по избор)
lat
Географска ширина (по избор)
lng
Географска дължина (по избор)
radius
Радиус км (по подразбиране 50)
sources
all (по подразбиране) | user (само сигнали от нашите шофьори) | external (само емисии на пътни власти и доставчици)
limit
Максимален брой резултати (по подразбиране 100, лимит 500)
offset
Отместване за страниране (по избор)
include_expired
1 = връщай и условия с изтекъл срок (по избор)
lang
Език на етикетите condition_type_name / severity_name — всичките 24 езика на сайта (по подразбиране uk)
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
data.conditions[].condition_type
What it is (roadworks, closure, accident, weather…), with condition_type_name in the requested language.
data.conditions[].severity
How bad it is, with severity_name.
data.conditions[].description
Free-text detail as published, with road_name and direction.
data.conditions[].latitude
Where it is, with longitude and country_code.
data.conditions[].corridor_ppid
The border crossing whose approach corridor this sits on, when it is on one.
data.conditions[].estimated_duration
How long it is expected to last, with expires_at and created_at.
data.conditions[].source
Upstream that reported it, with external_id — stable across refreshes, use it to deduplicate.
data.total
Matches for the query, with limit and offset for paging.
Какво е различно в тази версия:
id is now a string carrying its real upstream identity (e.g. "gddkia_B29BE…", "tt_6a83…", "user_335") instead of v1's int, and condition_type keeps the raw upstream value instead of being folded into the v1 enum. The response adds the completeness trio returned / total_available / truncated, plus scope (radius | corridor_ppid | corridor_country). New in v2: ?air_alerts=1 attaches a coarse air-raid advisory (region codes only) for the same scope — the full picture lives in the separate "air-alerts" product. v1 keeps its exact shape — external rows there get a stable negative int id and carry their real id in the additive `external_id` key.
Live road conditions on the approaches to a border crossing: accidents, roadworks, closures, congestion, weather hazards, potholes and ice. Merges our own driver reports with the incident feeds we run the navigator on — national road authorities (GDDKiA, autobahn.de, ÖAMTC, Zjazdnost, Digitraffic, CCISS, DGT) plus TomTom, HERE and crowd reports — deduplicated across sources, each row carrying the `source` it came from. Without coordinates the answer is scoped to the BORDER CORRIDORS rather than a whole country: the last 50 km of the main road from each capital to the crossing, on both sides of the border. Pass ?ppid= for one crossing, or lat/lng+radius for a plain radius search anywhere.
GEThttps://nakordoni.eu/api/v2/data/road-conditions
— клас квота: cheap
Параметър
Описание
country
ISO-2 код на държавата (по избор). Връща страната на граничните коридори на тази държава — не извадка за цялата страна
ppid
ID на граничния пункт, напр. id_13 (по избор). Ограничава отговора до коридора на този пункт: последните 50 км от главния път към него от ДВЕТЕ страни на границата
condition_type
accident|roadwork|closure|congestion|weather|hazard|pothole|speed_bump|object|stopped|ice|other (незадължително). v2 връща суровата стойност от източника, така че поток, който отчита police или event, не се свежда до `other`
severity
low|moderate|major|critical (незадължително)
lat
Географска ширина (незадължително) — заедно с lng превключва към обикновено търсене по радиус
lng
Географска дължина (незадължително)
radius
Радиус в км (по подразбиране 50). Прилага се САМО заедно с lat+lng; при коридорния маршрут филтърът е самият път, а не окръжност
sources
all (по подразбиране) | user (само сигнали от нашите шофьори) | external (само емисии на пътни власти и доставчици)
air_alerts
1 = добавя информационен блок `air_alerts` за същия обхват: дали в някой регион е обявена въздушна тревога, като кодове на региони по ISO 3166-2, заедно с as_of / lag_min (по подразбиране 0). Умишлено грубо — без разстояния, без ленти на близост, без проследявани обекти. За тях извикайте отделното API за близост на въздушните тревоги (продукт "air-alerts", /api/v2/data/air-alerts?ppid=id_94&radius_km=100), изградено около необходимите за целта изисквания за безопасност. Само Украйна; заявка, ограничена до друга държава, получава applicable:false, а не празен списък
limit
Максимален брой резултати (по подразбиране 100, таван 500)
offset
Отместване за страниране (по избор)
include_expired
1 = връщай и условия с изтекъл срок (по избор)
lang
Език на етикетите condition_type_name / severity_name — всичките 24 езика на сайта (по подразбиране uk)
Полета на отговора— вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
Поле
Описание
data.conditions[].condition_type
What it is (roadworks, closure, accident, weather…), with condition_type_name in the requested language.
data.conditions[].severity
How bad it is, with severity_name.
data.conditions[].description
Free-text detail as published, with road_name and direction.
data.conditions[].latitude
Where it is, with longitude and country_code.
data.conditions[].corridor_ppid
The border crossing whose approach corridor this sits on, when it is on one.
data.conditions[].estimated_duration
How long it is expected to last, with expires_at and created_at.
data.conditions[].source
Upstream that reported it, with external_id — stable across refreshes, use it to deduplicate.
data.total
Matches for the query, with limit and offset for paging.
