Rendszámfelismerés API (ALPR / ANPR) Online
A(z) V1 verzióhoz képest: új paraméterek regions, camera_id, timestamp, config, threshold, mode
Kiolvassa a rendszámtáblákat egy jármű fényképéről. Küldjön POST-tal egy képet (JPEG, PNG, WebP, BMP vagy TIFF, legfeljebb 8 MB) JSON-törzsként image_url vagy image_base64 mezővel, multipart/form-data feltöltésként az "image" mezőben, vagy nyers bájtokként image/* Content-Type fejléccel. Minden megtalált rendszámtábla visszatér a szöveggel, egy 0-1 pontszámmal, alternatív olvasatokkal, a tábla pixelben megadott keretével és az észlelési pontszámmal. A motor saját rendszámtábla-detektorunk és -olvasónk, európai teherautókra és buszokra hangolva. A képeket a memóriában dolgozzuk fel, és soha nem tároljuk. Az image_url-nek nyilvános http(s) címnek kell lennie; a privát és belső címeket, valamint az azokra mutató átirányításokat elutasítjuk, a letöltést pedig 10 másodperc után leállítjuk.
POST https://nakordoni.eu/api/v4/data/plate-recognition
— kvótaosztály: heavy
| Paraméter | Leírás |
|---|---|
image_url | (JSON-törzs) A kép nyilvános http(s) URL-je. Legfeljebb 8 MB, legfeljebb 3 átirányítás, 10 s letöltési korlát. |
image_base64 | (JSON-törzs) A kép base64 formátumban (a data:image/...;base64, előtag megengedett). Az image_url és az image_base64 közül csak az egyiket küldje, ne mindkettőt. |
regions | Opcionális. A várt országok ISO 3166-1 alpha-2 kódként: JSON tömb ["PL","DE"] vagy vesszővel elválasztott karakterlánc "PL,DE" (multipart mező vagy lekérdezési paraméter). Legfeljebb 10. A régiótipp és az olvasatok sorrendje ezeket az országokat részesíti előnyben: ha a legjobb olvasat nem felel meg egyetlen felsorolt ország formátumának sem, de egy másik jelölt, amelynek pontszáma legfeljebb 0.15-tel alacsonyabb, megfelel, akkor az a jelölt lesz a rendszám. Az a rendszám, amely egyetlen felsorolt országnak sem felel meg, megtartja a szokásos eredményét. |
camera_id | Opcionális. A kamera vagy a kapu azonosítója, legfeljebb 128 karakter. Változatlanul visszakapja a data.camera_id mezőben. A szokásos kérésnaplón túl nem tároljuk. |
timestamp | Opcionális. A rögzítés ideje saját formátumban (például 2026-10-27T14:05:00Z), legfeljebb 64 karakter. Változatlanul visszakapja a data.timestamp mezőben. A szokásos kérésnaplón túl nem tároljuk. |
config | Opcionális. JSON objektum {"threshold": 0-1, "mode": "fast"|"full"}. Multipart űrlapon vagy lekérdezési karakterláncban JSON karakterláncként küldje el, vagy használja a threshold és mode mezőket. |
threshold | Opcionális, megegyezik a config.threshold értékkel. Az ennél (0-1) alacsonyabb pontszámú eredmények kimaradnak. Ha egy sem marad, a válasz 404 no_plate_detected. |
mode | Opcionális, megegyezik a config.mode értékkel. A full (alapértelmezett) rendszámfelismerést és járműdetektálást végez. A fast kihagyja a járműdetektálást a v2-höz hasonló sebességért: a region továbbra is ki van töltve, a vehicle null. |
Válaszmezők — a válaszboríték data objektumán belül. A [] listát jelöl, tehát a data.items[].name az egyes elemek name mezője. Egy mező null, hiányzik vagy üres lista, ha nincs rá értékünk — helykitöltőt soha nem teszünk oda.
| Mező | Leírás |
|---|---|
data.success | true, ha legalább egy rendszámtáblát sikerült kiolvasni; a data.message megadja, hányat. |
data.processing_time | A kérésre fordított idő ezredmásodpercben (letöltés, rendszámfelismerés és járműdetektálás). A v4 a járműdetektálás miatt tovább tart, mint a v2, jellemzően 0.5-1.5 s képenként. A config.mode=fast esetén nincs járműdetektálás, és az idő közel van a v2-éhez. |
data.camera_id | Az Ön által küldött camera_id, változatlanul. Csak akkor szerepel, ha küldött ilyet. |
data.timestamp | Az Ön által küldött timestamp, változatlanul (a karakterlánc karakterlánc marad, a szám szám). Csak akkor szerepel, ha küldött ilyet. |
data.results[] | Rendszámtáblánként egy elem, a legmagasabb észlelési pontszámmal rendelkező elöl. |
data.results[].plate | A rendszám szövege nagybetűkkel, kizárólag A-Z betűkkel és számjegyekkel (szóközök és kötőjelek nélkül). |
data.results[].score | Az olvasat megbízhatósága 0-1 (a karakterenkénti megbízhatóságok átlaga). |
data.results[].candidates[] | Legfeljebb 5 olvasat {plate, score}, a legjobb elöl; az első a rendszám. |
data.results[].region | {code, score}: a code a rendszámtábla országa ISO 3166-1 alpha-2 szerint (például UA, PL, RO), a tábla formátumából kiolvasva. A 0-1 közötti score az olvasat megbízhatósága szorozva a formátum egyediségével; ha ugyanazt a formátumot több országban használják (például az LT, MD és HU osztozik az ABC123 formátumon), a pontszám megoszlik közöttük, és alacsony. null, ha a szöveg egyetlen ismert formátumnak sem felel meg. Támogatott országok: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE. |
data.results[].box | A rendszámtábla pozíciója pixelben: xmin, ymin, xmax, ymax. |
data.results[].dscore | A rendszámtábla észlelésének megbízhatósága 0-1. |
data.results[].vehicle | {type, score, box}: a rendszámot viselő jármű. A type értéke car, bus, truck vagy motorcycle; a score a detektálás megbízhatósága 0-1; a box a jármű helye pixelben (xmin, ymin, xmax, ymax). Elölről látott autóbuszok, valamint kisbuszok és furgonok truck típusúak lehetnek (a detektor nem ismer furgon osztályt). null, ha egyetlen detektált jármű sem tartalmazza a rendszámot, és config.mode=fast esetén mindig 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, bad_regions, bad_camera_id, bad_timestamp, bad_config, bad_threshold, bad_mode. 404: no_plate_detected (akkor is, ha a config.threshold miatt nem marad eredmény). 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
}
}'
Rendszámfelismerés (ANPR / ALPR) európai járművekhez
A Plate Image Recognition API rendszámfelismerő (LPR) szolgáltatás: küldjön egy fényképet, és JSON-ban megkapja a rendszám szövegét. Ez a saját ANPR / ALPR motorunk, amelyet határátkelőhelyeken és buszdepókban uniós teherautókon és buszokon hangoltunk, és személyautók és motorkerékpárok rendszámát is olvassa.
A v4 verzió hozzáadja a rendszám országát és a jármű típusát (car, bus, truck vagy motorcycle). Opcionális kérésbeállításokat is elfogad: regions, hogy az eredményt a várt országok felé terelje; camera_id és timestamp, amelyek visszakerülnek a válaszba; pontszámküszöb; valamint fast mód.
GDPR a tervezésben: az API az EU-ban üzemel, és minden képet csak memóriában dolgoz fel, soha nem tárol. Harmadik fél látásszolgáltatása nem látja a képeit.
Integrációk: Home Assistant
Nyílt forráskódú Home Assistant integrációnk (MIT licenc, HACS-szel telepíthető) rendszámokat olvas a Home Assistant kameráiról. Minden rendszámhoz ad egy szenzort és egy eseményt, a rendszám országával és a jármű típusával. Támogatja a Frigate-et: járműesemény esetén beolvassa a pillanatképet, és a rendszámot alcímkeként visszaírja a Frigate-be. A bejelentkezés OAuth-tal történik, így minden felhasználó saját ingyenes kulcsot kap.
Frissítve