L'invio delle notizie e la flotta NakBus sono ora nella dashboard partner

Usi le stesse credenziali di accesso (e-mail e password) del suo account sviluppatore per accedere al pannello Nakordoni Partners e gestire lì le notizie e la flotta di autobus (NakDriver / NakManager), con ruoli di team. Le chiavi API, gli endpoint e le app restano invariati e le pagine qui presenti continuano a funzionare. Apri Nakordoni Partners

API di riconoscimento targhe (ALPR / ANPR) Online

Legge le targhe in una foto di un veicolo. Invia in POST un'immagine (JPEG, PNG, WebP, BMP o TIFF, max 8 MB) come corpo JSON con image_url o image_base64, come upload multipart/form-data nel campo "image", oppure come byte grezzi con un Content-Type image/*. Ogni targa trovata viene restituita con il testo, un punteggio 0-1, letture alternative, il riquadro della targa in pixel e il punteggio di rilevamento. Il motore è il nostro rilevatore e lettore di targhe, ottimizzato su camion e autobus europei. Le immagini vengono elaborate in memoria e mai archiviate. image_url deve essere un indirizzo http(s) pubblico; gli indirizzi privati e interni, e i reindirizzamenti verso di essi, vengono rifiutati e il download viene interrotto dopo 10 secondi.

POST https://nakordoni.eu/api/v2/data/plate-recognition — classe di quota: heavy

Parametro	Descrizione
`image_url`	(corpo JSON) URL http(s) pubblico dell'immagine. Max 8 MB, max 3 reindirizzamenti, limite di download di 10 s.
`image_base64`	(corpo JSON) L'immagine in base64 (è consentito un prefisso data:image/...;base64,). Invia image_url o image_base64, non entrambi.

Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.

