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", или како суровите бајти со заглавие Content-Type image/*. Секоја пронајдена табличка се враќа со текстот, оценка 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 поле или параметар во барањето). До 10. Претпоставката за регионот и редоследот на читање се насочуваат кон овие држави: кога најдобриот резултат не одговара на формат на ниту една наведена држава, а друг кандидат со најмногу 0.15 помал score одговара, тој кандидат станува таблицата. Таблица што не одговара на ниту една наведена држава го задржува вообичаениот одговор. |
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. Резултатите со score под оваа вредност (0-1) се изоставуваат. Кога не останува ниту еден, одговорот е 404 no_plate_detected. |
mode | Опционално, исто како config.mode. full (стандардно) вршi препознавање на таблица и детекција на возило. 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 engine, прилагоден на ЕУ камиони и автобуси на гранични премини и во автобуски депоа. Чита и таблици од автомобили и мотоцикли.
Верзијата v4 ги додава државата на таблицата и типот на возилото (car, bus, truck или motorcycle). Прифаќа и опционални опции на барањето: regions, за да го насочите резултатот кон државите што ги очекувате; camera_id и timestamp, што се враќаат во одговорот; праг на score; и fast режим.
GDPR по дизајн: API-то се хостира во ЕУ, а секоја слика се обработува само во меморија и никогаш не се чува. Ниту една надворешна услуга за визија не ги гледа вашите слики.
Интеграции: Home Assistant
Нашата open-source интеграција за Home Assistant (MIT лиценца, се инсталира со HACS) чита регистарски таблици од вашите камери во Home Assistant. Дава сензор и настан за секоја таблица, со државата на таблицата и типот на возилото. Поддржува Frigate: при настан за возило ја чита сликата и ја запишува таблицата назад во Frigate како под-ознака. Најавата е преку OAuth, па секој корисник добива свој бесплатен клуч.
Ажурирано