Změnový protokol API

Nový produkt lane-cost-index (GET /api/v2/data/lane-cost-index). Vrací nákladový index jedné naložené jízdy kamionu z A do B v Evropě: palivo, mýto, čas řidiče a diety.

• Vstup: from a to jako "lat,lng" nebo id města, vehicle (například artic_40t), volitelně euro, co2_class a empty_return.
• Podle země: km, mýto, litry nafty a náklady na palivo (bez DPH) a třída vozidla použitá pro mýto.
• Čas řidiče: jízda, přestávky a odpočinky podle pravidel EU 561/2006. Náklady na řidiče a diety používají sazbu země původu. Španělsko a Itálie mají nyní sazbu řidiče a diety z kolektivních smluv.
• Trend: trend uvádí nákladový index aktuálního a dvou předchozích měsíců.
• Neúplná data: když země na trase nemá data o mýtu nebo palivu, nebo země původu nemá sazbu řidiče, incomplete je true a součet je dolní mez. missing_countries a missing_components ukazují, co chybí.

Jde o nákladový index, ne o cenu přepravy: kapitál vozidla, pojištění, režijní náklady a marže nejsou zahrnuty.

Kvóta: jeden požadavek se počítá jako 1 jednotka třídy route, stejně jako truck-route.

Dokumentace: Lane Cost Index.

Produkt toll-cost přesněji oceňuje Francii, Španělsko a Itálii.

• Francie a Španělsko: úsek dálnice mezi dvěma mýtnými stanicemi na trase se oceňuje podle tarifu vjezd/výjezd provozovatele dálnice. Zobrazí se jako nový typ položky motorway_section s provozovatelem nebo silnicí, oběma stanicemi, toll_km a cost_eur. Ostatní zpoplatněné km země dál používají průměrnou sazbu za km.
• Třída vozidla: Francie: třída 3 pro 2 nápravy a třída 4 pro 3 a více náprav. Španělsko: Pesados 1 pro 2 nebo 3 nápravy a Pesados 2 pro 4 a více náprav.
• Itálie: nákladní vozidla se 2 a 3 nápravami mají nyní vlastní sazby za km.
• Třída Euro a CO2: francouzské, italské a španělské tarify nezávisí na těchto třídách. Když pošlete euro nebo co2_class, class_fallback je pro tyto země false a class_note uvádí důvod.
• Bez zpoplatněné silnice: trasa přes Španělsko bez zpoplatněné silnice (například Zaragoza – Barcelona) vrátí Španělsko s cost_eur 0 a scheme not_tolled.

Ostatní země se nemění. Dokumentace: Truck Toll Cost.

Nový produkt toll-cost (POST /api/v2/data/toll-cost, tělo JSON). Vrací výši mýtného pro nákladní vozidlo na trase po Evropě.

• Vstup: linie trasy jako coordinates (například geometrie z truck-route) nebo waypoints, pro které vypočítáme trasu naším směrováním pro nákladní vozidla.
• Vozidlo: axles, gross_weight_t, euro a co2_class. Volitelně date pro tarify a currency pro celkovou částku.
• Podle zemí: zpoplatněné km, efektivní sazba EUR za km, náklady, oceněná třída vozidla a datum tarifu. Sazby pro konkrétní třídu Euro a CO2 se použijí tam, kde je pro tuto třídu k dispozici oficiální tarif. Jinak se použije sazba výchozí třídy a class_fallback je true.
• Samostatné položky: koncesní úseky dálnic a tunely a mosty s vlastním mýtným pro nákladní vozidla (například Calafat-Vidin).

Kvóta: jeden požadavek se počítá jako 1 jednotka třídy route, stejně jako truck-route.

Dokumentace: Truck Toll Cost.

Dva nové produkty v /api/v2. Pro jízdu autobusem ukazují, která strana je na slunci a která ve stínu, a která místa jsou nejlepší pro stín nebo výhled.

• bus-sun-side (/api/v2/data/bus-sun-side), GET: trasa z našeho registru autobusových tras (route_id, dir, date) nebo volná jízda (from, to, depart).
• bus-sun-side, POST: pošlete vlastní trasu jako seznam zastávek, linii GeoJSON nebo kódovanou polylinii. Přidejte parametry autobusu (řady, uspořádání sedadel, strana dveří, okna, patro) nebo vyberte model z katalogu přes bus_model.
• Počasí: pro jízdy v příštích 3 dnech se používá hodinová předpověď podél trasy. Pozdější jízdy se počítají pro jasnou oblohu. Pošlete weather=0, pokud chcete vždy výsledek pro jasnou oblohu.
• Obrázky (POST): plánek sedadel, mapa trasy a časová osa jako URL ve formátu PNG, WebP nebo JPG. Obrázky se uchovávají 12 hodin. Dostanete také embed_html pro vložení výsledku na vaši stránku. URL obrázků začínají na https://api.nakordoni.dev/images/.
• Animace: blok animation obsahuje snímek každých 5 minut s polohou autobusu, směrem jízdy, azimutem a výškou slunce a slunnou stranou, s popisky ve vašem jazyce, součty pro strany a legendou. Pošlete animation=0, pokud ho nechcete.
• Widget: zobrazte výsledek na jakémkoli webu, i ve WordPressu, pomocí tagu script nebo iframe. Widget používá veřejný klíč, který funguje jen na vámi povolených doménách (origins), a naše vlastní mapové dlaždice. K dispozici je plugin pro WordPress (zip).
• bus-sun-catalog (/api/v2/data/bus-sun-catalog): modely autobusů, které přijímá bus-sun-side, s uspořádáním sedadel a okny.

Kvóta: požadavek POST s obrázky se počítá jako 2 jednotky. Všechny ostatní požadavky jako 1 jednotka.

Dokumentace: Bus Sun Side.

fleet-compliance-validate nyní pokrývá větší část nařízení EU 561/2006 ve znění nařízení (EU) 2020/1054. Stávající pole odpovědi se nemění; přibývají nová pole.

• Výjimka podle čl. 12: řídicí činnosti označte pomocí art12_exceed: true. Ve výjimečných případech smí řidič překročit denní a týdenní limity řízení nejvýše o 1 h, aby dojel do provozního střediska nebo domů na týdenní odpočinek, nebo nejvýše o 2 h po přestávce 30 min, pokud následuje pravidelný týdenní odpočinek. Validátor to akceptuje a vrací dlužnou kompenzaci i její lhůtu (konec třetího následujícího týdne) v remaining.driving.art12_compensation a exceptions.art12.
• Návrat na základnu podle čl. 8(8a): u týdenních odpočinků posílejte location (residence, operational_centre nebo elsewhere). Pokud 4 po sobě jdoucí týdny neobsahují pravidelný týdenní odpočinek doma nebo v provozním středisku, dostanete varování.
• 12denní odchylka podle čl. 8(6a): passenger_12day: true pro jednu příležitostnou mezinárodní službu autobusem. Týdenní odpočinek pak může následovat až po dvanácti 24hodinových obdobích od pravidelného týdenního odpočinku. Kontrolují se následující odpočinky a noční řízení (22:00-06:00). AETR čl. 8(6)(b) se použije stejným způsobem.
• Národní noční okna (směrnice 2002/15/ES čl. 3(h)): pomocí country nebo wtd.country použijete národní noční dobu. Ověřeno: AT, IE (cestující zvlášť) a SE. Ostatní země EU/EHP používají 00:00-04:00 a vracejí night_window_verified: false.
• fleet-compliance-limits: AETR nyní uvádí zkontrolované změny po roce 2010. Mění pouze článek 14, nikoli pravidla řízení či odpočinku.

Dokumentace: Fleet Compliance.

Čtyři nové produkty, poskytované z /api/v2 a vypočítané naším vlastním pravidlovým jádrem svátků pro 51 zemí (Evropa a Perský záliv: SA, AE, QA, KW, BH, OM), 2020-2035:

• holiday-calendar-holidays (/api/v2/data/holiday-calendar/holidays) — státní, bankovní, regionální, náboženské a pamětní svátky pro nejvýše 10 zemí v rámci roku nebo rozsahu dat. Každý svátek uvádí, zda jde o den volna, bankovní svátek nebo zda spadá do školních prázdnin, zda se svátek o víkendu přesunul na jiný den, zda je datum podle islámského kalendáře stále odhadované, a zda se v daný den uplatňuje zákaz jízdy nákladních vozidel (truck_ban). Filtrovat lze podle regionu (region=DE-BY), typu, jazyka a názvu; school=1 přidá školní prázdniny.
• holiday-calendar-business-days (/api/v2/data/holiday-calendar/business-days) — počítání pracovních dnů mezi dvěma daty, přičtení nebo odečtení pracovních dnů, ověření data nebo nalezení následujícího či předchozího pracovního dne. Využívá víkend dané země (sobota-neděle, nebo pátek-sobota a jiné víkendy v zemích Perského zálivu), celostátní a regionální dny volna a přesuny dnů na základě nařízení.
• holiday-calendar-countries (/api/v2/data/holiday-calendar/countries) — pokryté země s víkendovými dny, časovým pásmem, regiony a typy svátků; s parametrem country= také počet pracovních dnů v roce a následujících pět svátků.
• holiday-calendar-impact (/api/v2/data/holiday-calendar/impact, plán Pro a vyšší) — modelově odhadovaný dopad na byznys: skóre dopadu 0-100 pro každý svátek, pravděpodobnost uzavření obchodů, kategorie poptávky, poloha v prodlouženém víkendu a v překlenutí a okna nárůstu poptávky. V produktu holiday-calendar-holidays získávají plány Pro a vyšší tento blok také pomocí include=impact a mohou filtrovat pomocí min_impact.

Stávající produkt holiday-calendar se nemění. Dokumentace: Holiday Calendar.

Tři nové produkty pro zajištění souladu s předpisy o době jízdy, poskytované z /api/v2:

• fleet-compliance-validate (POST /api/v2/data/fleet/compliance/validate, tělo JSON) — kontroluje zaznamenanou aktivitu řidiče podle EU 561/2006 nebo AETR a pracovní doby podle Directive 2002/15/EC. Vrací každé porušení s článkem pravidla a pásmem závažnosti, a také to, co řidiči zbývá: denní jízda, klouzavé týdenní limity 56 h a dvoutýdenní limity 90 h, další přestávka, denní a týdenní odpočinek. Pokrývá rozdělené přestávky, zkrácené a prodloužené dny, kompenzaci zkráceného týdenního odpočinku, noční práci, dvoučlennou posádku a přerušený odpočinek na trajektu nebo ve vlaku.
• fleet-compliance-limits (/api/v2/data/fleet/compliance/limits) — parametry pravidel pro EU 561, AETR (s jeho rozdíly oproti 561) a 2002/15, a také pásma závažnosti podle Regulation (EU) 2016/403.
• fleet-compliance-plan-check (POST /api/v2/data/fleet/compliance/plan-check, tělo JSON) — kontroluje plánované směny před expedicí vůči zákazům jízdy nákladních vozidel, státním svátkům a víkendovým dnům v zemích trasy a vůči pravidlům EU 561, AETR a 2002/15. Každá směna dostane nejdřívější zákonný čas zahájení.

Dokumentace: Fleet Compliance.

Od v3 mají zastávky denního a týdenního odpočinku pole in_vehicle_allowed, accommodation_required a rule (route-plan s rest_rules=eu561 a truck-route). Nařízení (EU) 2020/1054 změnilo čl. 8 odst. 8 EU 561/2006: pravidelný týdenní odpočinek ani žádný týdenní odpočinek delší než 45 h se nesmí čerpat ve vozidle. Pro tyto zastávky je in_vehicle_allowed = false. Zkrácený týdenní odpočinek (od 24 h do méně než 45 h) a denní odpočinek lze čerpat ve stojícím vozidle s místem na spaní.

Zastávky týdenního odpočinku mají také accommodation[] — parkoviště s pokoji na místě poblíž zastávky — a parkoviště zastávky má has_accommodation. Je to jen informace: zastávka, její čas a parkoviště pro kamiony se nemění. Pokud není známo místo s pokoji, zastávka má warning = no_accommodation_found. Odpovědi v1 a v2 se nemění.

Ceny stanic v /api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest, /api/v2/data/fuel-local a /api/v2/data/fuel s mode=nearest mají nyní maximální stáří 90 dní. Cena, kterou jsme naposledy potvrdili před více než 90 dny, se už nevrací. Dříve se taková cena vracela s stale = true.

Co se mění v odpovědích: druh paliva, který má jen starší cenu, chybí v prices; stanice bez jakékoli ceny není uvedena nebo má prázdný objekt prices tam, kde se zobrazují stanice bez cen; a odpověď může být prázdná tam, kde dříve obsahovala staré ceny. Prázdná odpověď jako dosud obsahuje empty_reason. fuel-local pak může odpovědět z úrovně regionu nebo země. Příznak stale se nemění: je true, když byla cena naposledy potvrzena před více než 7 dny. Historie cen se uchovává. Pro fuel-cities, fuel-cost, celostátní průměry a fuel-grades není žádná praktická změna. Podrobnosti: Stáří ceny.

GET /api/v2/data/route-plan získává ve v2 rozšířený model zastávek (jen doplňky: nic nebylo odstraněno ani přejmenováno) a nové výchozí hodnoty ve v3 (/api/v3/data/route-plan).

v2, doplněk. Se stop_places=1 každá zastávka (přestávka, jídlo, přenocování, týdenní odpočinek) obsahuje places[]: kandidátní parkoviště v okně jízdní doby kolem zastávky, každé s poli name, type, country, lat, lon, at_km, at_drive_s, offset_min, off_route_km, detour_km, exceeds_4h30 a type_rank. Vyhledávání doladíte přes places_before_min, places_after_min, places_radius_km a rest_radius_km; poloměr nad 25 km se omezí a ohlásí varováním radius_clamped. rest_rules=legacy|eu561 vybírá model odpočinku a s eu561 můžete poslat stav řidiče: driven_since_break_min, driven_today_min, duty_started_min_ago, driven_week_min, driven_fortnight_min, extended_days_used, reduced_rests_used a allow_reduced. Nové typy zastávek: ban_wait (s ban: name, country, from, until) a weekly_rest; čekání, které nahrazuje přestávku nebo odpočinek, je označeno counts_as. Hraniční přechody pro nákladní vozidla při výjezdu z Ukrajiny s elektronickou frontou přidávají registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note a registration_url a varování echerha_registration a echerha_wait_unverified.

v3, nové výchozí hodnoty. rest_rules má výchozí hodnotu eu561; názvy míst jsou přísné (jen skutečná parkoviště a odpočívadla); čas čekání zveřejněný eCherha (čerstvá data, bez limitu) se používá jako čekání na hranici a čekání na hranici se započítá jako přestávka nebo odpočinek, který byl splatný. v2 zachovává starý model odpočinku a původní filtr míst, takže stávající integrace se nemění. Podrobnosti: Route Planner API.

GET /api/v3/data/truck-route nyní používá čekání na hranici z eCherha. Ve v3 border_crossings[] pro nákladní pruhy při výjezdu z Ukrajiny s elektronickou frontou přebírají wait_min ze zveřejněné doby čekání eCherha (jen čerstvá data, bez limitu; u zastaralých dat je wait_min null a přidá se varování echerha_wait_unverified) a obsahují registration_required, registration_wait_minutes, registration_wait_source, registration_wait_at, registration_note a registration_url, s varováním echerha_registration.

Plán odpočinku bere čekání na hranici jako čas strávený na hranici: dlouhá fronta se započítá jako přestávka, denní nebo týdenní odpočinek, který byl splatný (counts_as v řádku waits[]), místo aby se přičetla navíc. v2 je beze změny. Podrobnosti: Truck Route API.

Když /api/v2/data/fuel-stations nebo /api/v2/data/fuel-cheapest nenajde žádnou stanici, odpověď má stále HTTP 200 s prázdným seznamem a nyní uvádí důvod. Jen u prázdné odpovědi obsahuje data pole empty_reason (no_station_in_radius, no_price_for_fuel_type, fuel_type_not_priced_in_country, unknown_fuel_type nebo no_fresh_price_in_radius), nearest_station_km (nejbližší stanice s vaším druhem paliva, hledá se až do nearest_search_km = 50 km; null, pokud žádná není), country a suggestion, jednu krátkou větu ve vašem lang, například: No station within 5 km — the nearest is 6.4 km away; try radius_km=10.

Větvete kód podle empty_reason a nearest_station_km. suggestion je rada pro lidi a její znění se může změnit. Okruh za vás nikdy nezvětšujeme. Pokud vzorkujete oblast nebo trasu v mřížce, použijte radius_km 10–15. Odpovědi obsahující stanice se nemění. Podrobnosti: Prázdné odpovědi.

Poloměr hledání. radius_km u /api/v2/data/fuel-stations nyní zachovává jedno desetinné místo. Poloměr jako 4.8 se dříve bez upozornění zkrátil na 4, takže každé hledání pokrylo až o třetinu menší plochu, než bylo požadováno, a mohlo vrátit méně stanic nebo žádnou. anchor.radius_km ukazuje skutečně použitý poloměr; celá čísla se vracejí jako dosud.

Názvy značek. Stejná značka se v brand nyní vždy píše stejně — například ORLEN a orlen se vracejí jako Orlen a CircleK jako Circle K. Stanice, ceny, id a pole se nemění. Pokud značky porovnáváte podle přesného pravopisu (pro loga nebo filtry), zkontrolujte svůj seznam vůči novým názvům.

GET /api/v2/data/truck-route přijímá nový volitelný parametr traffic. Určuje, jak se při ETA, plánu odpočinku, časech příjezdu na hranice a časech u zákazů pro nákladní vozidla zohledňuje doprava:

• forecast (výchozí): opakující se kongesce v hodině, kdy kamion projíždí jednotlivé úseky, aktuální kolony slábnoucí s časem do příjezdu, práce na silnici a uzavírky na trase a počasí, kde ho máme. Odpověď obsahuje blok traffic_forecast se zpožděním rozděleným podle příčin.
• live: pouze aktuální doprava, bez opakujících se kongescí.
• off: bez úpravy podle dopravy; časy jsou časy plynulé jízdy podle enginu pro nákladní vozidla. traffic_forecast pak obsahuje jen model a mode.

Jakákoli jiná hodnota vrátí 400 bad_request se zprávou Invalid traffic: forecast, live or off. Požadavky bez parametru dostanou výchozí hodnotu forecast.

Zákazy pro nákladní vozidla v předpovídaném čase příjezdu: při forecast nebo live se truck_bans[].active nyní posuzuje v čase, kdy má kamion podle předpovědi k danému zákazu dorazit (od depart_at, nebo od teď, pokud jej neposíláte), před případným čekáním na tento zákaz. Nové pole truck_bans[].active_at udává posuzovaný čas v místním čase země zákazu. bans_summary, restriction_hits a legal se řídí stejnými verdikty a zákaz, na který předpovídané zpoždění nově narazí (například další den nebo v jiné zemi), je rovněž uveden v truck_bans. U traffic=off se active posuzuje na časové ose plynulé jízdy a active_at se rovná eta_at_ban.

Nový produkt: Truck Route API (GET /api/v2/data/truck-route, pouze v2). Jedno volání vrátí trasu povolenou pro nákladní vozidlo a vše, co dispečer potřebuje podél ní. Trasu počítá stejné routovací jádro jako naše navigační aplikace pro nákladní vozidla TruckTurn, nad našimi vlastními mapovými daty.

• Vozidlo: height, width, length, weight, axle_load, axles, trailers, emission_class, hazmat (třídy ADR) a adr_tunnel (B–E). Zákazy jízdy nákladních vozidel a omezené zóny se kontrolují na vrácené trase.
• Podél trasy: čerpací stanice s aktuálními cenami, parkoviště pro nákladní vozidla a vážní stanice, každé s km_from_start a objížďkou.
• Plán odpočinku řidiče podle nařízení EU 561/2006: přestávky (včetně dělených 15+30), denní a týdenní odpočinek (včetně zkráceného), jeden řidič nebo dvoučlenná posádka (crew=2), počínaje aktuálním stavem řidiče, pokud jej předáte. Každá zastávka je umístěna na skutečném parkovišti podél trasy. Jde o pomůcku pro plánování, nikoli o záznam z tachografu.
• ETA včetně odpočinku, zákazů jízdy nákladních vozidel a čekání na hranicích. Plánování podle depart_at nebo arrive_at.
• Odhad nákladů na mýto podle zemí (EUR, podle počtu náprav a emisní třídy); země bez tarifu jsou uvedeny v tolls.coverage_note. Dále avoid (mýto, trajekty, dálnice, hranice, tunely, nezpevněné cesty, nízkoemisní zóny), až 2 alternativy, rozdělení podle zemí a geometry jako polyline5, polyline6 nebo GeoJSON.

Kvóta: samostatný limit pro trasy nákladních vozidel: 10 volání denně na každém účtu, více v placených tarifech, a doplněk Další volání tras pro nákladní vozidla. V sandboxu můžete denně vypočítat 10 tras pro nákladní vozidla, zobrazit výsledek na mapě s úplným plánem trasy a exportovat ho do GPX, KML, GeoJSON, CSV, kalendáře (.ics) nebo ITN. Viz stránka produktu a reference.

Podle Podmínek API je Market země, jejíž data používáte, a váš klíč pokrývá země schválené pro váš účet. Dosud produkty založené na souřadnicích (lat/lon — např. Nearby Shops, Truck Parkings, Fuel Stations) odpovídaly pro jakýkoli bod v Evropě. Od 13. října 2026, se to kontroluje při zpracování vašeho požadavku:

• Požadavek, jehož lat/lon leží v zemi, která není schválena pro váš účet, vrátí 403 s error.code market_not_allowed. Zpráva uvádí zemi a váš seznam schválených zemí.
• Pokud poloměr překročí hranici, výsledky, jejichž country_code je mimo vaše schválené země, jsou odstraněny. Odpověď pak obsahuje markets_filtered (kolik bylo odstraněno) a markets_notice, přičemž total_found počítá jen přijaté výsledky.

Toto se vztahuje na účty, jejichž země byly ověřeny (stav approved nebo partial). V požadavku se nic nemění — žádný nový parametr, žádná nová verze. Pokud vaše aplikace potřebuje další zemi, přidejte ji v portálu pro vývojáře před 13. říjnem. market_not_allowed je uveden spolu s ostatními chybovými kódy v referenci.

Vývojářské účty propojené s účtem Nakordoni Partners se stejnou e-mailovou adresou nyní mohou zadávat zprávy a spravovat svou flotilu NakBus (NakDriver / NakManager) na partners.nakordoni.eu, s týmovými rolemi (Owner, Manager, Viewer) a přihlášením jedním kliknutím mezi oběma portály. Stránky vývojářského portálu, API klíče, koncové body flotily a aplikace zůstávají beze změny.

U Fuel Prices běžely updated_at a vlastní příznak age_hours/stale v odpovědi podle různých hodin: updated_at se mění, jen když se cena skutečně změní, ale zastaralost se počítala, jako by se měnilo při každém potvrzení. U 46.7% cenového indexu bylo age_hours ≤48 a stale:false, přestože updated_at bylo ve skutečnosti starší než 48 hodin, u 12,620 stanic starší než týden. Každá cena nyní navíc nese confirmed_at — čas posledního potvrzení ceny, zaokrouhlený dolů na hodinu a nikdy dřívější než updated_at — a age_hours/stale se počítají z něj. Význam updated_at se nemění: použijte ho, když chcete vědět, kdy se cena naposledy pohnula, a confirmed_at, když chcete vědět, jak je aktuální právě teď. V zamrzlém kontraktu v1 není přítomno.

Dvě jazykové chyby, obě tiché: zaslání kanonického kódu druhu paliva s lang=pl (nebo jakýmkoli z dalších 24 jazyků webu) vracelo fuel_type_local anglicky bez ohledu na požadavek — proti tabulce popisků bylo kdy kontrolováno jen 10 jazyků, takže vše mimo tento seznam spadlo na výchozí slovník rozhraní místo požadovaného jazyka. Zvlášť lang=tr (nebo několik dalších platných kódů) vracelo seznamy stanic ukrajinsky, protože interní výchozí hodnota uk se uplatnila vždy, když požadovaný jazyk nebyl na stejném seznamu 10 jazyků. Obojí je opraveno: jazyk, který odešlete, je nyní jazyk, který dostanete, ve všech 25.

Dále: brand u Nearby Fuel Stations už pro ~330 stanic, jejichž značku neznáme, nevrací surovou hodnotu OTHER z načítání dat — je to null, shodně s každým jiným neznámým polem v odpovědi.

Hraniční AI asistent (/api/v1/data/assistant) odpovídal 503 internal_error — „Asistent je dočasně nedostupný“ —, když stejný klíč položil stejný dotaz dvakrát během pěti minut. Nic přitom nebylo nedostupné: ve většině těchto případů byla odpověď už spočítaná a připravená k předání. Nyní se vrací standardně, s ok: true a HTTP 200.

Pokud opakování dorazí ve chvíli, kdy se první odpověď ještě zapisuje, volání nyní vrátí 429 s error.code rovným duplicate_request místo 503, aby politika opakování odlišila „zeptej se za okamžik znovu“ od skutečného výpadku. Oba případy se navíc započítávaly do chybovosti vašeho účtu jako serverové chyby; už se nezapočítávají. Na samotném požadavku se nic nemění — žádný parametr, žádná verze. duplicate_request je v referenci uveden spolu s ostatními kódy chyb.

Parkoviště pro kamiony (/api/v2/data/truck-parkings) vracela záznamy s name rovným null a prázdnou address — u Bensheimu 20 z 50. Jsou to místa, která evidujeme pouze jako souřadnici: není co zobrazit ani s čím spárovat vaši vlastní sadu POI. Do tohoto produktu už nepatří: vrací nyní jen pojmenované lokality, aktuálně více než 22 000 v celé Evropě. Pokud jste nepojmenované záznamy filtrovali sami, takový kód je teď nadbytečný, ale neškodný. Odpovědi jsou při stejném radius a limit kratší a každý vrácený záznam je použitelný.

Samostatně: zhruba 10 000 parkovišť mělo v poli name surovou dvojici souřadnic, například 51.927301,10.14112, zatímco skutečné označení bylo v address. Nyní nesou toto označení — Ionity, Seesen, Rest Area A5 E35 Kaelberpfad, Bensheim — všude, kde se objevují, včetně /api/v1/data/pois. id každého místa se nemění, takže uložené přiřazení zůstává platné; mění se jen name.

snapshot.updated_at v /api/v1/data/queue a /api/v1/data/multi je místní čas v pásmu samotného hraničního přechodu (například Europe/Istanbul, Europe/Sofia, Europe/Budapest, Europe/Warsaw, Europe/Kyiv) a dosud v odpovědi nikde nestálo, o které pásmo jde, takže volající jej nemohl převést na konkrétní okamžik. snapshot nově získává pole timezone (název IANA) vedle updated_at. Žádný parametr, žádná verze, žádné jiné změny polí.

Dosud každý palivový endpoint popisoval vlastní pokrytí ručně psaným seznamem: AT, DE, DK, ES, FR, HR, IT, LU, PL, PT, SI, přičemž Polsko v něm bylo zúženo na oblast Trojměstí. Obě tvrzení už dávno neplatila. Pokrytí se nyní měří z živého indexu stanic a přepočítává se každých šest hodin: 39 zemí má dnes stanice s cenami a Polsko mezi nimi na celém území, ne ve třech městech. Na samotném dotazu se nemění nic: žádný parametr, žádná verze.

Čerpací stanice v okolí a Nejlevnější palivo: když hledání nic nevrátí, blok coverage nyní nese naměřené station_countries, station_counts, sparse_coverage a measured_at, zúžené na požadovaný druh paliva, ne na palivo obecně. Země se dostane do sparse_coverage, když v ní máme 25 stanic s cenami nebo méně — je to počet, ne úsudek.

Přibyla nová poznámka pro druh, který známe, ale jehož cenu tam, kde se ptáte, nikdo neuvádí. Dosud se coverage.fuel_type_note objevovala jen tehdy, když nám byl neznámý samotný název ze stojanu. Nyní se objeví i tehdy, když se název rozpozná správně, ale v dané zemi pro něj prostě žádná cena není; pojmenuje země, kde je ten druh oceněn, i druhy, které oceňujeme ve vašem okolí. Český název Natural 100 je čistý příklad: rozpozná se, ale žádný zdroj pro něj v Česku cenu neuvádí. Prázdná odpověď tak přestává vypadat jako rozbitý dotaz.

Druhy paliva (/api/v2/data/fuel-grades) dostává priced_countries a priced_station_counts pro každý druh a navíc priced_here, když pošlete ?country=. Oba seznamy znamenají něco jiného: země v countries je ta, kde tento název ze stojanu přijímáme, zatímco priced_countries říká, kde jej zdroj skutečně oceňuje, takže priced_here s hodnotou 0 je skutečná odpověď, ne mezera v odpovědi. Přicházejí i coverage_measured_at a coverage_note a Cache-Control klesá z 24 hodin na 6, aby odpovídal frekvenci přepočtu.

Rozpoznává se i více místních názvů ze stojanů, mezi nimi Klimadiesel 90 (HVO100) a HVO Diesel, Erdgas a Metano, Autogas a Autogaz, DEF pro AdBlue a řada značkových názvů prémiové nafty a benzinů. Pořadí rozpoznávání se nezměnilo a porovnávání zůstává přesné, takže žádný dříve fungující název dnes neznamená něco jiného a nový název může nanejvýš změnit prázdnou odpověď na odpověď s cenami. Zároveň jsme opravili referenční dokumentaci a popisy endpointů ve všech 25 jazycích webu.

Nejlevnější palivo (/api/v2/data/fuel-cheapest) vracelo nejbližší čerpací stanice seřazené podle vzdálenosti místo těch nejlevnějších. Protože se řazení uplatňovalo dříve, než byl výsledek oříznut na váš limit, nejlevnější stanice ve vašem okruhu mohly z odpovědi zcela chybět. Řazení opět funguje správně: nejprve nejnižší cena za požadovaný druh paliva, při shodě ceny vyhrává bližší stanice a stanice bez ceny pro daný druh skončí poslední. Na samotném požadavku se nic nemění — žádný nový parametr, žádná nová verze.

Odpovědi v2 pro palivo jsou také zdokumentovány přesně tak, jak jsou skutečně vraceny: stanice přicházejí v data.stations[], jeden záznam na fyzickou stanici, přičemž každý druh paliva je vnořen v objektu prices (price, currency, local_name, updated_at, age_hours, stale) a dále station_ref, grades, total_found a notices. Reference pro Čerpací stanice v okolí a Nejlevnější palivo nadále popisovala starší plochý seznam řádků data.data[].

Na stránce plateb (měsíční záložka) jsou k dispozici dva doplňky k jakémukoli plánu, bez jeho změny: Extra volání prognóz — +100 volání prognóz a statistik denně za blok, 2 € měsíčně za blok, až 10 bloků; a Extra země — +1 deklarovatelná země za kus, 2 € měsíčně za každou. Změna počtu zobrazí přesnou poměrnou kalkulaci ještě před stržením peněz.

Od 10. listopadu 2026 každý plán zahrnuje daný počet deklarovaných zemí: Explorer a Student 4, Starter 10, Pro a výše bez omezení. Od tohoto data nepůjde uložit deklaraci delší, než je plán plus zakoupené extra země; záložka Účet už ukazuje váš limit a účty, které jej překračují, vidí upozornění na nástěnce. Před 10. listopadem se nic nemění.

API sandbox nyní označuje každý endpoint ve výběru jeho třídou kvóty (Těžký / Standardní), ukazuje spotřebu kvóty pro zvolenou verzi ještě před spuštěním a po volání ukazuje, kolik by totéž volání stálo z vaší ostré kvóty — včetně vzorce ceil(N ppids × M sub-products / 2) používaného pro volání typu /multi.

Jde o náhled jen pro čtení: samotná volání v sandboxu se strhávají z odděleného testovacího rozpočtu sandboxu, nikdy z vaší ostré kvóty.

Ode dneška je vše, co jsme veřejně ohlásili jako vyřazované, uzavřeno pro vývojářské účty vytvořené v den ohlášení nebo později. Pokud váš účet existoval před ohlášením, nic se nemění — zůstává vám celé přechodné období až do data vyřazení uvedeného v záznamu, který je ohlásil.

Proč toto pravidlo existuje. Dne 24. srpna 2026 jsme ohlásili, že truck-bans v1 se vyřazuje 8. září 2026. Dva účty se zaregistrovaly několik dní po tomto ohlášení, postavily svou integraci na v1 a byly pár hodin od 410, aniž by k nim dorazil jediný náš e-mail: ohlášení i dávka notifikací předcházely jejich registraci. Nic v API jim nezabránilo nasadit verzi, o které jsme už řekli, že končí. To bylo naše selhání a toto je náprava — nemůžete nově nasadit něco, co je již naplánováno k odstranění.

Jak to vypadá. Takové volání je odmítnuto s 410 Gone a chybovým kódem version_closed_to_new_accounts. Zpráva uvádí datum vyřazení, datum ohlášení a verzi, kterou použít místo ní. Jde záměrně o jiný kód než version_sunset, který dostane každý účet poté, co samotné datum vyřazení uplyne — podpora tak rozezná „přišli jste příliš pozdě na to, abyste začali“ od „toto je pryč pro všechny“ bez čtení logu.

Zachování přístupu se řídí datem vytvoření účtu, nikoli prvním voláním. Pokud jste se zaregistrovali před ohlášením, ale integrovat začínáte až nyní, stále dostanete celé přechodné období: mohli jste na tom stavět celou dobu.

Platí od nynějška pro truck-bans v1 (ohlášeno 24. srpna 2026, vyřazení 8. září 2026) a automaticky pro každé vyřazení, které od této chvíle ohlásíme. Nic nového se od vás nevyžaduje: každá odpověď na vyřazované verzi již nese hlavičky Deprecation, Sunset a Link: rel="successor-version", takže nová integrace vidí blížící se vyřazení i bez čtení této stránky.

Navázání na včerejší změnu ve v4 (vývojářský tiket #105). Seznamy destination oddělené čárkami ve v1 a v2 dál fungují, ale nyní podléhají stejnému termínu jako destination=all: obojí končí 2026-10-06 (do té doby hlavičky Deprecation/Sunset, poté 400 destination_list_removed s odkazem na /api/v4/ jako náhradu). Stávající kontrola limitu 10 položek u seznamů s čárkami se do tohoto data nemění.

v4 zůstává u jedné destinace na volání — to se dnes nezměnilo. Změnilo se jen to, jak komunikujeme v1/v2: chyba 400 u destination=all už nenabízí seznam s čárkami jako cestu migrace (skončil by ke stejnému datu), ale míří rovnou na v4.

Oprava dokumentace: příklad v4 na těchto stránkách dříve zněl /api/v4/data/border/1/2,3,4/9 — což je seznam s čárkami, který v4 odmítá. Nyní je to /api/v4/data/border/1/2/9. Kdo starý příklad zkopíroval, dostal by při prvním volání 400; omlouváme se.

Nový přeložený klíč product_border_v4_p_destination vychází ve všech 25 jazycích webu a výslovně uvádí pravidlo jedné destinace ve v4 místo toho, aby přebíral formulaci z v1/v2.

/api/v4/data/border/{origin}/{destination}/{crossing_type} je ode dneška v provozu. Oproti v2 se mění tři věci a společně jsou důvodem, proč jde o novou verzi, a ne o úpravu.

1. Konec destination=all. Naše data jsou licencována po zemích (Developer API Terms, oddíl 7) a zástupný symbol, který se rozvine na „každého souseda, pro kterého máme data“, vrací země, pro které váš účet nemusí být schválen — a v požadavku to není nijak vidět. Ve v4 zemi pojmenujete.

2. Jedna cílová země na volání. /api/v4/data/border/1/2/9 se ptá na jednu hranici. Seznamy oddělené čárkou se nepřijímají: 1/2/9, 1/3/9 a 1/4/9 pošlete jako samostatná volání. Seznam s čárkou nebo all odpoví 400 a vyjmenuje přesná volání, která je třeba poslat, takže nic neselže potichu.

3. Jeden kód pro nákladní dopravu. v1 a v2 dělily nákladní dopravu na 8 (Freight Transport) a 9 (Freight Transport up to 7.5 t). Toto dělení na přechodu reálně existuje, ale žádný integrátor s ním nedokáže pracovat: dotaz na 9 ve v2 na hranici UA-PL vrátil 21 ze 70 nákladních přechodů a nic to nenaznačilo. v4 odpovídá na 9 všemi nákladními pruhy a 8 přijímá jako alias pro 9. Každý řádek nese vlastní crossing_type, takže sloučená odpověď zůstává prozkoumatelná.

Ve v1 a v2 destination=all funguje dál do 6. 10. 2026 a do té doby nese hlavičky Deprecation / Sunset. Od tohoto data odpovídají i tyto verze na all chybou 400 — zbytek v1 a v2 zůstává nedotčen a nadále dostupný. Stejné datum platí pro ostatní zkratky pro všechny země: travel-matrix bez ?dest=, bus-carriers s ?ppid=all a fuel-grades bez ?country=.

v3, ohlášená dnes dříve, je nahrazena verzí v4. v3 se od v4 lišila jen tím, že stále přijímala seznam oddělený čárkou, a žádná integrace tento tvar nepoužívá. URL adresy v3 nadále odpovídají, takže se nic, co bylo napsáno proti nim, nerozbije, ale v3 není zdokumentovaná a nebude se dál vyvíjet — přejděte na v4.

Všechno ostatní ve v4 je jako ve v2: směrové pořadí v cestě, direction{from,to}, stale a ?max_age_min=.

Číselná ID v /border/{origin}/{destination}/{crossing_type} nebyla nikdy zveřejněna jako tabulka, takže si je integrátoři rekonstruovali z časových pásem a ukázkových URL adres. Nyní jsou v dokumentaci pod Kódy zemí a typů vozidel, vykreslené ze stejných tabulek, proti kterým API validuje — ID zemí i s hranicemi, na které se každé rozvine, a každý crossing_type s označením, které API vrací.

Při jejich zveřejňování jsme zjistili, že sandbox a metadata endpointu popisují 8 jako „truck<7.5t“ a 9 jako „truck“. Je to obráceně: API označuje 8 jako Freight Transport a 9 jako Freight Transport up to 7.5 tons, a vždy tomu tak bylo. Pokud jste kód pro nákladní dopravu vybrali podle nápovědy parametru, filtrovali jste opačný pruh, než jste zamýšleli. Opraveno všude a v3 tuto volbu odstraňuje úplně.

API Terms v1.1 nahrazují v1.0 ještě před nabytím její účinnosti a platí od 6. 10. 2026. Přijměte je prosím ve svém dashboardu.

Oddíl 7 nyní říká, co je Trh: země, jejíž data používáte — tedy kde leží přechod nebo hranice, na kterou se ptáte — ne země, ve které žijí vaši uživatelé. Náš dashboard uváděl na různých místech obě možnosti; vynucování vždy znamenalo tu první.

Dvě změny ve váš prospěch. Země již schválené pro váš účet zůstávají použitelné, dokud se posuzuje pozdější změna (přidání země už nepozastavuje ty, které máte). A pokud jsme na deklaraci trhu neodpověděli do 5 pracovních dnů, do naší odpovědi platí plné limity vašeho plánu.

Oddíl 10.3 nyní odpovídá tomu, co dashboard skutečně vyžaduje, a oddíl 13.2 uvádí základ dostupnosti, který měříme a umíme vám jej ukázat.

Tři produkty nyní nesou doplňkové pole data_quality (high nebo low), které označuje, zda je hodnota reálným pozorováním, nebo modelovým odhadem bez živého zdroje počítání na daném přechodu: queue (na nejvyšší úrovni v snapshot a na každém historickém řádku v data[] — na řádcích prognózy chybí), update-info (na obálce) a multi (na podobjektech queue i update_info pro každý přechod). Nejde o nový signál — příznak už interně existoval — ale nikdy nebyl vystaven, takže plně modelovaný přechod vypadal stejně jako přímo měřený. is_realtime je záměrně nezměněné: pro modelované řádky nadále vrací true a změna tohoto významu je zásadní změna na úrovni v2, kterou zde neděláme.

Také z tohoto vydání: produkt queue-advanced už dál nešíří surové počasí z upstreamu. weather_main, temperature a wind_speed nahrazuje odvozený condition_code (stupnice rizika 0–5, null, když počasí není k dispozici), condition a severity.

Od 2026-08-30 se jeden požadavek /api/v1/data/multi zodpoví nejvýše pro 5 hraničních přechodů. Volání, které uvádí více PPID, není odmítnuto: stále vrací 200, ale odpověď se poskytne jen pro prvních 5 ID v ?ppids=. Ostatní ID se ignorují, vrátí se v meta.ppid_cap.ignored a nezapočítávají se do vaší kvóty — volání se účtuje podle toho, co skutečně vrátí.

Dokud volání překračuje limit, obsahuje odpověď hlavičku X-Devapi-Warning: multi_ppid_cap a blok meta.ppid_cap s poli cap, enforced_from, enforced, ppids_asked, ppids_answered a ignored[]. Do 2026-08-30 se tato pole zobrazují s hodnotou enforced: false a s úplnou sadou výsledků, takže nadcházející změnu uvidíte ve vlastních logech.

Sleva z kvóty ve výši poloviny zůstává beze změny. Rozdělte si hraniční přechody do skupin po 5 a ve svém obvyklém cyklu obnovování posílejte jedno volání na skupinu; při častém dotazování jen na délku fronty a aktuálnost dat zůstává levnějším produktem standardní třídy update-info.

Vypočítaný ukrajinský zákaz kvůli horku — vracený s include_ua_heat a u country=UA automaticky — nyní odpovídá za rozsah dat, na který se ptáte. Dříve vracel nejbližších sedm dní bez ohledu na date_from a date_to, takže prosincové okno tiše vrátilo řádky tohoto týdne. Zákaz se počítá z předpovědi počasí, nečte se z kalendáře zákazů, a má proto dvě hranice, které kalendář nemá: nedívá se zpět a končí tam, kde končí předpověď. Váš rozsah se nyní protíná s tím, co předpověď skutečně pokrývá, a nové pole ua_heat_ban.forecast_horizon uvádí poslední dostupné datum. Rozsah za tímto horizontem nevrátí žádné řádky a důvod vysvětlí v summary — to není totéž jako „žádný zákaz“. Odpovědi v1 se nemění.

Tvar odpovědi dosud nebyl nikde popsán — jediný způsob, jak zjistit, co produkt vrací, bylo zavolat ho. Na stránce každého produktu je nyní pod tabulkou parametrů tabulka Pole odpovědi s krátkým popisem každého pole; pole prvků seznamu se zobrazují jako items[].name, pole na úrovni obálky (usage, meta, snapshot, resolved_location) bez předpony. Popsáno je 40 ze 42 produktů: dva dosud nespuštěné (weather, road-quality) záměrně zůstávají bez popisu. Stejná tabulka se publikuje i do našeho veřejného zrcadla dokumentace na GitHubu.

Každý palivový produkt nyní přijímá místní název druhu paliva, nejen náš interní zápis: ON v Polsku, Nafta v Česku, Gázolaj v Maďarsku, Motorină v Rumunsku, ДП na Ukrajině, Motorin v Turecku, Gasóleo v Portugalsku a Španělsku. Název se vyhodnocuje nejprve podle země — „95“ je E10 u dánského stojanu a E5 u polského — proto posílejte country spolu s místním názvem nebo souřadnice, podle nichž bod umístíme. V odpovědi se vrací fuel_type (kanonický), fuel_type_requested (přesně jak jste jej napsali) a fuel_type_local. Název, který neumíme umístit, nikdy nenahrazujeme výchozím druhem: odpověď přijde prázdná a otevřeně to řekne.

Celá tabulka je nyní samostatný produkt — GET /api/v2/data/fuel-grades[?country=PL][&fuel_type=ON] — naše kanonické druhy paliva a jejich místní názvy ve 41 evropských zemích včetně trhů, pro které ceny neuvádíme. Zemská a regionální úroveň produktů fuel a fuel-local navíc dostala objekt grades, který každý cenový klíč přiřazuje k druhu paliva a jeho názvu u stojanu.

Produkt truck-bans nyní odpovídá na konkrétní datum nebo rozsah dat na adrese /api/v2/data/truck-bans. Dosud vždy vracel nejbližších 7 dní a odeslané datum ignoroval, takže sestavení kalendáře znamenalo jeden požadavek na každý den — a u tarifu se dvěma požadavky za sekundu je většina z nich odmítnuta s 429 qps_exceeded.

Použijte ?date=YYYY-MM-DD pro jeden den nebo ?date_from= a ?date_to= pro rozsah. Obě meze jsou včetně a kteroukoli lze vynechat: začátek je ve výchozím stavu dnešek, konec je začátek plus 7 dní. Okno může pokrývat nejvýše 92 dní — delší je odmítnuto s 400 date_range_too_long, místo aby se potichu zkrátilo. Jde o kalendář orientovaný dopředu: okno může začínat nejvýše 7 dní zpět a starší data jsou odmítnuta, nikoli poskytnuta — pokrytí sahá dopředu do 31. prosince 2028 ve 23 zemích.

Každá odpověď nyní obsahuje objekt window, který pojmenovává přesně pokrytý rozsah. Jde o doplňkové pole a posílá se i ve v1, přičemž v1 si ponechává své neměnné sedmidenní okno. Pozor: include_ua_heat vždy pokrývá nejbližších 7 dní bez ohledu na požadované okno — počítá se z předpovědi počasí, nikoli z kalendáře zákazů. Připomínáme, že v1 tohoto produktu končí 8. září 2026.

Dvě související vylepšení v celém API: každý parametr, který produkt nepřijímá, je nyní uveden v poli ignored_params v odpovědi místo tichého zahození, a chyby validace z datové služby k vám dorazí v původním znění, se strojově čitelným kódem v error.reason.

Tři opravy kvality odpovědí z auditu brány (tiket #43).

Hlavička X-API-Key je nyní přijímána vedle Authorization: Bearer a ?key=. Pokud váš HTTP klient posílá klíče hlavičkou s názvem X-API-Key, nyní to funguje — dříve byla tiše ignorována a volání bylo odmítnuto jako missing_api_key. Authorization: Bearer zůstává dokumentovanou a doporučenou formou.

Chybová zpráva při chybějícím klíči nyní jmenuje všechny tři způsoby autentizace (hlavička Bearer, hlavička X-API-Key nebo ?key=) místo pouhého odkazu na registrační stránku.

Adresář checkpoints nyní nese has_day_stats na každém řádku — aditivní boolean, který říká, zda má API Best Time to Cross (day-stats) data pro daný hraniční přechod. Day-stats existují jen pro část monitorovaných přechodů; před dotazováním tento příznak zkontrolujte, abyste se vyhnuli předvídatelným 404. Stávající pole se nemění.

V dokumentaci bylo také opraveno: produkt road-conditions vždy respektoval parametr lang pro lokalizaci popisků — jen nebyl uveden.

Dvě opravy a jedna nová verze produktu truck-bans.

Země oddělené čárkou nyní fungují. ?country= přijímá seznam až 3 kódů ISO-2, například ?country=DE,RO. Delší seznam je odmítnut s 400 too_many_countries, místo aby byl tiše zkrácen — jde o kalendář zákazů po jednotlivých zemích, ne o hromadný feed. Dříve to nefungovalo: oddělovač byl odstraněn, takže DE,RO se četlo jako jediný token DERO, nic neodpovídalo a vracelo se success: true s total_bans: 0 — sebejisté „žádné zákazy“ pro dvě země, které jich dohromady měly 22. Pokud jste to obcházeli jedním požadavkem na zemi, jediný požadavek nyní pokryje všechny a stojí jedno volání místo několika.

Odpovědi nyní hlásí vlastní úplnost. Tři aditivní pole — returned, total_available a truncated — vám řeknou, zda byla odpověď oříznuta. Zejména volání bez rozsahu vrací oříznutý výřez a dosud to nic v těle odpovědi neuvádělo. total_bans si ponechává dosavadní význam (řádky v této odpovědi), takže nic, co už parsujete, se nemění.

v2 je vymezena na jednu zemi. Na /api/v2/data/truck-bans je ?country= povinný a požadavek bez rozsahu je odmítnut s 400 scope_required — tento produkt je kalendář zákazů po jednotlivých zemích, ne hromadný feed. v1 je dnes beze změny — stále přijímá volání bez rozsahu a stále vrací stejných oříznutých 50 řádků jako vždy, takže nic, co vám běží, se právě teď nerozbije. v1 tohoto produktu končí 8. září 2026. Do 7. září slouží normálně; od 8. září je požadavek na v1 odmítnut s 410 Gone a zprávou odkazující na v2. Do té doby každá odpověď v1 nese Deprecation: true, hlavičku Sunset s tímto datem a hlavičku Link pojmenovávající nástupnickou verzi, takže klientská knihovna může termín zobrazit, aniž by kdokoli četl tuto stránku. Migrace: změňte segment verze na /api/v2/data/truck-bans a předejte ?country=.

Jedna oprava dokumentace: parametr date byl odstraněn. Byl dlouho uváděn, ale služba ho nikdy nečetla, takže každý požadavek, který ho posílal, tiše dostal výchozí sedmidenní okno místo dne, o který žádal. Pro výběr dne filtrujte pole upcoming_bans podle jeho pole date. Kód ISO-3 jako DEU se také již nepřekládá na název země v souhrnu, kde produkoval zavádějící „No truck ban data for: Germany.“

Produkt truck-bans nyní vrací celostátní dopravní omezení pro dalších pět zemí: Belgii (BE), Bělorusko (BY), Černou Horu (ME), Severní Makedonii (MK) a Švédsko (SE). Stávající pokrytí Bulharska, Řecka a Portugalska bylo rozšířeno a obnoveno — řecká omezení nyní sahají do září 2027 a Portugalsko je opět naplněno.

Struktura odpovědi se nezměnila. Nové řádky nesou stejné klíče jako každý jiný zákaz: date, time_from, time_until, restriction_type, restriction_details, min_weight_tons a details_url. Pokud omezení platí jen za určité podmínky — běloruské letní zákazy platí například nad 25 °C — je tato podmínka uvedena v restriction_details, proto si toto pole přečtěte dřív, než upozorníte řidiče. min_weight_tons je null, když se pravidlo týká třídy přepravy (nebezpečné věci), nikoli tonáže.

Produkty fuel-stations a fuel-cheapest nyní vracejí ceny jednotlivých stanic v Polsku. Pokrytí je částečné — oblast Trojměstí (Gdaňsk, Gdyně, Sopoty) — proto je Polsko uvedeno v novém doplňkovém poli coverage.sparse_coverage vedle stávajícího seznamu coverage.station_countries. Země uvedená v sparse_coverage má data o stanicích jen pro část svého území; dotaz jinde v této zemi vrátí prázdný seznam spolu s poznámkou o pokrytí, přesně jako dosud. Polské ceny jsou uváděny v PLN.

Chybová zpráva u hromadného dotazu je také srozumitelnější: chybí-li lat, zpráva scope_required nyní odkazuje na produkt fuel (?country=XX) pro celostátní průměrné ceny.

GET /api/v2/data/fuel-local?lat=&lon= nyní určuje cenu na třech úrovních místo dvou: station, poté region, poté country. Nová prostřední úroveň existuje pro Ukrajinu, kde ceny jednotlivých stanic nikde nejsou: bod na Ukrajině nyní dostane průměr své oblasti místo celostátního průměru a na celostátní průměr se vrátí jen tehdy, když pro oblast nejsou kotace.

Odpověď úrovně region obsahuje kód oblasti (hodnota ISO 3166-2, například UA-46), region_name a region_center_dist_km a stejné cenové klíče jako úroveň země. Kód nadále větvete podle resolution, nikdy podle tvaru odpovědi; odpovědi station a country zůstávají beze změny.

Nový endpoint GET /api/v2/data/fuel-local?lat=&lon= vrací nejlepší dostupnou cenu paliva pro libovolný bod v Evropě. Tam, kde máme data o jednotlivých stanicích, odpoví cenami nejbližších stanic, jinak celostátním průměrem země, v níž bod leží – včetně Ukrajiny, kde ceny jednotlivých stanic nikde nejsou.

Každá odpověď obsahuje pole resolution, které uvádí úroveň, jež odpověděla: station (seznam stanic s distance_km, každá ve vlastní měně) nebo country (jeden objekt s celostátními průměry). Větvete kód podle resolution, nikdy podle tvaru odpovědi. Dostupné od /api/v2/; fuel, fuel-stations a fuel-cheapest zůstávají beze změny.

Produkty fuel-stations a fuel-cheapest nyní pokrývají výrazně více stanic v Německu a ceny se obnovují v průběhu celého dne — včetně venkovských oblastí. Parametr fuel_type přijímá 13 druhů paliva: diesel, e5, e10, superplus, super100, premdiesel, truckdiesel, hvo, lpg, cng, adblue, e85 a lng. Pokud dotazu neodpovídá žádná stanice, odpověď obsahuje objekt coverage se seznamem zemí, pro které jsou data o stanicích k dispozici.

Parametr radius= je nyní přijímán jako kompatibilní alias pro radius_km u všech produktů, které jej dokumentují. Produkty fuel-stations a fuel-cheapest vracejí aditivní objekt coverage (seznam zemí se stanicemi a poznámka) místo tichého prázdného výsledku, když neodpovídá žádná stanice. Objekty hraničních přechodů v route-plan nyní obsahují aditivní klíč wait_basis (car_lane versus vehicle_lane), takže klient pozná, kdy jsou čekací doby pro kamiony převzaty z pruhu pro osobní auta. Přiřazování kamionových přechodů podél trasy je podstatně přesnější: záloha z osobního pruhu u dvojic přechodů bez dat pro nákladní pruh, pojistka proti špatnému směru, přísnější limit vzdálenosti a odstranění duplicit přechodů na stejné pozici. Všechny změny jsou aditivní, žádné nekompatibilní změny.

Vstupní stránka pro vývojáře má nyní sekce s kotvami (#products, #plans, #quickstart, #integrations, #datasets, #apps, #companies, #showcase) se skokovou navigací a každá karta produktu odkazuje na vlastní stránku dokumentace. Nová sekce Mobile apps představuje Kordon Online a Truck Bans s odkazy na Google Play. Doplnění překladů: historie plateb, chyby přihlášení, odkazy na sandbox a tlačítko výběru plánu jsou nyní lokalizovány ve všech 25 jazycích.

Odpověď flotilového majáku (POST /api/v1/fleet_position.php) nyní obsahuje pole messages, které doručuje čekající zprávy od vlastníka řidiči. Nový živý JSON kanál pouze pro vlastníka (?ajax=live) a karta „Zprávy pro řidiče“ na panelu flotily. Nová stránka pozvánky pro řidiče /{lang}/get-nakbus (25 jazyků).

Lokalizován název, popis a parametry product_fleet_vehicles/live/history a parametry historie flotily ve všech 25 jazycích vývojářského portálu.

/api/v1/data/truck-bans nyní vrací stejnou sadu polí nejvyšší úrovně bez ohledu na to, který dotaz odpověď vyvolal. Dříve mohl dotaz pro zemi bez kalendářních zákazů, nerozpoznané ppid nebo běžná shoda v databázi vynechat různá pole (např. country, covered_countries, ppid). Nyní každá odpověď důsledně obsahuje as_of, bans_by_country, countries_not_covered, country, covered_countries, current_bans, is_ban_active, lang, page_url, ppid, relevant_countries, source, success, summary, total_bans a upcoming_bans (null nebo prázdné, pokud se neuplatňuje), což zjednodušuje zpracování na straně klienta.

Devět nových produktů pro jednotlivé služby. Ty, které souvisejí s lokalitou, přijímají lat/lon nebo city + country (město za vás geokódujeme sami): /api/v2/data/truck-parkings, /api/v2/data/shops, /api/v2/data/showers, /api/v2/data/restaurants, /api/v2/data/industrial, /api/v2/data/fuel-stations, /api/v2/data/fuel-cheapest (stanice seřazené podle ceny pro daný typ paliva) a /api/v2/data/internet-points; výsledky obsahují distance_km a jsou omezeny radius. /api/v2/data/vignettes odpovídá, zda země vyžaduje dálniční známku, s aktuálními cenami. Stávající produkt pois nyní podporuje lon a radius podle dokumentace a režim mode=nearest produktu fuel také přijímá lon. Všech devět je dostupných v sandboxu.

Každý zákaz v /api/v1/data/truck-bans nyní obsahuje restriction_type (General / Local / Sunday / Holiday / Seasonal), restriction_details (přesný rozsah nebo dotčené silnice) a min_weight_tons. details_url nyní směřuje na stránky pro jednotlivé země na nakordoni.eu. Nový volitelný parametr lang vybírá jazyk názvů zemí a souhrnu; výchozí je nyní angličtina.

Chybný ?ppid= nyní vrací skutečný důvod namísto strohého "Request failed": chyba pojmenuje parametr, očekávaný formát id_<number> a odkáže na /api/v1/data/checkpoints. Tabulky parametrů pro stats, forecast, update-info, weather a bus-carriers nyní zobrazují příklad id_13 ve všech 25 jazycích.

Přepracované rozhraní portálu (horní lišta, ikonový postranní panel, KPI přehled, kartové rozvržení) je nyní výchozí pro všechny přihlášené vývojářské účty — dříve, než bylo plánované spuštění 10. srpna. Ke klasickému rozvržení se kdykoli vrátíte pomocí ?v=1 .

Všechny stránky vývojářského portálu — úvod, dokumentace, přehled, AI Studio, sandbox, tikety, žádosti, export, vozový park, novinky, seznam změn a stránky účtu — už nenačítají žádné reklamní skripty ani reklamní plochy. Platí to pro celý portál, nejen pro přihlášení a registraci jako dosud.

Naplánujte celou cestu přes hranici jedním voláním: /api/v2/data/route-plan vrátí trasu, hraniční přechody, které na ní opravdu leží, se živou frontou nebo předpovědí na čas vašeho příjezdu, a zastávky, které řidič skutečně dělá — odpočinek, jídlo, tankování — na jedné časové ose.

Hranice je součástí této osy. Dlouhá fronta se počítá jako již splatná přestávka a nuluje dobu za volantem, takže tříhodinové čekání se nikdy neuvádí jako tři hodiny plus celá sada přestávek, které nikdo neudělal. Pro osobní auta platí model bezpečné jízdy; autobusy a kamiony mají povinný odpočinek podle EU 561/2006 a servisní režie autobusů je kalibrována na více než 1000 licencovaných mezinárodních jízdních řádů. Přidejte stop_places=1, aby každá zastávka dostala skutečné odpočívadlo nebo čerpací stanici, a via=lat,lon, chcete-li vést trasu jiným přechodem.

Novinka v nabídce portálu: Prezentace — živá, vždy aktuální prezentace datové platformy nakordoni přizpůsobená vašemu trhu (pojištění, cestování, logistika, dopravci, média, navigace, palivo, fintech, veřejný sektor nebo osobní projekty). Ukazuje skutečné 30denní objemy platformy, vaše vlastní využití API, statistiky doby odezvy a limitů i doporučení tarifu, jakmile vaše volání narazí na hranice bezplatné úrovně. Trh (či trhy) si vyberte nebo potvrďte na stránce, ve svém profilu — nebo při registraci. Při první návštěvě se otevře automaticky; automatické otevírání lze vypnout přímo na stránce.

Pokud má asistent zapnutý kanál, ale volání nenese kontext, který tento kanál potřebuje — například queue bez ppid—, kanál se nyní přeskočí ještě před jakýmkoli požadavkem a neúčtuje se. Dříve se přesto zavolal, selhal a stejně stál jednotku. Studio ukazuje, co každý kanál potřebuje, při doplňování kontextu přepočítává cenu a označuje výsledky ✓ proběhl / ⊘ přeskočen, bez poplatku / ✕ selhal; API vrací data.feeds_skipped , které přesně říká, který parametr předat.

Odpovědi už nezmiňují kanály, zdroje dat ani nic technického: chybějící kanál je nanejvýš jedna běžná věta pro koncového uživatele, nikdy interní název. Kanály, které mají jen volitelné filtry (například fuel zúžený na zemi, o níž nemáme data), se nyní vrátí k širokému souboru dat, místo aby nevrátily nic.

Novinka: /{lang}/developers/studio. Postavte si AI asistenta, který odpovídá z vašeho obsahu a našich živých hraničních dat. Dejte nám svůj markdown, nebo jen uveďte stránky a my je stáhneme a zaindexujeme — udržujete pouze vlastní soubory. Vyberte, které z našich kanálů může používat (fronta, předpověď, alternativy, denní statistiky, palivo, zákazy pro kamiony, prodejní neděle, svátky, stav silnic, autobusoví dopravci, POI, měna), zvolte úroveň modelu (rychlý / vyvážený / pro — právě ta určuje cenu), napište vlastní instrukce se zástupnými symboly {{feed.slug}} , které přesně určují, kam v odpovědi patří naše data, a přidejte vlastní závěrečnou větu připojovanou ke každé odpovědi. Hotové vzory: osobní cestovní asistent, pracovní/nákladní asistent, asistent pro prodej pojištění a zelené karty.

Otestujte ho ve studiu (30 odpovědí denně, odděleně od vaší API kvóty) a pak ho v produkci volejte přes GET /api/v2/data/assistant-custom?assistant_id=N&q=…. Cena za odpověď = jednotky úrovně modelu + 1 jednotka za každý zapnutý kanál, vrácená v X-Devapi-Units. Produkt je pouze ve v2 — URL v1 vrátí unsupported_version. Stávající produkt assistant se nemění.

Každý asistent běží pod obsahovou politikou platformy, která má přednost před vašimi instrukcemi: žádné vydávání se za úřední osoby, žádná pomoc s obcházením hraniční či celní kontroly, žádná vymyšlená čísla, žádné vulgarismy. Kontrolují se instrukce i odpovědi; zablokovaná volání se zaznamenávají.

Novinka: skutečný MCP server na adrese https://nakordoni.eu/mcp, který zpřístupňuje bezpečnou podmnožinu API pouze pro čtení (status, checkpoints, border queue, live queue, forecast) jako MCP nástroje. Stejný API klíč a kvóta jako u REST API. Karta serveru na adrese /.well-known/mcp/server-card.json. Viz sekce MCP server v dokumentaci.

Níže popsané přejmenování na „Live Queue & Freshness API“ se ve skutečnosti nedostalo na stránku dokumentace . Stránka vypisuje název každého produktu přes vyhledání překladu, které sáhne po názvu koncového bodu jen tehdy, když překlad neexistuje — a překlad už existoval, zamrzlý na starém názvu, ve všech 25 jazycích rozhraní. Nyní má přednost před jakoukoli budoucí změnou základního názvu, dokud nebude aktualizován i on.

Klíč překladu jsme přejmenovali ve všech 25 jazycích, takže stránka dokumentace už sedí. Žádná změna koncového bodu, parametrů ani odpovědi — pouze text názvu.

Pokud často dotazujete data o živé frontě, možná zbytečně utrácíte těžkou kvótu. /update-info patří do standardní třídy a živou hodnotu už vrací:

GET /api/v1/data/update-info?ppid=id_13

Vrací queue_now, freshness, age_minutes, is_realtime, status, timestamp a timezone. Použijte jej pro časté obnovování ze své standardní denní kvóty a /queue, /multi a /forecast (všechny těžké třídy) si nechte na případy, kdy potřebujete wait_min, pole trendu nebo historii.

V samotném koncovém bodu se nic nezměnilo — jen v jeho dokumentaci. Byl uveden jako „Data Freshness API“ a jeho popis zmiňoval pouze hodnocení čerstvosti, nikdy queue_now, takže se dal snadno přehlédnout. Nyní se jmenuje „Live Queue & Freshness API“ a vracená pole jsou vypsaná. Děkujeme vývojáři, který na to upozornil.

Některé neúspěšné požadavky vracely HTTP 200 s ok: true a chybou ukrytou uvnitř data — zdokumentovaný vzor if (!ok) throw je tedy nedokázal odhalit a volání se stejně účtovalo. Dotčená volání nyní vracejí HTTP 400 s ok: false a řádnými error.code / error.messagepodle dokumentace. Zaznamenáno u fuel-cities s nepodporovanou zemí a u travel-matrix s chybnými souřadnicemi.

Odděleně: chybějící povinný parametr vracel 500 internal_error místo 400 bad_request (tělo odpovědi 4xx z interní služby se zahodilo dříve, než se přečetl její status). Nyní se vrací 400 bad_request se zprávou interní služby — např. search bez ?name=.

Úspěšné odpovědi jsou nezměněné do posledního bajtu — stejná pole, stejné parametry, stejná cena kvóty. Pokud se váš klient už větví podle ok, nemusíte měnit nic. Pokud ok ignoroval a četl přímo data , uvidí nyní chybové obálky u volání, která stejně vždy selhávala.

Opravili jsme chybu, kdy /multi mohl vrátit nesprávný počet aut ve frontě pro některé přechody — hlavně balkánské a na hranici Maďarsko–Srbsko — vždy, když byla jeho cache studená. Záložní cesta četla tabulku, která pro tyto přechody neobsahuje data o frontě, a nesouvisející hodnoty hlásila jako počty aut. Naměřené příklady: přechod s 12 auty hlásil 6 a několik se skutečnými frontami hlásilo 0.

Tři změny, kterých si můžete všimnout:

• found: false nyní znamená, že opravdu nejsou žádná čerstvá data o frontě. Dříve jste mohli dostat found: true s vymyšleným queue_now: 0.
• wait_status, trend_percent a trend_direction se nyní vracejí i u studených požadavků — dříve byly null .
• Koncový bod přejde na záložní cestu i tehdy, když je jeho uložený snímek zastaralý (starší než 24 h), nejen když chybí.

Žádné změny parametrů požadavku, ceny kvóty ani struktury odpovědi.

Opravena chyba, kvůli které se každé volání /multi účtovalo dvakrát — jednou obecnou kontrolou 1 jednotky a podruhé vlastním vzorcem proměnlivých nákladů endpointu (N PPID × podprodukty). Volání nyní stojí přesně ⌈(N×M)/2⌉ jednotek dle dokumentace, bez dalšího poplatku.

Na stránce dokumentace jsme také přidali odznak třídy kvóty (Standard/Heavy) u každého produktu, aby bylo na první pohled jasné, ze které denní kvóty daný endpoint čerpá.

country a countries byly sloučeny do jednoho parametru (1-15 kódů oddělených čárkou). Nový parametr compare_to: porovnání stejných a odlišných svátků mezi zeměmi, kombinuje se s upcoming+days. lang nyní přijímá více jazyků (přidává objekt names). days=0 nebo vynechání nyní znamená bez omezení v režimu upcoming.

Oficiální státní svátky pro každou evropskou zemi — data, místní názvy a typ. Postaveno na téže službě Nager.Date / OpenHolidaysAPI (s lokálně vypočítaným kalendářem Kosova), která pohání stránku kalendáře svátků nakordoni.eu a kalendářní faktory předpovědního systému.

• ?country=PL&year=2026 — úplný roční seznam svátků pro jednu zemi
• ?upcoming=1&days=30 — plochý seznam nadcházejících svátků napříč zeměmi
• Bez parametrů — index základní sady zemí s nejbližším svátkem pro každou

Přidán produkt currency — směnné kurzy vůči EUR pro PLN, CZK, HUF, USD, GBP, CHF, NOK a UAH, ze zdroje Frankfurter (ECB), ukládané do mezipaměti na 6 hodin. Bez parametrů, vždy vrací kompletní tabulku kurzů. Viz dokumentace.

Vložte na vlastní web aktuální evropské zákazy jízdy kamionů — bezplatný iframe widget se 3 designy (light, dark, board), 5 jazyky (en, uk, pl, de, ru), volitelným filtrem podle země a živým stavem «aktivní nyní». Klíč API není potřeba. Nastavte a zkopírujte kód na nakordoni.eu/en/for_truck_drivers/traffic_bans/widget. Preferujete surová data? Produkt API truck-bans a veřejný JSON kanál zůstávají dostupné.

Tři novinky, všechny zpětně kompatibilní — v1 beze změn.

Verzování na úrovni endpointů. Nyní existuje základní URL /api/v2/. Funguje na úrovni endpointů: odlišně se chovají pouze endpointy, které se skutečně změnily; každý ostatní endpoint transparentně vrací svou odpověď v1 (takže /api/v2/data/queue = stejná data jako v1, jen s "api_version":"v2"). Fungující endpointy migrovat netřeba.

border v2 je směrový. Pořadí v cestě určuje směr jízdy:

GET /api/v2/data/border/1/2/6   → buses UA→PL (Ukrainian-side crossings)
GET /api/v2/data/border/2/1/6   → buses PL→UA (Polish-side crossings)

Každý hraniční přechod navíc získává objekt direction {from,to} a booleovskou hodnotu stale, a ?max_age_min=N vrací pouze nedávno aktualizované přechody. (v1 border stále vrací obě strany hranice bez ohledu na pořadí — beze změn.)

Interaktivní Sandbox. Přihlášení vývojáři nyní mohou vyzkoušet libovolný endpoint z prohlížeče na Developers → Sandbox — vyberte endpoint, verzi a jeden ze svých klíčů, upravte parametry a uvidíte živou odpověď. Testování v Sandbox má vlastní samostatný denní rozpočet (50 calls/day) a nikdy se nedotýká vaší produkční kvóty API.

Dokumentace je nyní rozdělena podle endpointů (Developers → API Docs) s přepínačem verzí u endpointů, které mají více než jednu verzi.

Dva nové faktory zapojené do vzorce čekací doby, vedle stávajících úprav section_mode a počasí:

• service_rate — naměřený počet aut/min aktuálně odbavovaných oproti nakonfigurované základní rychlosti přechodu. Multiplikativní, v rozmezí 0.5x-1.5x.
• shift_change — vliv vlastního místního střídání směn pohraniční stráže v 08:00/20:00 na daném přechodu. Aditivní (minuty), nikoli multiplikativní — uplatňuje se pouze v rozmezí +/-60 minut od střídání, vyžaduje minimální historii vzorků, omezen na +/-120 minut.

advanced_wait_min je nyní round(base_wait × section_mode × weather × service_rate) + shift_change.adjustment_min. Oba faktory se také promítají do driver_reported.prognosed_advanced_wait_min pro historická porovnání.

V rámci bezpečnostní/soukromí revize byla odstraněna následující pole — odhalovala interní detaily implementace (naši taxonomii zdrojů dat, ID řádků DB, interní anotace pipeline, nepoužívaná/mrtvá pole) bez reálné produktové hodnoty:

• id a corrected — odstraněno z objektů řádků queue
• source (surový řetězec, např. "line") — odstraněno z queue, multi a update-info. update-info a multi (jeho blok update_info) stále obsahují source_category/source_label_en (malý veřejný slovník); queue a multi (jeho blok queue) již neobsahují žádné pole zdroje
• traffic_status — odstraněno z border; vždy bylo null a nikdy nebylo naplněno žádnou částí systému

Pokud vaše integrace čte kterékoli z těchto polí, aktualizujte ji — viz aktuální seznam polí na stránce dokumentace příslušného produktu.

Denní spotřeba kvóty (usage.used v každé odpovědi) může nyní být desetinná hodnota (např. 67.5) namísto vždy celého čísla. Jde o vedlejší efekt toho, že queue-advanced je účtován zlomkovou sazbou — viz níže. usage.limit zůstává beze změny a je vždy celé číslo. Pokud váš klient striktně typuje usage.used jako celé číslo, rozšiřte jej, aby přijímal desetinnou/plovoucí hodnotu.

Tyto tři produkty nyní vracejí stejná pole živého stavu, jaká zobrazuje web: wait_status (green/yellow/red, na základě vlastní nedávné historie tohoto přechodu) a trend_percent/trend_direction (up/up-slight/down/down-slight/stable, porovnání posledních 3 hodin). Čistě aditivní.

V /api/v1/data/queue měly řádky data[] dříve wait_time: null pro většinu zdrojů — jen několik externích kanálů hlásí čekací dobu přímo. Řádky bez ní nyní dostávají standardní odhad , označený novou booleovskou hodnotou wait_time_estimated, abyste rozlišili skutečně nahlášenou hodnotu od vypočítané.

queue-advanced nyní stojí 1.5 jednotky za volání místo 1 (odráží dodatečné dotazy na provoz/počasí/hlášení řidičů, které provádí) — viz usage.used výše. Odpověď již také neobsahuje total_crossing_time a driver_reported je nyní jen {wait_min, ts, age_min} — předchozí pole porovnání prognózy se skutečností (prognosed_wait_min, diff_min, historical_section_mode, historical_weather atd.) byla odstraněna. section_mode, weather, advanced_wait_min a exceeds_crossing_time zůstávají beze změny.

/api/v1/data/truck-bans nyní vrací pro každou zemi v bans_by_country hodnotu status (active/clear) plus active_window, next_window, local_time a tz — vypočítané ve vlastním časovém pásmu dané země, takže už nemusíte sami porovnávat surová okna zákazů s hodinami. Odpověď také přidává seznam covered_countries nejvyšší úrovně a UTC časové razítko as_of.

GET /api/v1/data/truck-bans?country=PL

Čistě aditivní — stávající pole current_bans/upcoming_bans/bans_by_country zůstávají beze změny. Neznámý ?country= nyní vrací prázdný výsledek s countries_not_covered místo zákazů všech zemí.

Nový volitelný produkt, který upravuje standardní čekací dobu podle živého toku provozu a počasí. Vrací kompletní rozpis každé úpravy.

GET /api/v1/data/queue-advanced?ppid=id_13

Poskytováno na vyžádání — otevřete tiket Data ve svém panelu, abyste jej povolili.

/api/v1/data/border nyní správně počítá wait_min pro každý přechod v odpovědi, stejně jako produkty queue a multi. Dříve bylo toto pole vždy null.

/api/v1/data/forecast nyní spolehlivě používá ansámblový model v4 pro jakoukoli hodnotu prediction_steps (dříve se některé nestandardní horizonty mohly tiše vrátit ke staršímu modelu). Faktor počasí, který napájí ansámbl, byl také opraven a nyní skutečně odráží aktuální podmínky (déšť, sníh, vítr, mlha) místo toho, aby vždy hlásil nedostupnost.

Schválení vývojáři nyní mohou stahovat hodinově zprůměrovaná historická data hraničních front pro až 5 přechodů (klouzavé okno až 90 dní) ve formátu CSV nebo NDJSON z nové záložky Data export. Data jsou pouze publikovaná a zkontrolovaná na kvalitu; časová razítka v UTC. Potřebujete přístup? Otevřete tiket Data.

Ještě nemáte web? Nyní si můžete vytvořit vývojářský účet tím, že popíšete, kde a jak plánujete naše data využít, místo povinného zadání URL funkční stránky. Skutečnou URL doplňte později ze svého panelu (Account & data → Your project), jakmile bude váš web nebo aplikace v provozu — viditelný zpětný odkaz na nakordoni.eu na této stránce vyžadují naše Podmínky.

Vývojáři nyní mohou odesílat vlastní hraniční zprávy do zpravodajské linky Nakordoni. Pokud je naši editoři zveřejní, získáte indexovatelný zpětný odkaz dofollow na vaši službu (zmínka o vydavateli + řádek zdroje) a my zdarma přeložíme článek do všech 24 jazyků.

Jeden článek týdně je zdarma; další články jsou placený doplněk. Zvolte 'můžeme mírně upravit + přidat interní odkazy' nebo 'zveřejnit tak, jak je'. Odesílejte a sledujte stav kontroly v sekci Developers → Submit news.

Multi-Checkpoint API (/api/v1/data/multi) nyní účtuje kvótu podle vzorce ⌈(N PPIDs × sub-products) / 2⌉ — poloviční náklady oproti ekvivalentním jednotlivým voláním. Požadavek na 10 přechodů s oběma podprodukty nyní stojí 10 jednotek místo 20. Hlavička X-Devapi-Units a meta.units_consumed v odpovědi odrážejí sníženou částku.

Získejte živý stav front a čerstvost dat pro až 20 přechodů jedním voláním API — navrženo pro tvůrce dashboardů, kteří nyní dotazují mnoho PPIDs ve smyčce.

Kvóta se počítá spravedlivě jako N PPIDs × sub-products požadovaných, takže celková spotřeba je totožná s jednotlivými voláními — ale s jedním dotazem místo mnoha. Vzory ve stylu GreenTravel klesají z 24+ volání/hodinu na 2.

GET /api/v1/data/multi?ppids=id_2,id_13,id_15,id_59&include=queue,update-info&lang=en

• include=queue — aktuální queue_now, odhadovaný wait_min, stáří dat a název přechodu
• include=update-info — čerstvost dat, klasifikace zdroje, stáří v sekundách/minutách
• Maximálně 20 PPIDs na požadavek; zkombinujte oba podprodukty v jednom volání pro kompletní data dashboardu
• Odpověď obsahuje meta.units_consumed, takže můžete přesně sledovat spotřebu kvóty

Odpověď produktu queue nyní obsahuje objekt snapshot nejvyšší úrovně s nejnovějšími daty v reálném čase a vypočítanou prognózovanou čekací dobou — stejný vzorec, jaký se používá v hero sekci nakordoni.eu:

snapshot.queue_now  — current cars in queue
snapshot.wait_min   — prognosed wait time (minutes)
snapshot.updated_at — when the queue data was recorded
snapshot.age_min    — minutes since last update
snapshot.source     — data source identifier

Pole data (historické záznamy) zůstává beze změny — jde o čistě aditivní rozšíření. Klientů, kteří snapshot nečtou, se to netýká.

Dotazujte se na všechny přechody na dané hranici + typ vozidla jedním voláním místo samostatného požadavku pro každý PPID.

GET /api/v1/data/border/{origin}/{destination}/{crossing_type}

• Podporuje jednu cílovou zemi, seznam oddělený čárkami nebo all pro rozšíření na všechny sledované sousedy najednou.
• Výsledky seřazené podle queue_now vzestupně (nejkratší fronta první).
• Plně lokalizováno: přidejte ?lang=uk (nebo kterýkoli z našich 22 podporovaných jazyků) pro získání názvů přechodů v daném jazyce.

Vyhledávejte hodnoty PPID přechodů podle názvu bez procházení celého adresáře.

GET /api/v1/data/search?name=Krakovets,Shehyni&lang=en

• Přijímá jeden název nebo seznam oddělený čárkami (až 20).
• Vyhledává ve všech 24 jazycích překladu — zadejte název v ukrajinštině, polštině, němčině nebo kterémkoli podporovaném jazyce a bude nalezen.
• Vrací všechny PPIDs v dané lokalitě seskupené podle typu vozidla (auto / autobus / chodec / kamion).

Produkt alternatives nyní přijímá ?lang= ve všech 22 podporovaných jazycích (dříve pouze 12).

Nový parametr crossing_type umožňuje přepsat filtr typu vozidla — např. předejte crossing_type=4 pro získání alternativ pro auta i při dotazu z autobusového PPID.

Pole crossing_type_label v odpovědích checkpoints, border a search se nyní překládá do požadovaného jazyka ve všech 22 podporovaných jazycích. Pole názvů zemí (origin_name, destination_name) se řídí stejnou lokalizací.

Portál Nakordoni Developer API běží na adrese /en/developers. Zaregistrujte si bezplatný klíč Explorer (200 requests/day) pro přístup k datům hraničních front, předpovědím, cenám paliva, POI pro řidiče a dalšímu.

Produkty dostupné při spuštění: checkpoints, queue, stats, day-stats, forecast, alternatives, update_info, fuel, pois, truck_bans, trading_sundays, bus_carriers, road_conditions, assistant.