Nömrə nişanının tanınması API (ALPR / ANPR) Online
V1 ilə müqayisədə: yeni parametrlər regions, camera_id, timestamp, config, threshold, mode
Nəqliyyat vasitəsinin fotosundakı dövlət nömrə nişanlarını oxuyur. Bir təsviri (JPEG, PNG, WebP, BMP və ya TIFF, maks. 8 MB) image_url və ya image_base64 ilə JSON gövdəsi kimi, "image" sahəsində multipart/form-data yükləməsi kimi və ya image/* Content-Type ilə xam baytlar kimi POST edin. Tapılan hər nömrə nişanı mətn, 0-1 bal, alternativ oxunuşlar, piksellərlə nişan çərçivəsi və aşkarlama balı ilə qaytarılır. Mühərrik Avropa yük maşınları və avtobusları üçün tənzimlənmiş öz nömrə nişanı detektorumuz və oxuyucumuzdur. Təsvirlər yaddaşda emal olunur və heç vaxt saxlanmır. image_url ictimai http(s) ünvanı olmalıdır; şəxsi və daxili ünvanlar, eləcə də onlara yönləndirmələr rədd edilir və yükləmə 10 saniyədən sonra dayandırılır.
POST https://nakordoni.eu/api/v4/data/plate-recognition
— kvota sinfi: heavy
| Parametr | Təsvir |
|---|---|
image_url | (JSON gövdəsi) Təsvirin ictimai http(s) URL-i. Maks. 8 MB, maks. 3 yönləndirmə, yükləmə limiti 10 s. |
image_base64 | (JSON gövdəsi) base64 formatında təsvir (data:image/...;base64, prefiksinə icazə verilir). image_url və ya image_base64 göndərin, hər ikisini yox. |
regions | İstəyə bağlı. Gözlədiyiniz ölkələr, ISO 3166-1 alpha-2 kodları ilə: JSON massivi ["PL","DE"] və ya vergüllə ayrılmış sətir "PL,DE" (multipart sahəsi və ya query parametri). 10-a qədər. Ölkə təxmini və oxunuş sırası bu ölkələrə doğru meyl edir: ən yaxşı oxunuş sadalanan heç bir ölkənin formatına uyğun gəlmirsə, lakin score-u ən çox 0.15 aşağı olan başqa namizəd uyğun gəlirsə, həmin namizəd nömrə nişanı olur. Sadalanan heç bir ölkəyə uyğun gəlməyən nişan öz adi cavabını saxlayır. |
camera_id | İstəyə bağlı. Kameranızın və ya keçid məntəqənizin ID-si, 128 simvola qədər. data.camera_id-də dəyişmədən qaytarılır. Adi sorğu jurnalından başqa yerdə saxlanmır. |
timestamp | İstəyə bağlı. Çəkiliş vaxtı öz formatınızda (məsələn, 2026-10-27T14:05:00Z), 64 simvola qədər. data.timestamp-də dəyişmədən qaytarılır. Adi sorğu jurnalından başqa yerdə saxlanmır. |
config | İstəyə bağlı. JSON obyekti {"threshold": 0-1, "mode": "fast"|"full"}. Multipart formada və ya query sətrində onu JSON sətri kimi göndərin və ya threshold və mode sahələrindən istifadə edin. |
threshold | İstəyə bağlı, config.threshold ilə eynidir. Score-u bu dəyərdən (0-1) aşağı olan nəticələr çıxarılır. Heç nə qalmadıqda cavab 404 no_plate_detected olur. |
mode | İstəyə bağlı, config.mode ilə eynidir. full (defolt) nömrə nişanı tanıma və nəqliyyat vasitəsi aşkarlamasını işlədir. fast v2-yə yaxın sürət üçün nəqliyyat aşkarlamasını atlayır: region yenə doldurulur, vehicle isə null olur. |
Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.
| Sahə | Təsvir |
|---|---|
data.success | ən azı bir nömrə nişanı oxunduqda true; data.message neçə olduğunu bildirir. |
data.processing_time | Sorğuya sərf olunan vaxt millisaniyə ilə (yükləmə, nömrə nişanı tanıma və nəqliyyat aşkarlaması). v4 nəqliyyat aşkarlamasına görə v2-dən uzun çəkir, adətən bir şəkil üçün 0.5-1.5 s. config.mode=fast olduqda nəqliyyat aşkarlaması yoxdur və vaxt v2-yə yaxındır. |
data.camera_id | Göndərdiyiniz camera_id, dəyişmədən. Yalnız göndərdikdə mövcuddur. |
data.timestamp | Göndərdiyiniz timestamp, dəyişmədən (sətir sətir qalır, rəqəm rəqəm qalır). Yalnız göndərdikdə mövcuddur. |
data.results[] | Hər nömrə nişanı üçün bir qeyd, ən yüksək aşkarlama balı birinci. |
data.results[].plate | Nömrə nişanının mətni, böyük hərflərlə, yalnız A-Z hərfləri və rəqəmlər (boşluq və ya defis olmadan). |
data.results[].score | Oxunuşun etibarlılığı 0-1 (hər simvol etibarlılığının orta qiyməti). |
data.results[].candidates[] | 5-ə qədər oxunuş {plate, score}, ən yaxşısı birinci; birincisi nömrə nişanıdır. |
data.results[].region | {code, score}: code nömrə nişanının ISO 3166-1 alpha-2 ölkəsidir (məsələn, UA, PL, RO), nişanın formatından oxunur. score 0-1 oxunuş etibarlılığının formatın nə qədər spesifik olması ilə hasilidir; eyni format bir neçə ölkədə istifadə olunduqda (məsələn, LT, MD və HU ABC123-ü paylaşır) bal onlar arasında bölünür və aşağı olur. Mətn heç bir məlum formata uyğun gəlmədikdə null. Əhatə olunanlar: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE. |
data.results[].box | Nömrə nişanının piksellərlə mövqeyi: xmin, ymin, xmax, ymax. |
data.results[].dscore | Nömrə nişanının aşkarlanma etibarlılığı 0-1. |
data.results[].vehicle | {type, score, box}: nişanı daşıyan nəqliyyat vasitəsi. type car, bus, truck və ya motorcycle olur; score aşkarlama əminliyidir, 0-1; box nəqliyyat vasitəsinin piksellərlə mövqeyidir (xmin, ymin, xmax, ymax). Önдən görünən avtobuslar, eləcə də mikroavtobuslar və ya furqonlar truck kimi müəyyən edilə bilər (detektorda furqon sinfi yoxdur). Aşkarlanan heç bir nəqliyyat vasitəsi nişanı əhatə etmirsə null olur, config.mode=fast olduqda isə həmişə null olur. |
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 (config.threshold heç bir nəticə qoymadıqda da). 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
}
}'
Avropa nəqliyyat vasitələri üçün nömrə nişanının tanınması (ANPR / ALPR)
Plate Image Recognition API nömrə nişanı tanıma (LPR) xidmətidir: foto göndərin və nömrə nişanının mətnini JSON kimi alın. Bu, sərhəd keçid məntəqələrində və avtobus depolarında Aİ yük maşınları və avtobusları üzrə tənzimlənmiş öz ANPR / ALPR mühərrikimizdir, həmçinin minik avtomobillərinin və motosikletlərin nişanlarını da oxuyur.
v4 versiyası nişanın ölkəsini və nəqliyyat vasitəsinin növünü (car, bus, truck və ya motorcycle) əlavə edir. O, həmçinin istəyə bağlı sorğu seçimlərini qəbul edir: nəticəni gözlədiyiniz ölkələrə doğru meyl etdirmək üçün regions; cavabda qayıdan camera_id və timestamp; score həddi; və fast rejimi.
Dizaynla GDPR: API Aİ-də yerləşir, hər şəkil yalnız yaddaşda emal olunur və heç vaxt saxlanmır. Heç bir üçüncü tərəf görmə xidməti şəkillərinizi görmür.
İnteqrasiyalar: Home Assistant
Açıq mənbəli Home Assistant inteqrasiyamız (MIT lisenziyası, HACS ilə quraşdırılır) Home Assistant kameralarınızdan nömrə nişanlarını oxuyur. Hər nişan üçün sensor və hadisə verir, nişanın ölkəsi və nəqliyyat növü ilə birlikdə. Frigate dəstəklənir: nəqliyyat hadisəsində snapshot-u oxuyur və nişanı Frigate-ə sub-label kimi yazır. Giriş OAuth ilə edilir, buna görə hər istifadəçi öz pulsuz açarını alır.
Yeniləndi