Convertitore di velocità

I nomi di unità sconosciuti falliscono con un chiaro errore invalid_input invece di produrre fattori sbagliati in silenzio.

Quali unità di velocità sono supportate e come funziona la conversione

Gli alias comuni sono accettati senza distinzione tra maiuscole e minuscole: kmh e kph per km/h, mi/h e miles per hour per mph, kn kt kts e knots per kn, fps e feet per second per ft/s, e mps o metres per second per m/s. Se il nome non è in quell'elenco il risolutore rifiuta la richiesta con invalid_input nominando il campo errato ed elencando le unità supportate, così i client non devono mai indovinare se un refuso ha prodotto un numero sbagliato. Le velocità negative sono ammesse per contesti di velocità orientata; il modulo assoluto deve restare entro il limite pubblicato di mille miliardi affinché i prodotti intermedi rimangano finiti nella doppia precisione IEEE, sul Worker e nel browser.

Come chiamare l'API e leggere la risposta

Value deve essere un numero finito o una stringa numerica rigorosa entro i limiti assoluti di mille miliardi. Colleghi questo a dashboard, client mobili o job in batch che già dispongono di una lettura di velocità e hanno solo bisogno di una seconda unità per la visualizzazione o il confronto normativo, senza distribuire tabelle di conversione fluttuanti in ogni binario dell'app. Invii un corpo JSON con tre campi obbligatori: value (alias speed, amount e v), from (alias from_unit, unit_from e source) e to (alias to_unit, unit_to e target). From e to devono risolversi in nomi di unità supportati dopo la normalizzazione degli alias. In caso di successo la risposta restituisce il valore d'ingresso arrotondato, le etichette canoniche from e to, result e converted impostati sullo stesso modulo di destinazione arrotondato, value_ms come intermedio SI, unit come etichetta di destinazione, factor come moltiplicatore da origine a destinazione, formula come breve stringa di equazione, message come riassunto in inglese, steps come righe ordinate di sostituzione e supported_units come i cinque identificatori canonici. Una validazione fallita—campi mancanti, numeri non finiti, valori fuori dai limiti assoluti o un nome di unità sconosciuto—restituisce invalid_input e non viene mai addebitata. Il prezzo è un $0.002 fisso per richiesta riuscita con elemento unitario e prezzo marginale per unità pari a zero.

Consigli pratici, limiti e quando usare questa landing

Preferisca inviare numeri puri per value quando controlla il client; le stringhe numeriche sono accettate solo quando corrispondono a un rigoroso schema numerico finito senza simboli di valuta o separatori delle migliaia. Normalizzi le etichette di visualizzazione dal suo lato se ha bisogno di grafie specifiche della lingua—questa API restituisce sempre i token canonici brevi m/s, km/h, mph, kn e ft/s, così i test automatici restano stabili. Le attività fallite che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economici gli script esplorativi quando i client sondano deliberatamente nomi di unità sconosciuti.