Odosielanie správ a flotila NakBus sú teraz na partnerskom paneli

Na prihlásenie do panela Nakordoni Partners použite rovnaké prihlasovacie údaje (e-mail a heslo) ako pre svoj vývojársky účet a spravujte tam správy a svoj autobusový vozový park (NakDriver / NakManager) s tímovými rolami. Vaše kľúče API, koncové body a aplikácie zostávajú nezmenené a stránky tu naďalej fungujú. Otvoriť Nakordoni Partners

Rozpoznávanie EČV API (ALPR / ANPR) Online

Prečíta evidenčné čísla vozidiel na fotografii. Odošlite POST s jedným obrázkom (JPEG, PNG, WebP, BMP alebo TIFF, max. 8 MB) ako telo JSON s image_url alebo image_base64, ako nahrávanie multipart/form-data v poli "image", alebo ako surové bajty s hlavičkou Content-Type image/*. Každá nájdená tabuľka sa vráti s textom, skóre 0-1, alternatívnymi čítaniami, rámčekom tabuľky v pixeloch a skóre detekcie. Engine je náš vlastný detektor a čítač tabuliek, vyladený na európske nákladné autá a autobusy. Obrázky sa spracúvajú v pamäti a nikdy sa neukladajú. image_url musí byť verejná adresa http(s); súkromné a interné adresy aj presmerovania na ne sa odmietnu a sťahovanie sa zastaví po 10 sekundách.

POST https://nakordoni.eu/api/v2/data/plate-recognition — trieda kvóty: heavy

Parameter	Popis
`image_url`	(telo JSON) Verejná URL obrázka http(s). Max. 8 MB, max. 3 presmerovania, limit sťahovania 10 s.
`image_base64`	(telo JSON) Obrázok vo formáte base64 (povolený je aj prefix data:image/...;base64,). Odošlite image_url alebo image_base64, nie oboje.

Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.

Pole	Popis
`data.success`	true, keď sa prečítala aspoň jedna tabuľka; data.message uvádza koľko.
`data.processing_time`	Čas strávený spracovaním požiadavky v milisekundách (sťahovanie a rozpoznávanie).
`data.results[]`	Jeden záznam na tabuľku, najprv s najvyšším skóre detekcie.
`data.results[].plate`	Text tabuľky, veľkými písmenami, iba písmená A-Z a číslice (bez medzier a pomlčiek).
`data.results[].score`	Istota čítania 0-1 (priemer istôt jednotlivých znakov).
`data.results[].candidates[]`	Až 5 čítaní {plate, score}, najlepšie prvé; prvé z nich je tabuľka.
`data.results[].region`	{code, score} s krajinou tabuľky, ak ju engine dokáže určiť; inak null (aktuálny engine krajinu neodvodzuje).
`data.results[].box`	Poloha tabuľky v pixeloch: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Istota detekcie tabuľky 0-1.
`data.results[].vehicle`	Údaje o vozidle, ak sú dostupné; pri aktuálnom engine null.
`error.code`	400: image_required, bad_json, bad_base64, one_image_only, bad_image_url, image_url_not_allowed, image_url_fetch_failed, image_url_timeout, invalid_image, unsupported_image_type, unsupported_content_type, upload_failed. 404: no_plate_detected. 413: payload_too_large. 500: engine_error.

curl -X POST "https://nakordoni.eu/api/v2/data/plate-recognition" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://nakordoni.eu/img/developers/plate-recognition-example-bus.jpg"
}'

V porovnaní s V1: nové parametre regions, camera_id, timestamp, config, threshold, mode

Čo je iné v tejto verzii: v4 vypĺňa dve polia, ktoré v2 vždy vracia ako null. results[].region udáva krajinu EČV ako {code, score}, prečítanú z formátu tabuľky: vzor písmen a číslic každej krajiny a, ak ho formát má, predponu regiónu alebo okresu (napríklad CE z ukrajinskej tabuľky). results[].vehicle udáva vozidlo, ktoré nesie tabuľku, ako {type, score, box}, z nášho detektora vozidiel: type je car, bus, truck alebo motorcycle. v4 prijíma aj voliteľné možnosti požiadavky: regions, camera_id, timestamp, config.threshold a config.mode. Bez nich sa výstup v4 nemení. Ostatné polia odpovede a chybové kódy sú rovnaké ako vo v2. v2 naďalej vracia null pre obe polia a možnosti ignoruje.

POST https://nakordoni.eu/api/v4/data/plate-recognition — trieda kvóty: heavy

Parameter	Popis
`image_url`	(telo JSON) Verejná URL obrázka http(s). Max. 8 MB, max. 3 presmerovania, limit sťahovania 10 s.
`image_base64`	(telo JSON) Obrázok vo formáte base64 (povolený je aj prefix data:image/...;base64,). Odošlite image_url alebo image_base64, nie oboje.
`regions`	Voliteľné. Krajiny, ktoré očakávate, ako kódy ISO 3166-1 alpha-2: pole JSON ["PL","DE"] alebo reťazec oddelený čiarkami "PL,DE" (pole multipart alebo parameter dopytu). Najviac 10. Odhad regiónu a poradie čítaní uprednostňujú tieto krajiny: keď najlepšie čítanie nezodpovedá formátu žiadnej uvedenej krajiny, ale iný kandidát so skóre nižším najviac o 0.15 zodpovedá, tento kandidát sa stane EČV. EČV, ktorá nezodpovedá žiadnej uvedenej krajine, si ponechá bežnú odpoveď.
`camera_id`	Voliteľné. ID vašej kamery alebo brány, najviac 128 znakov. Vrátené nezmenené v data.camera_id. Neukladá sa nad rámec bežného záznamu požiadaviek.
`timestamp`	Voliteľné. Čas zachytenia vo vašom vlastnom formáte (napríklad 2026-10-27T14:05:00Z), najviac 64 znakov. Vrátené nezmenené v data.timestamp. Neukladá sa nad rámec bežného záznamu požiadaviek.
`config`	Voliteľné. Objekt JSON {"threshold": 0-1, "mode": "fast"\|"full"}. Vo formulári multipart alebo v reťazci dopytu ho pošlite ako reťazec JSON, alebo použite polia threshold a mode.
`threshold`	Voliteľné, rovnaké ako config.threshold. Výsledky so skóre pod touto hodnotou (0-1) sa vynechajú. Ak nezostane žiadny, odpoveď je 404 no_plate_detected.
`mode`	Voliteľné, rovnaké ako config.mode. full (predvolené) spúšťa rozpoznávanie EČV a detekciu vozidla. fast preskočí detekciu vozidla pre rýchlosť podobnú v2: region sa stále vypĺňa, vehicle je null.

Pole	Popis
`data.success`	true, keď sa prečítala aspoň jedna tabuľka; data.message uvádza koľko.
`data.processing_time`	Čas strávený na požiadavke v milisekundách (stiahnutie, rozpoznávanie EČV a detekcia vozidla). v4 trvá dlhšie ako v2 kvôli detekcii vozidla, typicky 0.5-1.5 s na obrázok. S config.mode=fast detekcia vozidla neprebieha a čas je blízky v2.
`data.camera_id`	camera_id, ktoré ste poslali, nezmenené. Prítomné, iba ak ste ho poslali.
`data.timestamp`	timestamp, ktorý ste poslali, nezmenený (reťazec ostáva reťazcom, číslo číslom). Prítomný, iba ak ste ho poslali.
`data.results[]`	Jeden záznam na tabuľku, najprv s najvyšším skóre detekcie.
`data.results[].plate`	Text tabuľky, veľkými písmenami, iba písmená A-Z a číslice (bez medzier a pomlčiek).
`data.results[].score`	Istota čítania 0-1 (priemer istôt jednotlivých znakov).
`data.results[].candidates[]`	Až 5 čítaní {plate, score}, najlepšie prvé; prvé z nich je tabuľka.
`data.results[].region`	{code, score}: code je krajina tabuľky podľa ISO 3166-1 alpha-2 (napríklad UA, PL, RO), určená z formátu tabuľky. score 0-1 je istota čítania vynásobená mierou špecifickosti formátu; ak rovnaký formát používa viac krajín (napríklad LT, MD a HU zdieľajú ABC123), skóre sa medzi ne rozdelí a je nízke. null, keď text nezodpovedá žiadnemu známemu formátu. Podporované: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE.
`data.results[].box`	Poloha tabuľky v pixeloch: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Istota detekcie tabuľky 0-1.
`data.results[].vehicle`	{type, score, box}: vozidlo, ktoré nesie tabuľku. type je car, bus, truck alebo motorcycle; score je istota detekcie 0-1; box je poloha vozidla v pixeloch (xmin, ymin, xmax, ymax). Autobusy videné spredu a minibusy či dodávky môžu byť typu truck (detektor nemá triedu dodávka). null, keď žiadne detegované vozidlo neobsahuje tabuľku, a vždy null s config.mode=fast.
`error.code`	400: image_required, bad_json, bad_base64, one_image_only, bad_image_url, image_url_not_allowed, image_url_fetch_failed, image_url_timeout, invalid_image, unsupported_image_type, unsupported_content_type, upload_failed, bad_regions, bad_camera_id, bad_timestamp, bad_config, bad_threshold, bad_mode. 404: no_plate_detected (aj keď config.threshold nenechá žiadny výsledok). 413: payload_too_large. 500: engine_error.

curl -X POST "https://nakordoni.eu/api/v4/data/plate-recognition" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://nakordoni.eu/img/developers/plate-recognition-example-bus.jpg",
    "regions": [
        "UA"
    ],
    "camera_id": "depot-gate-1",
    "timestamp": "2026-10-27T14:05:00Z",
    "config": {
        "threshold": 0.8
    }
}'

Rozpoznávanie EČV (ANPR / ALPR) pre európske vozidlá

Plate Image Recognition API je služba na rozpoznávanie EČV (LPR): pošlite fotku a dostanete text evidenčného čísla ako JSON. Je to náš vlastný engine ANPR / ALPR, vyladený na nákladných autách a autobusoch z EÚ na hraničných priechodoch a v autobusových depách, a číta aj tabuľky osobných áut a motocyklov.

Verzia v4 pridáva krajinu EČV a typ vozidla (car, bus, truck alebo motorcycle). Prijíma aj voliteľné možnosti požiadavky: regions, aby sa výsledok priklonil k očakávaným krajinám; camera_id a timestamp, ktoré sa vrátia v odpovedi; prah skóre; a režim fast.

GDPR už v návrhu: API je hostované v EÚ a každý obrázok sa spracúva iba v pamäti a nikdy sa neukladá. Žiadna externá služba videnia nevidí vaše obrázky.

Integrácie: Home Assistant

Naša open-source integrácia Home Assistant (licencia MIT, inštalovateľná cez HACS) číta EČV z vašich kamier Home Assistant. Pre každú EČV vám dá senzor a udalosť s krajinou EČV a typom vozidla. Podporuje Frigate: pri udalosti vozidla prečíta snímku a zapíše EČV späť do Frigate ako podštítok. Prihlásenie používa OAuth, takže každý používateľ dostane vlastný bezplatný kľúč.

Integrácia Home Assistant na GitHube ↗ Integrácie

🔑 Prihláste sa ako vývojár a vyskúšajte tento endpoint naživo v sandboxe — 10 bezplatných testovacích volaní na produkt za deň. Prihlásiť sa

Aktualizované 28.10.2026 04:09