Recunoașterea numerelor de înmatriculare API (ALPR / ANPR) Online
Față de V1: parametri noi regions, camera_id, timestamp, config, threshold, mode
Citește plăcuțele de înmatriculare dintr-o fotografie a unui vehicul. Trimiteți prin POST o imagine (JPEG, PNG, WebP, BMP sau TIFF, max. 8 MB) ca corp JSON cu image_url sau image_base64, ca încărcare multipart/form-data în câmpul "image" sau ca octeți bruți cu un Content-Type image/*. Fiecare plăcuță găsită este returnată cu textul, un scor 0-1, citiri alternative, chenarul plăcuței în pixeli și scorul de detecție. Motorul este propriul nostru detector și cititor de plăcuțe, optimizat pentru camioane și autobuze europene. Imaginile sunt procesate în memorie și nu sunt niciodată stocate. image_url trebuie să fie o adresă http(s) publică; adresele private și interne, precum și redirecționările către acestea, sunt refuzate, iar descărcarea este oprită după 10 secunde.
POST https://nakordoni.eu/api/v4/data/plate-recognition
— clasă de cotă: heavy
| Parametru | Descriere |
|---|---|
image_url | (corp JSON) URL http(s) public al imaginii. Max. 8 MB, max. 3 redirecționări, limită de descărcare 10 s. |
image_base64 | (corp JSON) Imaginea în base64 (un prefix data:image/...;base64, este permis). Trimiteți image_url sau image_base64, nu ambele. |
regions | Opțional. Țările pe care le așteptați, ca coduri ISO 3166-1 alpha-2: o matrice JSON ["PL","DE"] sau un șir separat prin virgule "PL,DE" (câmp multipart sau parametru de interogare). Maximum 10. Estimarea regiunii și ordinea citirilor favorizează aceste țări: când cea mai bună citire nu se potrivește cu formatul niciunei țări din listă, dar un alt candidat cu un scor mai mic cu cel mult 0.15 se potrivește, acel candidat devine plăcuța. O plăcuță care nu se potrivește cu nicio țară din listă își păstrează răspunsul normal. |
camera_id | Opțional. ID-ul camerei sau al porții dvs., maximum 128 de caractere. Returnat neschimbat în data.camera_id. Nu este stocat dincolo de jurnalul normal al cererilor. |
timestamp | Opțional. Ora capturii în formatul dvs. (de exemplu 2026-10-27T14:05:00Z), maximum 64 de caractere. Returnat neschimbat în data.timestamp. Nu este stocat dincolo de jurnalul normal al cererilor. |
config | Opțional. Obiect JSON {"threshold": 0-1, "mode": "fast"|"full"}. Într-un formular multipart sau într-un șir de interogare, trimiteți-l ca șir JSON sau folosiți câmpurile threshold și mode. |
threshold | Opțional, la fel ca config.threshold. Rezultatele cu un scor sub această valoare (0-1) sunt omise. Când nu rămâne niciunul, răspunsul este 404 no_plate_detected. |
mode | Opțional, la fel ca config.mode. full (implicit) rulează recunoașterea plăcuței și detectarea vehiculului. fast omite detectarea vehiculului pentru o viteză apropiată de v2: region este completat în continuare, vehicle este null. |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.success | true când cel puțin o plăcuță a fost citită; data.message indică câte. |
data.processing_time | Timpul petrecut pe cerere, în milisecunde (descărcare, recunoașterea plăcuței și detectarea vehiculului). v4 durează mai mult decât v2 din cauza detectării vehiculului, de obicei 0.5-1.5 s per imagine. Cu config.mode=fast nu există detectarea vehiculului, iar timpul este apropiat de v2. |
data.camera_id | camera_id pe care l-ați trimis, neschimbat. Prezent doar dacă ați trimis unul. |
data.timestamp | timestamp-ul pe care l-ați trimis, neschimbat (un șir rămâne șir, un număr rămâne număr). Prezent doar dacă ați trimis unul. |
data.results[] | O intrare pentru fiecare plăcuță, începând cu cel mai mare scor de detecție. |
data.results[].plate | Textul plăcuței, majuscule, doar litere A-Z și cifre (fără spații sau cratime). |
data.results[].score | Încrederea citirii 0-1 (media încrederilor pe caracter). |
data.results[].candidates[] | Până la 5 citiri {plate, score}, cea mai bună prima; prima este plăcuța. |
data.results[].region | {code, score}: code este țara plăcuței conform ISO 3166-1 alpha-2 (de exemplu UA, PL, RO), determinată din formatul plăcuței. score 0-1 este încrederea citirii înmulțită cu cât de specific este formatul; când același format este folosit în mai multe țări (de exemplu LT, MD și HU au în comun ABC123), scorul este împărțit între ele și este scăzut. null când textul nu corespunde niciunui format cunoscut. Acoperite: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE. |
data.results[].box | Poziția plăcuței în pixeli: xmin, ymin, xmax, ymax. |
data.results[].dscore | Încrederea detecției plăcuței 0-1. |
data.results[].vehicle | {type, score, box}: vehiculul care poartă plăcuța. type este car, bus, truck sau motorcycle; score este încrederea detecției 0-1; box este poziția vehiculului în pixeli (xmin, ymin, xmax, ymax). Autocarele văzute din față și microbuzele sau furgonetele pot fi tipizate ca truck (detectorul nu are clasa furgonetă). null când niciun vehicul detectat nu conține plăcuța și mereu null cu 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 (și când config.threshold nu lasă niciun rezultat). 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
}
}'
Recunoașterea numerelor de înmatriculare (ANPR / ALPR) pentru vehicule europene
Plate Image Recognition API este un serviciu de recunoaștere a numerelor de înmatriculare (LPR): trimiteți o fotografie și primiți textul plăcuței ca JSON. Este propriul nostru motor ANPR / ALPR, optimizat pe camioane și autobuze din UE la punctele de frontieră și în depourile de autobuze, și citește și plăcuțele de autoturisme și motociclete.
Versiunea v4 adaugă țara plăcuței și tipul vehiculului (car, bus, truck sau motorcycle). Acceptă și opțiuni de cerere facultative: regions, pentru a favoriza rezultatul către țările pe care le așteptați; camera_id și timestamp, care revin în răspuns; un prag de scor; și un mod fast.
RGPD prin design: API-ul este găzduit în UE, iar fiecare imagine este procesată doar în memorie și nu este stocată niciodată. Niciun serviciu de viziune terț nu vă vede imaginile.
Integrări: Home Assistant
Integrarea noastră open source pentru Home Assistant (licență MIT, instalabilă cu HACS) citește numerele de înmatriculare de la camerele dvs. Home Assistant. Vă oferă un senzor și un eveniment pentru fiecare plăcuță, cu țara plăcuței și tipul vehiculului. Suportă Frigate: la un eveniment de vehicul citește instantaneul și scrie plăcuța înapoi în Frigate ca sub-etichetă. Autentificarea folosește OAuth, deci fiecare utilizator primește propria cheie gratuită.
Actualizat