Rozpoznávanie EČV API (ALPR / ANPR) Online
V porovnaní s V1: nové parametre regions, camera_id, timestamp, config, threshold, mode
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/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. |
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ý 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ľúč.
Aktualizované