Plaka Tanıma API (ALPR / ANPR) Online
V1 ile karşılaştırıldığında: yeni parametreler regions, camera_id, timestamp, config, threshold, mode
Bir aracın fotoğrafındaki plakaları okur. Tek bir görseli (JPEG, PNG, WebP, BMP veya TIFF, en fazla 8 MB) image_url veya image_base64 içeren bir JSON gövdesi olarak, "image" alanında multipart/form-data yüklemesi olarak ya da image/* Content-Type ile ham bayt olarak POST edin. Bulunan her plaka metni, 0-1 arası bir puanı, alternatif okumaları, piksel cinsinden plaka kutusunu ve tespit puanını içerecek şekilde döner. Motor, Avrupa kamyon ve otobüsleri üzerinde ayarlanmış kendi plaka dedektörümüz ve okuyucumuzdur. Görseller bellekte işlenir ve asla saklanmaz. image_url herkese açık bir http(s) adresi olmalıdır; özel ve dahili adresler ile bunlara yönlendirmeler reddedilir ve indirme 10 saniye sonra durdurulur.
POST https://nakordoni.eu/api/v4/data/plate-recognition
— kota sınıfı: heavy
| Parametre | Açıklama |
|---|---|
image_url | (JSON gövdesi) Görselin herkese açık http(s) URL'si. En fazla 8 MB, en fazla 3 yönlendirme, 10 s indirme sınırı. |
image_base64 | (JSON gövdesi) Base64 olarak görsel (data:image/...;base64, öneki kabul edilir). image_url veya image_base64 gönderin, ikisini birden değil. |
regions | İsteğe bağlı. Beklediğiniz ülkeler, ISO 3166-1 alpha-2 kodlarıyla: bir JSON dizisi ["PL","DE"] veya virgülle ayrılmış bir dize "PL,DE" (multipart alanı veya sorgu parametresi). En fazla 10. Bölge tahmini ve okuma sırası bu ülkelere doğru yönlendirilir: en iyi okuma listelenen hiçbir ülkenin biçimiyle eşleşmezse, ancak skoru en fazla 0.15 düşük olan başka bir aday eşleşirse, o aday plaka olur. Listelenen hiçbir ülkeyle eşleşmeyen bir plaka normal yanıtını korur. |
camera_id | İsteğe bağlı. Kameranızın veya bariyerinizin kimliği, en fazla 128 karakter. data.camera_id içinde değiştirilmeden döndürülür. Normal istek günlüğünün ötesinde saklanmaz. |
timestamp | İsteğe bağlı. Kendi biçiminizde çekim zamanı (örneğin 2026-10-27T14:05:00Z), en fazla 64 karakter. data.timestamp içinde değiştirilmeden döndürülür. Normal istek günlüğünün ötesinde saklanmaz. |
config | İsteğe bağlı. JSON nesnesi {"threshold": 0-1, "mode": "fast"|"full"}. Multipart formunda veya sorgu dizesinde bunu JSON dizesi olarak gönderin ya da threshold ve mode alanlarını kullanın. |
threshold | İsteğe bağlı, config.threshold ile aynıdır. Skoru bu değerin (0-1) altında olan sonuçlar dışarıda bırakılır. Hiçbiri kalmazsa yanıt 404 no_plate_detected olur. |
mode | İsteğe bağlı, config.mode ile aynıdır. full (varsayılan) plaka tanıma ve araç tespitini çalıştırır. fast, v2'ye yakın hız için araç tespitini atlar: region yine doldurulur, vehicle null olur. |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
data.success | En az bir plaka okunduysa true; data.message kaç plaka okunduğunu belirtir. |
data.processing_time | İstek için harcanan süre, milisaniye olarak (indirme, plaka tanıma ve araç tespiti). v4, araç tespiti nedeniyle v2'den uzun sürer; görüntü başına genellikle 0.5-1.5 s. config.mode=fast ile araç tespiti yoktur ve süre v2'ye yakındır. |
data.camera_id | Gönderdiğiniz camera_id, değiştirilmeden. Yalnızca bir tane gönderdiyseniz bulunur. |
data.timestamp | Gönderdiğiniz timestamp, değiştirilmeden (dize dize olarak, sayı sayı olarak kalır). Yalnızca bir tane gönderdiyseniz bulunur. |
data.results[] | Plaka başına bir kayıt, en yüksek tespit puanı önce gelir. |
data.results[].plate | Plaka metni, büyük harf, yalnızca A-Z harfleri ve rakamlar (boşluk veya tire yok). |
data.results[].score | Okuma güveni 0-1 (karakter başına güvenlerin ortalaması). |
data.results[].candidates[] | {plate, score} biçiminde en fazla 5 okuma, en iyisi önce; ilki plakadır. |
data.results[].region | {code, score}: code, plaka biçiminden okunan plakanın ISO 3166-1 alpha-2 ülke kodudur (örneğin UA, PL, RO). score 0-1, okuma güveninin biçimin ne kadar belirgin olduğuyla çarpımıdır; aynı biçim birkaç ülkede kullanılıyorsa (örneğin LT, MD ve HU, ABC123 biçimini paylaşır) puan bunlar arasında bölünür ve düşüktür. Metin bilinen hiçbir biçimle eşleşmezse null. Desteklenenler: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE. |
data.results[].box | Piksel cinsinden plaka konumu: xmin, ymin, xmax, ymax. |
data.results[].dscore | Plaka tespit güveni 0-1. |
data.results[].vehicle | {type, score, box}: plakayı taşıyan araç. type car, bus, truck veya motorcycle olur; score 0-1 arası tespit güvenidir; box aracın piksel cinsinden konumudur (xmin, ymin, xmax, ymax). Önden görülen yolcu otobüsleri ile minibüsler veya vanlar truck olarak türlenebilir (dedektörde van sınıfı yoktur). Tespit edilen hiçbir araç plakayı içermiyorsa null, config.mode=fast ile ise her zaman 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, bad_regions, bad_camera_id, bad_timestamp, bad_config, bad_threshold, bad_mode. 404: no_plate_detected (config.threshold hiç sonuç bırakmadığında 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
}
}'
Avrupa araçları için plaka tanıma (ANPR / ALPR)
Plate Image Recognition API bir plaka tanıma (LPR) hizmetidir: bir fotoğraf gönderin, plaka metnini JSON olarak geri alın. Sınır kapılarındaki ve otobüs garajlarındaki AB kamyon ve otobüsleri üzerinde ayarlanmış kendi ANPR / ALPR motorumuzdur; otomobil ve motosiklet plakalarını da okur.
v4 sürümü plakanın ülkesini ve araç türünü (car, bus, truck veya motorcycle) ekler. Ayrıca isteğe bağlı istek seçeneklerini kabul eder: sonucu beklediğiniz ülkelere yöneltmek için regions; yanıtta geri dönen camera_id ve timestamp; bir skor eşiği; ve bir fast modu.
Tasarımdan GDPR: API AB'de barındırılır ve her görüntü yalnızca bellekte işlenir, hiçbir zaman saklanmaz. Üçüncü taraf hiçbir görüntü hizmeti görüntülerinizi görmez.
Entegrasyonlar: Home Assistant
Açık kaynaklı Home Assistant entegrasyonumuz (MIT lisansı, HACS ile kurulabilir) Home Assistant kameralarınızdan plakaları okur. Her plaka için bir sensör ve bir olay verir; plakanın ülkesi ve araç türü de içindedir. Frigate'i destekler: bir araç olayında anlık görüntüyü okur ve plakayı Frigate'e alt etiket olarak geri yazar. Oturum açma OAuth kullanır, bu yüzden her kullanıcı kendi ücretsiz anahtarını alır.
Güncellendi