API për njohjen e targave (ALPR / ANPR) Online
Krahasuar me V1: parametra të rinj regions, camera_id, timestamp, config, threshold, mode
Lexon targat e automjeteve nga një fotografi e një automjeti. Dërgoni me POST një imazh (JPEG, PNG, WebP, BMP ose TIFF, maks. 8 MB) si trup JSON me image_url ose image_base64, si ngarkim multipart/form-data në fushën "image", ose si bajte të papërpunuara me Content-Type image/*. Çdo targë e gjetur kthehet me tekstin, një vlerësim 0-1, leximet alternative, kutinë e targës në piksel dhe vlerësimin e zbulimit. Motori është detektori dhe lexuesi ynë i targave, i përshtatur për kamionë dhe autobusë evropianë. Imazhet përpunohen në memorie dhe nuk ruhen kurrë. image_url duhet të jetë një adresë publike http(s); adresat private dhe të brendshme, si dhe ridrejtimet drejt tyre, refuzohen, dhe shkarkimi ndalet pas 10 sekondash.
POST https://nakordoni.eu/api/v4/data/plate-recognition
— klasa e kuotës: heavy
| Parametri | Përshkrimi |
|---|---|
image_url | (Trup JSON) URL publike http(s) e imazhit. Maks. 8 MB, maks. 3 ridrejtime, kufi shkarkimi 10 s. |
image_base64 | (Trup JSON) Imazhi në base64 (lejohet parashtesa data:image/...;base64,). Dërgoni image_url ose image_base64, jo të dyja. |
regions | Opsionale. Shtetet që prisni, si kode ISO 3166-1 alpha-2: një varg JSON ["PL","DE"] ose një string i ndarë me presje "PL,DE" (fushë multipart ose parametër query). Deri në 10. Hamendja e rajonit dhe renditja e leximit anojnë drejt këtyre shteteve: kur leximi më i mirë nuk përputhet me formatin e asnjë shteti të listuar, por një kandidat tjetër me rezultat jo më shumë se 0,15 më të ulët përputhet, ai kandidat bëhet targa. Një targë që nuk përputhet me asnjë shtet të listuar mban përgjigjen e saj normale. |
camera_id | Opsionale. ID e kamerës ose e portës suaj, deri në 128 karaktere. Kthehet pa ndryshim te data.camera_id. Nuk ruhet përtej regjistrit normal të kërkesave. |
timestamp | Opsionale. Koha e kapjes në formatin tuaj (për shembull 2026-10-27T14:05:00Z), deri në 64 karaktere. Kthehet pa ndryshim te data.timestamp. Nuk ruhet përtej regjistrit normal të kërkesave. |
config | Opsionale. Objekt JSON {"threshold": 0-1, "mode": "fast"|"full"}. Në një formular multipart ose në një query string, dërgojeni si string JSON ose përdorni fushat threshold dhe mode. |
threshold | Opsionale, njësoj si config.threshold. Rezultatet me score nën këtë vlerë (0-1) lihen jashtë. Kur nuk mbetet asnjë, përgjigjja është 404 no_plate_detected. |
mode | Opsionale, njësoj si config.mode. full (e parazgjedhur) ekzekuton njohjen e targës dhe zbulimin e mjetit. fast e anashkalon zbulimin e mjetit për shpejtësi si v2: region plotësohet prapë, vehicle është null. |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.success | true kur është lexuar të paktën një targë; data.message tregon sa. |
data.processing_time | Koha e shpenzuar për kërkesën në milisekonda (shkarkim, njohje e targës dhe zbulim i mjetit). v4 zgjat më shumë se v2 për shkak të zbulimit të mjetit, zakonisht 0,5-1,5 s për imazh. Me config.mode=fast nuk ka zbulim mjeti dhe koha është afër v2. |
data.camera_id | camera_id që dërguat, pa ndryshim. Ekziston vetëm kur e dërguat. |
data.timestamp | timestamp që dërguat, pa ndryshim (një string mbetet string, një numër mbetet numër). Ekziston vetëm kur e dërguat. |
data.results[] | Një hyrje për çdo targë, me vlerësimin më të lartë të zbulimit së pari. |
data.results[].plate | Teksti i targës, me shkronja të mëdha, vetëm shkronja A-Z dhe shifra (pa hapësira ose viza). |
data.results[].score | Besueshmëria e leximit 0-1 (mesatarja e besueshmërive të secilit karakter). |
data.results[].candidates[] | Deri në 5 lexime {plate, score}, më i miri së pari; i pari është targa. |
data.results[].region | {code, score}: code është shteti ISO 3166-1 alpha-2 i targës (për shembull UA, PL, RO), i lexuar nga formati i targës. score 0-1 është besueshmëria e leximit e shumëzuar me specifikën e formatit; kur i njëjti format përdoret në disa shtete (për shembull LT, MD dhe HU ndajnë ABC123) vlerësimi ndahet mes tyre dhe është i ulët. null kur teksti nuk përputhet me asnjë format të njohur. Të mbuluara: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE. |
data.results[].box | Pozicioni i targës në piksel: xmin, ymin, xmax, ymax. |
data.results[].dscore | Besueshmëria e zbulimit të targës 0-1. |
data.results[].vehicle | {type, score, box}: mjeti që mban targën. type është car, bus, truck ose motorcycle; score është besueshmëria e zbulimit 0-1; box është pozicioni i mjetit në piksele (xmin, ymin, xmax, ymax). Autobusët turistikë të parë nga përpara dhe minibusët ose furgonët mund të klasifikohen si truck (detektori nuk ka klasë van). null kur asnjë mjet i zbuluar nuk e përmban targën, dhe gjithmonë null me 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 (edhe kur config.threshold nuk lë asnjë 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
}
}'
Njohja e targave (ANPR / ALPR) për mjetet evropiane
Plate Image Recognition API është një shërbim për njohjen e targave (LPR): dërgoni një foto dhe merrni tekstin e targës si JSON. Është motori ynë ANPR / ALPR, i përshtatur në kamionë dhe autobusë të BE-së në pika kufitare dhe depo autobusësh, dhe lexon edhe targa makinash e motoçikletash.
Versioni v4 shton shtetin e targës dhe llojin e mjetit (car, bus, truck ose motorcycle). Pranon edhe opsione opsionale të kërkesës: regions, për ta anuar rezultatin drejt shteteve që prisni; camera_id dhe timestamp, që kthehen në përgjigje; një prag rezultati; dhe një mënyrë fast.
GDPR që nga dizajni: API-ja hostohet në BE dhe çdo imazh përpunohet vetëm në memorie dhe nuk ruhet kurrë. Asnjë shërbim i jashtëm vizioni nuk i sheh imazhet tuaja.
Integrime: Home Assistant
Integrimi ynë open-source për Home Assistant (licencë MIT, instalohet me HACS) lexon targat nga kamerat tuaja të Home Assistant. Ju jep një sensor dhe një ngjarje për çdo targë, me shtetin e targës dhe llojin e mjetit. Mbështet Frigate: në një ngjarje mjeti lexon pamjen dhe e shkruan targën prapa në Frigate si nën-etiketë. Hyrja përdor OAuth, kështu që çdo përdorues merr çelësin e vet falas.
Përditësuar