Campo	Descrizione
`data.success`	true quando è stata letta almeno una targa; data.message indica quante.
`data.processing_time`	Tempo impiegato per la richiesta in millisecondi (download e riconoscimento).
`data.results[]`	Una voce per targa, prima quella con il punteggio di rilevamento più alto.
`data.results[].plate`	Testo della targa, in maiuscolo, solo lettere A-Z e cifre (senza spazi né trattini).
`data.results[].score`	Affidabilità della lettura 0-1 (media delle affidabilità dei singoli caratteri).
`data.results[].candidates[]`	Fino a 5 letture {plate, score}, la migliore per prima; la prima è la targa.
`data.results[].region`	{code, score} con il paese della targa quando il motore riesce a stabilirlo; altrimenti null (il motore attuale non deduce il paese).
`data.results[].box`	Posizione della targa in pixel: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Affidabilità del rilevamento della targa 0-1.
`data.results[].vehicle`	Dettagli del veicolo quando disponibili; null con il motore attuale.
`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. 404: no_plate_detected. 413: payload_too_large. 500: engine_error.

curl -X POST "https://nakordoni.eu/api/v2/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"
}'

Rispetto a V1: nuovi parametri regions, camera_id, timestamp, config, threshold, mode

Cosa cambia in questa versione: v4 compila due campi che v2 restituisce sempre come null. results[].region indica il paese della targa come {code, score}, letto dal formato della targa: lo schema di lettere e cifre di ogni paese e, dove il formato lo prevede, il prefisso della regione o della provincia (per esempio il CE di una targa ucraina). results[].vehicle indica il veicolo che porta la targa come {type, score, box}, dal nostro rilevatore di veicoli: type è car, bus, truck o motorcycle. v4 accetta anche opzioni di richiesta facoltative: regions, camera_id, timestamp, config.threshold e config.mode. Senza di esse, l'output di v4 non cambia. Gli altri campi della risposta e i codici di errore di v2 sono gli stessi. v2 continua a restituire null per entrambi i campi e ignora le opzioni.

POST https://nakordoni.eu/api/v4/data/plate-recognition — classe di quota: heavy

Parametro	Descrizione
`image_url`	(corpo JSON) URL http(s) pubblico dell'immagine. Max 8 MB, max 3 reindirizzamenti, limite di download di 10 s.
`image_base64`	(corpo JSON) L'immagine in base64 (è consentito un prefisso data:image/...;base64,). Invia image_url o image_base64, non entrambi.
`regions`	Facoltativo. I paesi che ti aspetti, come codici ISO 3166-1 alpha-2: un array JSON ["PL","DE"] o una stringa separata da virgole "PL,DE" (campo multipart o parametro di query). Fino a 10. La stima della regione e l'ordine di lettura sono orientati verso questi paesi: quando la lettura migliore non corrisponde al formato di nessun paese indicato, ma un altro candidato con un punteggio inferiore di al massimo 0.15 sì, quel candidato diventa la targa. Una targa che non corrisponde a nessun paese indicato mantiene la risposta normale.
`camera_id`	Facoltativo. L'ID della tua telecamera o del tuo varco, fino a 128 caratteri. Restituito invariato in data.camera_id. Non viene memorizzato oltre il normale log delle richieste.
`timestamp`	Facoltativo. L'ora di acquisizione nel tuo formato (per esempio 2026-10-27T14:05:00Z), fino a 64 caratteri. Restituita invariata in data.timestamp. Non viene memorizzata oltre il normale log delle richieste.
`config`	Facoltativo. Oggetto JSON {"threshold": 0-1, "mode": "fast"\|"full"}. In un modulo multipart o in una query string, invialo come stringa JSON oppure usa i campi threshold e mode.
`threshold`	Facoltativo, uguale a config.threshold. I risultati con un punteggio inferiore a questo valore (0-1) vengono esclusi. Se non ne resta nessuno, la risposta è 404 no_plate_detected.
`mode`	Facoltativo, uguale a config.mode. full (predefinito) esegue il riconoscimento della targa e il rilevamento del veicolo. fast salta il rilevamento del veicolo per una velocità simile a v2: region viene comunque compilato, vehicle è null.

Campo	Descrizione
`data.success`	true quando è stata letta almeno una targa; data.message indica quante.
`data.processing_time`	Tempo impiegato per la richiesta in millisecondi (download, riconoscimento della targa e rilevamento del veicolo). v4 è più lento di v2 a causa del rilevamento del veicolo, in genere 0.5-1.5 s per immagine. Con config.mode=fast non c'è rilevamento del veicolo e il tempo è vicino a quello di v2.
`data.camera_id`	Il camera_id che hai inviato, invariato. Presente solo se ne hai inviato uno.
`data.timestamp`	Il timestamp che hai inviato, invariato (una stringa resta stringa, un numero resta numero). Presente solo se ne hai inviato uno.
`data.results[]`	Una voce per targa, prima quella con il punteggio di rilevamento più alto.
`data.results[].plate`	Testo della targa, in maiuscolo, solo lettere A-Z e cifre (senza spazi né trattini).
`data.results[].score`	Affidabilità della lettura 0-1 (media delle affidabilità dei singoli caratteri).
`data.results[].candidates[]`	Fino a 5 letture {plate, score}, la migliore per prima; la prima è la targa.
`data.results[].region`	{code, score}: code è il paese della targa secondo ISO 3166-1 alpha-2 (ad esempio UA, PL, RO), ricavato dal formato della targa. score 0-1 è l'affidabilità della lettura moltiplicata per la specificità del formato; quando lo stesso formato è usato in più paesi (ad esempio LT, MD e HU condividono ABC123) il punteggio viene suddiviso tra di essi ed è basso. null quando il testo non corrisponde a nessun formato noto. Coperti: UA, BG, BY, RO, ES, CZ, BE, EE, HU, TR, PL, SK, LV, LT, MD, IT, FR, RS, DE.
`data.results[].box`	Posizione della targa in pixel: xmin, ymin, xmax, ymax.
`data.results[].dscore`	Affidabilità del rilevamento della targa 0-1.
`data.results[].vehicle`	{type, score, box}: il veicolo che porta la targa. type è car, bus, truck o motorcycle; score è l'affidabilità del rilevamento 0-1; box è la posizione del veicolo in pixel (xmin, ymin, xmax, ymax). Gli autobus turistici visti di fronte e i minibus o i furgoni possono essere classificati come truck (il rilevatore non ha una classe furgone). null quando nessun veicolo rilevato contiene la targa, e sempre null con 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 (anche quando config.threshold non lascia alcun risultato). 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
    }
}'

Riconoscimento targhe (ANPR / ALPR) per i veicoli europei

La Plate Image Recognition API è un servizio di riconoscimento targhe (LPR): invii una foto e ricevi il testo della targa come JSON. È il nostro motore ANPR / ALPR, ottimizzato su camion e autobus UE ai valichi di frontiera e nei depositi di autobus, e legge anche le targhe di auto e moto.

La versione v4 aggiunge il paese della targa e il tipo di veicolo (car, bus, truck o motorcycle). Accetta anche opzioni di richiesta facoltative: regions, per orientare il risultato verso i paesi che ti aspetti; camera_id e timestamp, che tornano nella risposta; una soglia di punteggio; e una modalità fast.

RGPD by design: l'API è ospitata in UE e ogni immagine viene elaborata solo in memoria e mai salvata. Nessun servizio di visione di terze parti vede le tue immagini.

Integrazioni: Home Assistant

La nostra integrazione open source per Home Assistant (licenza MIT, installabile con HACS) legge le targhe dalle telecamere di Home Assistant. Ti dà un sensore e un evento per ogni targa, con il paese della targa e il tipo di veicolo. Supporta Frigate: a ogni evento veicolo legge lo snapshot e riscrive la targa in Frigate come sub-label. L'accesso usa OAuth, quindi ogni utente ottiene la propria chiave gratuita.

Integrazione Home Assistant su GitHub ↗ Integrazioni

🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 10 chiamate di test gratuite per prodotto al giorno. Accedi

Aggiornato 28.10.2026 04:08