Պետհամարանիշի ճանաչման API (ALPR / ANPR) Online
V1-ի համեմատ՝ նոր պարամետրեր regions, camera_id, timestamp, config, threshold, mode
Կարդում է համարանիշերը տրանսպորտային միջոցի լուսանկարից: POST արեք մեկ պատկեր (JPEG, PNG, WebP, BMP կամ TIFF, առավելագույնը 8 MB)՝ որպես JSON մարմին image_url կամ image_base64 դաշտով, որպես multipart/form-data վերբեռնում "image" դաշտում, կամ որպես հում բայթեր image/* Content-Type-ով: Յուրաքանչյուր գտնված համարանիշ վերադարձվում է տեքստով, 0-1 գնահատականով, այլընտրանքային ընթերցումներով, պիքսելներով համարանիշի շրջանակով և հայտնաբերման գնահատականով: Շարժիչը մեր սեփական համարանիշերի դետեկտորն ու ընթերցիչն է՝ հարմարեցված եվրոպական բեռնատարների և ավտոբուսների համար: Պատկերները մշակվում են հիշողության մեջ և երբեք չեն պահվում: image_url-ը պետք է լինի հանրային http(s) հասցե. մասնավոր և ներքին հասցեները, ինչպես նաև դեպի դրանք վերահասցեավորումները մերժվում են, իսկ ներբեռնումը կանգնեցվում է 10 վայրկյանից հետո:
POST https://nakordoni.eu/api/v4/data/plate-recognition
— քվոտայի դաս: heavy
| Պարամետր | Նկարագրություն |
|---|---|
image_url | (JSON մարմին) Պատկերի հանրային http(s) URL: Առավելագույնը 8 MB, առավելագույնը 3 վերահասցեավորում, ներբեռնման սահմանաչափը՝ 10 s: |
image_base64 | (JSON մարմին) Պատկերը base64 ձևաչափով (թույլատրվում է data:image/...;base64, նախածանցը): Ուղարկեք image_url կամ image_base64, ոչ երկուսը միասին: |
regions | Ընտրովի: Ձեր սպասած երկրները՝ որպես ISO 3166-1 alpha-2 կոդեր. JSON զանգված ["PL","DE"] կամ ստորակետով բաժանված տող "PL,DE" (multipart դաշտ կամ query պարամետր): Մինչև 10: Երկրի գուշակումը և ընթերցումների կարգը թեքվում են այս երկրների կողմը. եթե լավագույն ընթերցումը չի համապատասխանում նշված որևէ երկրի ձևաչափին, բայց մեկ այլ թեկնածու, որի score-ը առավելագույնը 0.15-ով ցածր է, համապատասխանում է, ապա այդ թեկնածուն դառնում է համարանիշը: Համարանիշը, որը չի համապատասխանում նշված որևէ երկրի, պահպանում է իր սովորական պատասխանը: |
camera_id | Ընտրովի: Ձեր տեսախցիկի կամ դարպասի ID-ն, մինչև 128 նիշ: Վերադարձվում է անփոփոխ data.camera_id-ում: Սովորական հարցումների մատյանից դուրս չի պահվում: |
timestamp | Ընտրովի: Նկարահանման ժամանակը ձեր սեփական ձևաչափով (օրինակ՝ 2026-10-27T14:05:00Z), մինչև 64 նիշ: Վերադարձվում է անփոփոխ data.timestamp-ում: Սովորական հարցումների մատյանից դուրս չի պահվում: |
config | Ընտրովի: JSON օբյեկտ {"threshold": 0-1, "mode": "fast"|"full"}: Multipart ձևում կամ query տողում ուղարկեք այն որպես JSON տող կամ օգտագործեք threshold և mode դաշտերը: |
threshold | Ընտրովի, նույնն է, ինչ config.threshold-ը: Այս արժեքից (0-1) ցածր score ունեցող արդյունքները բաց են թողնվում: Եթե ոչինչ չի մնում, պատասխանը 404 no_plate_detected է: |
mode | Ընտրովի, նույնն է, ինչ config.mode-ը: full (լռելյայն) կատարում է համարանիշի ճանաչում և տրանսպորտի դետեկտում: fast-ը բաց է թողնում տրանսպորտի դետեկտումը՝ v2-ին մոտ արագության համար. region-ը դեռ լրացվում է, vehicle-ը null է: |
Պատասխանի դաշտերը — պատասխանի ծրարի data օբյեկտի ներսում։ []-ը ցույց է տալիս ցուցակ, ուստի data.items[].name-ը յուրաքանչյուր տարրի name դաշտն է։ Դաշտը լինում է null, բացակայում է կամ դատարկ ցուցակ է, երբ արժեք չունենք․ լցոնող արժեք երբեք չենք դնում։
| Դաշտ | Նկարագրություն |
|---|---|
data.success | true, երբ առնվազն մեկ համարանիշ է կարդացվել. data.message-ը ցույց է տալիս քանակը: |
data.processing_time | Հարցման վրա ծախսված ժամանակը միլիվայրկյաններով (ներբեռնում, համարանիշի ճանաչում և տրանսպորտի դետեկտում): v4-ը v2-ից ավելի երկար է տևում տրանսպորտի դետեկտման պատճառով, սովորաբար 0.5-1.5 s մեկ պատկերի համար: config.mode=fast-ի դեպքում տրանսպորտի դետեկտում չկա, և ժամանակը մոտ է v2-ին: |
data.camera_id | Ձեր ուղարկած camera_id-ն, անփոփոխ: Առկա է միայն եթե ուղարկել եք: |
data.timestamp | Ձեր ուղարկած timestamp-ը, անփոփոխ (տողը մնում է տող, թիվը՝ թիվ): Առկա է միայն եթե ուղարկել եք: |
data.results[] | Մեկ գրառում յուրաքանչյուր համարանիշի համար, ամենաբարձր հայտնաբերման գնահատականը՝ առաջինը: |
data.results[].plate | Համարանիշի տեքստը՝ մեծատառ, միայն A-Z տառեր և թվանշաններ (առանց բացատների կամ գծիկների): |
data.results[].score | Ընթերցման վստահությունը 0-1 (յուրաքանչյուր նիշի վստահությունների միջինը): |
data.results[].candidates[] | Մինչև 5 ընթերցում {plate, score}, լավագույնը՝ առաջինը. առաջինը համարանիշն է: |
data.results[].region | {code, score}՝ code-ը համարանիշի ISO 3166-1 alpha-2 երկիրն է (օրինակ՝ UA, PL, RO), կարդացված համարանիշի ձևաչափից: score 0-1-ը ընթերցման վստահության և ձևաչափի յուրահատկության արտադրյալն է. երբ նույն ձևաչափը օգտագործվում է մի քանի երկրներում (օրինակ՝ LT, MD և HU կիսում են ABC123-ը), գնահատականը բաժանվում է դրանց միջև և ցածր է: null, երբ տեքստը չի համապատասխանում որևէ հայտնի ձևաչափի: Ընդգրկված են՝ UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE: |
data.results[].box | Համարանիշի դիրքը պիքսելներով՝ xmin, ymin, xmax, ymax: |
data.results[].dscore | Համարանիշի հայտնաբերման վստահությունը 0-1: |
data.results[].vehicle | {type, score, box}՝ համարանիշը կրող տրանսպորտային միջոցը: type-ը car, bus, truck կամ motorcycle է. score-ը դետեկտման վստահությունն է 0-1. box-ը տրանսպորտի դիրքն է պիքսելներով (xmin, ymin, xmax, ymax): Առջևից երևացող ավտոբուսները, ինչպես նաև միկրոավտոբուսները կամ ֆուրգոնները կարող են որոշվել որպես truck (դետեկտորը չունի ֆուրգոնի դաս): null, երբ հայտնաբերված ոչ մի տրանսպորտ չի պարունակում համարանիշը, և միշտ null է 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 (նաև երբ config.threshold-ը արդյունք չի թողնում): 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
}
}'
Պետհամարանիշի ճանաչում (ANPR / ALPR) եվրոպական տրանսպորտային միջոցների համար
Plate Image Recognition API-ը պետհամարանիշի ճանաչման (LPR) ծառայություն է. ուղարկեք լուսանկար և ստացեք համարանիշի տեքստը որպես JSON: Սա մեր սեփական ANPR / ALPR շարժիչն է, կարգավորված սահմանային անցակետերի և ավտոբուսային պարկերի ԵՄ բեռնատարների ու ավտոբուսների վրա, և այն նաև կարդում է մարդատար ավտոմեքենաների և մոտոցիկլետների համարանիշները:
v4 տարբերակը ավելացնում է համարանիշի երկիրը և տրանսպորտի տեսակը (car, bus, truck կամ motorcycle): Այն նաև ընդունում է հարցման ընտրովի պարամետրեր՝ regions՝ արդյունքը ձեր սպասած երկրների կողմը թեքելու համար; camera_id և timestamp, որոնք վերադառնում են պատասխանում; score-ի շեմ; և fast ռեժիմ:
GDPR՝ նախագծի մակարդակում. API-ը տեղակայված է ԵՄ-ում, և յուրաքանչյուր պատկեր մշակվում է միայն հիշողության մեջ և երբեք չի պահվում: Երրորդ կողմի տեսողական ծառայություն ձեր պատկերները չի տեսնում:
Ինտեգրացիաներ՝ Home Assistant
Մեր բաց կոդով Home Assistant ինտեգրացիան (MIT լիցենզիա, տեղադրվում է HACS-ով) կարդում է համարանիշները ձեր Home Assistant տեսախցիկներից: Այն յուրաքանչյուր համարանիշի համար տալիս է սենսոր և իրադարձություն՝ համարանիշի երկրով և տրանսպորտի տեսակով: Այն աջակցում է Frigate-ին. տրանսպորտի իրադարձության դեպքում կարդում է snapshot-ը և համարանիշը գրում է Frigate-ում որպես sub-label: Մուտքն օգտագործում է OAuth, ուստի յուրաքանչյուր օգտատեր ստանում է իր անվճար բանալին:
Թարմացվել է