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», ή ως ακατέργαστα bytes με Content-Type image/*. Κάθε πινακίδα που βρίσκεται επιστρέφεται με το κείμενο, βαθμολογία 0-1, εναλλακτικές αναγνώσεις, το πλαίσιο της πινακίδας σε pixel και τη βαθμολογία ανίχνευσης. Η μηχανή είναι ο δικός μας ανιχνευτής και αναγνώστης πινακίδων, βελτιστοποιημένος σε ευρωπαϊκά φορτηγά και λεωφορεία. Οι εικόνες επεξεργάζονται στη μνήμη και δεν αποθηκεύονται ποτέ. Το image_url πρέπει να είναι δημόσια διεύθυνση http(s)· οι ιδιωτικές και εσωτερικές διευθύνσεις, καθώς και οι ανακατευθύνσεις προς αυτές, απορρίπτονται και η λήψη διακόπτεται μετά από 10 δευτερόλεπτα.
POST https://nakordoni.eu/api/v4/data/plate-recognition
— κλάση ποσόστωσης: heavy
| Παράμετρος | Περιγραφή |
|---|---|
image_url | (Σώμα JSON) Δημόσιο URL http(s) της εικόνας. Έως 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. Η εκτίμηση της περιοχής και η σειρά ανάγνωσης κλίνουν προς αυτές τις χώρες: όταν η καλύτερη ανάγνωση δεν ταιριάζει με τη μορφή καμίας χώρας της λίστας, αλλά ένας άλλος υποψήφιος με βαθμολογία το πολύ 0,15 χαμηλότερη ταιριάζει, ο υποψήφιος αυτός γίνεται η πινακίδα. Μια πινακίδα που δεν ταιριάζει σε καμία χώρα της λίστας κρατά τη συνηθισμένη απάντησή της. |
camera_id | Προαιρετικό. Το αναγνωριστικό της κάμερας ή της πύλης σας, έως 128 χαρακτήρες. Επιστρέφεται αμετάβλητο στο data.camera_id. Δεν αποθηκεύεται πέρα από το κανονικό αρχείο καταγραφής αιτημάτων. |
timestamp | Προαιρετικό. Η ώρα λήψης στη δική σας μορφή (για παράδειγμα 2026-10-27T14:05:00Z), έως 64 χαρακτήρες. Επιστρέφεται αμετάβλητη στο data.timestamp. Δεν αποθηκεύεται πέρα από το κανονικό αρχείο καταγραφής αιτημάτων. |
config | Προαιρετικό. Αντικείμενο JSON {"threshold": 0-1, "mode": "fast"|"full"}. Σε φόρμα multipart ή σε query string, στείλτε το ως συμβολοσειρά 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 | Θέση της πινακίδας σε pixel: xmin, ymin, xmax, ymax. |
data.results[].dscore | Βεβαιότητα ανίχνευσης πινακίδας 0-1. |
data.results[].vehicle | {type, score, box}: το όχημα που φέρει την πινακίδα. Το type είναι car, bus, truck ή motorcycle· το score είναι η βεβαιότητα ανίχνευσης 0-1· το box είναι η θέση του οχήματος σε pixel (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, που επιστρέφονται στην απάντηση· όριο score· και λειτουργία fast.
GDPR εκ κατασκευής: το API φιλοξενείται στην ΕΕ και κάθε εικόνα επεξεργάζεται μόνο στη μνήμη και δεν αποθηκεύεται ποτέ. Καμία εξωτερική υπηρεσία όρασης δεν βλέπει τις εικόνες σας.
Ενσωματώσεις: Home Assistant
Η ανοιχτού κώδικα ενσωμάτωσή μας για το Home Assistant (άδεια MIT, εγκαθίσταται με HACS) διαβάζει πινακίδες από τις κάμερες του Home Assistant. Δίνει έναν αισθητήρα και ένα συμβάν για κάθε πινακίδα, με τη χώρα της πινακίδας και τον τύπο οχήματος. Υποστηρίζει το Frigate: σε συμβάν οχήματος διαβάζει το στιγμιότυπο και γράφει την πινακίδα πίσω στο Frigate ως υποετικέτα. Η σύνδεση γίνεται με OAuth, έτσι κάθε χρήστης παίρνει το δικό του δωρεάν κλειδί.
Ενημερώθηκε