ForHosting KIT · Entwickler-Tools

USNG in Breiten- und Längengrad

Eine Referenz des United States National Grid bezeichnet eine Fläche, keinen unendlich genauen Punkt.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dieser Konverter liest kompakte oder gegliederte USNG-Werte, prüft UTM-Zone, Breitenband, Hundertkilometerquadrat und numerische Genauigkeit und liefert den ungefähren WGS84-Mittelpunkt. Zusätzlich erhalten Sie Zellgröße, Genauigkeit, UTM-Koordinaten, Zone, Band und Quadrat. Die Berechnung erfolgt vollständig lokal und deterministisch, ohne Karten, Netzwerk, Zufall oder Zeitabhängigkeit.

Wie eine USNG-Referenz eine Rasterzelle bestimmt

Die Referenz beginnt mit einer UTM-Zone von 1 bis 60 und einem Bandbuchstaben C bis X ohne I und O. Zwei weitere Buchstaben bestimmen das Hundertkilometerquadrat. Spaltenalphabete wiederholen sich nach drei Zonen, Reihen verschieben sich zwischen geraden und ungeraden Zonen. Die restlichen Ziffern werden gleichmäßig auf Ost- und Nordwert verteilt: eine je Achse bedeutet zehn Kilometer, fünf bedeuten einen Meter, keine das ganze Quadrat. Der Konverter entfernt Leerraum, vereinheitlicht Großbuchstaben und prüft alle Teile. Danach erweitert er Buchstaben und Ziffern bis zur Südwestecke und addiert auf beiden Achsen eine halbe Zellgröße. So entsteht der Mittelpunkt. Da die Referenz weiterhin eine Fläche beschreibt, sollten Sie das Ergebnis besonders bei grober Genauigkeit als repräsentativen Punkt behandeln. cell_size_m und point mit center halten diese Bedeutung ausdrücklich fest.

Von UTM-Metern zu WGS84-Koordinaten

Nach Ermittlung des Mittelpunkts löst die Berechnung wiederkehrende Reihen anhand des minimalen Nordwerts des Bands auf; USNG-Reihen wiederholen sich alle zwei Millionen Meter. Südliche Bänder verwenden den UTM-Falschnordwert. Anschließend wird die Koordinate mit WGS84-Ellipsoid, Abplattung, Maßstabsfaktor und Meridianbogenreihen invertiert; die Zone bestimmt den Mittelmeridian. Die fertige Breite muss im angegebenen Band liegen, sonst folgt ein Fehler. JSON enthält latitude, longitude, lat, lon, normalisiertes USNG, Zone, Band, Quadrat, Genauigkeit, Zellgröße, UTM-Mittelpunkt und Datum. Stabile Rundung auf acht Stellen macht Ergebnisse reproduzierbar. Kein Geocoder wird aufgerufen; Browser und API verwenden dieselbe begrenzte Berechnung.

Genauigkeit wählen und den Mittelpunkt richtig nutzen

Verstehen Sie die Ziffernzahl als Genauigkeitsangabe, nicht als Gestaltung. Fünf Ziffern je Achse benennen nominell einen Meter, beweisen aber keine entsprechende Messgenauigkeit; eine Ziffer umfasst zehn Kilometer. Bewahren Sie cell_size_m beim Import von Meldungen, Notizen, Anlagen oder Archiven auf. Karten können den Mittelpunkt markieren und die Größe für Unsicherheit oder Zoom verwenden. Kompakte und gegliederte Formen werden angenommen; fehlende Buchstaben, I oder O, ungerade Ziffernzahlen, Zonen außerhalb 1–60, unpassende Spalten und bandfremde Quadrate werden abgelehnt. Ein gültiges API-Element kostet $0.002; der Browser eignet sich für Einzelabfragen. Für Polygone behalten Sie UTM-Mitte und Größe oder nutzen einen Grenzkonverter. Adressen, Höhen, Zuständigkeiten und Vermessungsgarantien werden nicht geliefert.

Anwendungsfälle

Einsatzmeldungen kartieren

Wandeln Sie Referenzen aus Formularen oder Funkprotokollen in zentrierte WGS84-Marker mit Genauigkeit um.

Alte Rasterdaten importieren

Normalisieren Sie kompakte oder gegliederte Werte für GIS, Prüfungen und Migrationen.

Kartensoftware testen

Nutzen Sie stabile Mittelpunkte, UTM-Werte und Zellgrößen für Regressionstests.

Häufige Fragen

Welcher Punkt der Zelle wird ausgegeben?

Der Mittelpunkt; vor der WGS84-Umrechnung wird beiden UTM-Achsen eine halbe Zellgröße hinzugefügt.

Wie wirkt sich die Genauigkeit aus?

Null bis fünf Ziffern je Achse stehen für hundert Kilometer bis einen Meter; größere Zellen bedeuten mehr Unsicherheit.

Sind Leerzeichen und Kleinbuchstaben zulässig?

Ja. Üblicher Leerraum wird entfernt, Buchstaben werden vor der Prüfung großgeschrieben.

Welches Datum wird verwendet?

Geografische Koordinaten nutzen WGS84; UTM-Mitte, Zone, Band, Quadrat und Größe werden ebenfalls ausgegeben.

Was kostet die Umrechnung?

Das Browserwerkzeug ist gratis. Ein gültiges API-Element kostet den veröffentlichten Grundpreis $0.002.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

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

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem 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)

Beispiel-Anfrage

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

Beispiel-Antwort

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

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →