Xəbər göndərmə və NakBus donanması artıq tərəfdaş panelindədir

Nakordoni Partners panelinə daxil olmaq üçün developer hesabınızla eyni giriş məlumatlarından (e-poçt və parol) istifadə edin və orada xəbərləri və avtobus parkınızı (NakDriver / NakManager) komanda rolları ilə idarə edin. API açarlarınız, endpoint-lər və tətbiqləriniz dəyişməyib, buradakı səhifələr isə işləməyə davam edir. Nakordoni Partners-i aç

Nömrə nişanının tanınması API (ALPR / ANPR) Online

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/v2/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.

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ə və tanıma).
`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`	Mühərrik müəyyən edə bildikdə nömrə nişanının ölkəsi ilə {code, score}; əks halda null (cari mühərrik ölkəni müəyyən etmir).
`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`	Mövcud olduqda nəqliyyat vasitəsi haqqında məlumat; cari mühərrikdə 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"
}'

V1 ilə müqayisədə: yeni parametrlər regions, camera_id, timestamp, config, threshold, mode

Bu versiyada nə fərqlidir: v4 v2-nin həmişə null qaytardığı iki sahəni doldurur. results[].region nömrə nişanının ölkəsini {code, score} kimi verir və onu nişanın formatından oxuyur: hər ölkənin hərf və rəqəm şablonundan və format varsa, region və ya mahal prefiksindən (məsələn, Ukrayna nişanındakı CE). results[].vehicle nişanı daşıyan nəqliyyat vasitəsini {type, score, box} kimi verir, bunu bizim nəqliyyat detektorumuz müəyyən edir: type car, bus, truck və ya motorcycle olur. v4 həmçinin istəyə əlavə seçimləri qəbul edir: regions, camera_id, timestamp, config.threshold və config.mode. Bunlar olmadan v4 çıxışı dəyişmir. Cavabın digər sahələri və v2-nin xəta kodları eynidir. v2 hər iki sahə üçün null qaytarmağa davam edir və seçimləri nəzərə almı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.

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.

GitHub-da Home Assistant inteqrasiyası ↗ İnteqrasiyalar

🔑 Bu endpoint-i sandbox-da canlı sınamaq üçün tərtibatçı kimi daxil olun — hər məhsul üçün gündə 10 pulsuz sınaq çağırışı. Giriş

Yeniləndi 28.10.2026 04:09