ForHosting KIT · Strumenti per sviluppatori

USNG in latitudine e longitudine

Un riferimento della griglia nazionale statunitense identifica un’area, non un punto infinitamente preciso.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Questo convertitore legge USNG compatto o spaziato, convalida zona UTM, fascia di latitudine, quadrato da cento chilometri e precisione numerica, quindi restituisce latitudine e longitudine WGS84 approssimative al centro della cella. Riporta inoltre dimensione, precisione, coordinate UTM, zona, fascia e quadrato. Tutto viene calcolato localmente con matematica deterministica, senza mappe, rete, casualità o dipendenze dall’ora corrente.

Come un riferimento USNG individua una cella

Il riferimento inizia con una zona UTM da 1 a 60 e una fascia da C a X, escludendo I e O. Due lettere indicano il quadrato da cento chilometri; le colonne ruotano ogni tre zone e le righe cambiano tra zone pari e dispari. Le cifre restanti sono divise equamente tra est e nord: una per asse indica dieci chilometri, cinque indicano un metro e nessuna indica l’intero quadrato. Il convertitore elimina gli spazi, normalizza le maiuscole e verifica ogni elemento. Espande quindi lettere e cifre fino al bordo sud-occidentale e aggiunge metà cella su entrambi gli assi, ottenendo il centro. Poiché il riferimento descrive comunque un’area, Lei deve considerare la coordinata un punto rappresentativo, soprattutto con precisione bassa. cell_size_m e point impostato su center conservano esplicitamente questo significato.

Dai metri UTM alle coordinate WGS84

Calcolato il centro, l’algoritmo risolve le righe ripetute tramite il nord minimo della fascia, poiché le lettere USNG ricorrono ogni due milioni di metri. Le fasce meridionali usano il falso nord UTM. La coordinata viene invertita usando ellissoide WGS84, appiattimento, fattore di scala e serie dell’arco meridiano; la zona sceglie il meridiano centrale. La latitudine finale deve appartenere alla fascia dichiarata, altrimenti viene restituito un errore. Il JSON contiene latitude, longitude, lat, lon, USNG normalizzato, zona, fascia, quadrato, precisione, dimensione, centro UTM e datum. L’arrotondamento stabile a otto decimali rende ripetibili i risultati. Non vengono consultati geocoder: browser e API eseguono lo stesso calcolo limitato.

Scegliere la precisione e usare correttamente il centro

Tratti le cifre come dichiarazione di precisione, non come semplice formato. Cinque per asse nominano una cella nominale di un metro, ma non provano l’esattezza dell’osservazione; una sola copre dieci chilometri. Conservi cell_size_m quando importa rapporti, appunti, beni o archivi. La mappa può mostrare il centro e usare la dimensione per incertezza e zoom. Sono accettate forme compatte e spaziate; lettere mancanti, I o O, cifre dispari, zone fuori 1–60, colonne incompatibili e quadrati fuori fascia vengono respinti. Ogni elemento API valido costa $0.002; il browser è adatto a consultazioni singole. Per un poligono conservi centro UTM e dimensione o usi un convertitore di limiti. La funzione non fornisce indirizzo, quota, giurisdizione o garanzia topografica.

Casi d'uso

Posizionare rapporti sul campo

Converta riferimenti da moduli o radio in marcatori WGS84 centrati, conservando la precisione.

Importare registri storici

Normalizzi valori compatti o spaziati in coordinate deterministiche per GIS, audit e migrazioni.

Verificare software cartografico

Usi centri, valori UTM e dimensioni stabili come test di regressione per applicazioni USNG.

Domande frequenti

Quale punto della cella viene restituito?

Il centro: metà dimensione viene aggiunta a entrambi gli assi UTM prima della conversione WGS84.

Come influisce la precisione?

Da zero a cinque cifre per asse rappresentano celle da cento chilometri a un metro; celle maggiori implicano più incertezza.

Sono ammessi spazi e minuscole?

Sì. Gli spazi comuni vengono rimossi e le lettere convertite in maiuscolo prima della convalida.

Quale datum viene usato?

Latitudine e longitudine sono WGS84; sono inclusi anche centro UTM, zona, fascia, quadrato e dimensione.

Quanto costa?

Lo strumento nel browser è gratuito. Ogni elemento API valido usa il prezzo base pubblicato di $0.002.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/geo/usng-to-latlon

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/geo/usng-to-latlon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usng":"18S UJ 23483 06479"}'

const res = await fetch("https://api.kit.forhosting.com/geo/usng-to-latlon", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "usng": "18S UJ 23483 06479"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/usng-to-latlon",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "usng": "18S UJ 23483 06479"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/usng-to-latlon", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"usng":"18S UJ 23483 06479"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"usng":"18S UJ 23483 06479"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/usng-to-latlon", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "usng": "18S UJ 23483 06479"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.usng_to_latlon",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →