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. Процена региона и редослед читања naginju ка овим државама: када најбоље читање не одговара формату ниједне наведене државе, а други кандидат са оценом највише 0,15 нижом одговара, тај кандидат постаје таблица. Таблица која не одговара ниједној наведеној држави задржава уобичајени одговор. |
camera_id | Опционо. ID ваше камере или капије, до 128 знакова. Враћа се непромењен у data.camera_id. Не чува се изван уобичајеног логa захтева. |
timestamp | Опционо. Време снимања у вашем формату (на пример 2026-10-27T14:05:00Z), до 64 знака. Враћа се непромењено у data.timestamp. Не чува се изван уобичајеног логa захтева. |
config | Опционо. JSON објекат {"threshold": 0-1, "mode": "fast"|"full"}. У multipart форми или query стрингу пошаљите га као JSON стринг или користите поља threshold и mode. |
threshold | Опционо, исто као config.threshold. Резултати са score испод ове вредности (0-1) изостављају се. Када ниједан не остане, одговор је 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 (детектор нема класу van). 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, који се враћају у одговору; праг оцене; и fast режим.
GDPR већ у дизајну: API је хостован у ЕУ, а свака слика се обрађује само у меморији и никада се не чува. Ниједан спољни сервис за обраду слике не види ваше слике.
Интеграције: Home Assistant
Наша open-source интеграција за Home Assistant (MIT лиценца, инсталира се преко HACS) чита регистарске таблице са ваших Home Assistant камера. Даје сензор и догађај за сваку таблицу, са државом таблице и типом возила. Подржава Frigate: на догађај возила чита снимак и уписује таблицу назад у Frigate као подоознаку. Пријава користи OAuth, па сваки корисник добија свој бесплатан кључ.
Ažurirano