Verkürzten Plus Code mit nahen Koordinaten wiederherstellen
Ein verkürzter Plus Code ist praktisch, wenn das allgemeine Gebiet bereits bekannt ist, kann einen Ort allein jedoch nicht eindeutig bestimmen.
Im Browser ausführen – kostenlos
Dieses Werkzeug ergänzt das fehlende Präfix, indem es den kurzen Open Location Code mit einem nahe gelegenen Referenzpunkt aus Breiten- und Längengrad verbindet. Ausgegeben werden der wiederhergestellte vollständige Code, seine Mittelpunktkoordinaten sowie die Breiten- und Längengrenzen des codierten Gebiets. Die Berechnung ist deterministisch, benötigt keine Kartenabfrage und folgt den Regeln zur Zellenauswahl von Open Location Code.
Warum ein verkürzter Plus Code einen Referenzpunkt benötigt
Ein vollständiger Plus Code enthält am Anfang Zeichen für ein grobes Gebiet und zum Ende hin Zeichen mit immer höherer Genauigkeit. Bei einem verkürzten Code wird ein Teil dieses groben Präfixes absichtlich entfernt, weil die beteiligten Personen die Stadt, das Viertel oder einen nahen Orientierungspunkt bereits kennen. Auf einem lokalen Schild oder in einer Nachricht stehen beispielsweise nur wenige Zeichen vor dem Pluszeichen. Die verbleibenden Zeichen beschreiben Rasterzellen, die sich weltweit wiederholen; der Text allein ist deshalb mehrdeutig. Für die Wiederherstellung wird der fehlende Kontext als Referenzbreiten- und Referenzlängengrad angegeben. Der Rechner codiert diese nahe Koordinate zunächst mit der üblichen Paargenauigkeit, übernimmt genau so viele Anfangszeichen, wie im kurzen Code fehlen, und setzt dieses Präfix vor den eingegebenen Code. Anschließend wird der Mittelpunkt der entstandenen Zelle mit dem Referenzpunkt verglichen. Dabei erfolgt keine Suche nach Adressen, Unternehmen, Straßen oder Verwaltungsgebieten. Ermittelt wird der geografisch nächstgelegene vollständige Open Location Code, der zum verkürzten Text und zu den angegebenen Koordinaten passt. Eine Referenz aus demselben Ort ist daher eine notwendige Eingabe und nicht bloß ein optionaler Hinweis zur Verbesserung der Genauigkeit.
So wird der nächstgelegene passende Code ausgewählt
Meist genügt es, ein Präfix aus der Referenzkoordinate zu übernehmen. Orte nahe einer Zellengrenze erfordern jedoch einen weiteren Schritt. Der vorläufige vollständige Code wird als rechteckiges Gebiet mit Mittelpunkt sowie Nord-, Süd-, Ost- und Westgrenze decodiert. Der Rechner bestimmt die Auflösung des ausgelassenen Präfixes und vergleicht den vorläufigen Mittelpunkt mit der Referenz. Liegt der Mittelpunkt mehr als die Hälfte dieser Auflösung entfernt, wird der Kandidat um eine entsprechende Rasterzelle in Richtung der Referenz verschoben. Dabei bleiben die Breitengradgrenzen an den Polen gewahrt. Der Längengrad wird über den Antimeridian hinweg normalisiert, sodass ein naher Punkt auf der anderen Seite von 180 Grad kein weit entferntes Ergebnis hervorruft. Danach wird der endgültige Code erneut decodiert und mit eindeutigen Grenzen und Mittelpunktkoordinaten ausgegeben. Dieses Verfahren entspricht der vorgesehenen Interpretation des nächstgelegenen passenden Gebiets eines kurzen Plus Codes. Es behauptet weder, dass der Mittelpunkt ein Gebäudeeingang ist, noch dass jeder Punkt der Zelle dieselbe Postanschrift besitzt. Die Grenzen beschreiben die codierte Rasterfläche; der vollständige Code ist die portable Kennung, die Sie speichern oder an eine andere Open-Location-Code-Implementierung übergeben können.
Koordinaten wählen und das Ergebnis richtig lesen
Verwenden Sie eine Koordinate, die tatsächlich in der Nähe des Ortes liegt, an dem der kurze Code erstellt wurde. Ein Ortszentrum, ein bereits bekannter Wegpunkt oder die aktuelle GPS-Position eignen sich, wenn sie zum selben Gebiet gehören. Je stärker ein Code gekürzt ist, desto mehr vom geografischen Präfix fehlt und desto wichtiger wird eine wirklich nahe Referenz. Eine ungenaue oder entfernte Koordinate kann eine andere wiederkehrende Zelle auswählen, die ebenfalls zu den übrigen Zeichen passt. Prüfen Sie nach der Wiederherstellung sowohl full_code als auch den ausgegebenen Mittelpunkt. Die Felder latitude_lo, latitude_hi, longitude_lo und longitude_hi zeigen das exakte vom Ergebnis codierte Rechteck und eignen sich zum Einpassen einer Karte oder für eine Enthaltenseinsprüfung. Bewahren Sie den ursprünglichen kurzen Code und die Referenzkoordinate in einem Prüfprotokoll auf, wenn Reproduzierbarkeit wichtig ist, denn das vollständige Ergebnis wird aus beiden Angaben abgeleitet. Eingaben erfolgen in Dezimalgrad; der Breitengrad muss zwischen den Polen und der Längengrad im üblichen vorzeichenbehafteten Bereich liegen. Der Vorgang nutzt weder Netzwerkdienst noch Kartendatenbank, aktuelle Uhrzeit oder Zufall. Dieselbe gültige Eingabe erzeugt daher interaktiv wie in einem automatisierten Ablauf stets denselben Code und dieselbe numerische Fläche; pro Anfrage fallen $0.002 an.
Anwendungsfälle
Einen Code aus einer lokalen Nachricht vervollständigen
Verbinden Sie einen kurzen Viertelcode mit einer bekannten nahen Koordinate, bevor Sie ihn weltweit speichern oder weitergeben.
Aufzeichnungen aus Feldvermessungen vereinheitlichen
Wandeln Sie verkürzte Codes und Referenzkoordinaten in vollständige Kennungen mit ausdrücklich decodierten Grenzen um.
Navigationsdaten für ein anderes System vorbereiten
Stellen Sie portable vollständige Codes wieder her, bevor Sie Wegpunkte in Software exportieren, die keine verkürzten Plus Codes annimmt.
Häufige Fragen
Was wird zur Wiederherstellung eines verkürzten Plus Codes benötigt?
Geben Sie den kurzen Code sowie einen nahen Breiten- und Längengrad in Dezimalgrad an. Alle drei Werte sind erforderlich, weil das ausgelassene Präfix den geografischen Kontext darstellt.
Wie nah muss die Referenzkoordinate liegen?
Sie sollte sich im selben Ort wie das gesuchte Ziel befinden. Je mehr Zeichen im Code fehlen, desto wichtiger ist eine tatsächlich nahe Referenz.
Kann damit eine Adresse oder ein Ortsname gefunden werden?
Nein. Das Werkzeug führt ausschließlich Open-Location-Code-Berechnungen durch und fragt weder Karten, Geocoder, Branchenverzeichnisse noch Postdatenbanken ab.
Warum werden neben dem vollständigen Code Grenzen ausgegeben?
Ein Plus Code beschreibt eine Fläche und keinen unendlich genauen Punkt. Grenzen und Mittelpunkt machen dieses codierte Rechteck eindeutig sichtbar.
Kann ich einen bereits vollständigen Plus Code eingeben?
Nein. Diese Fähigkeit dient eigens der Wiederherstellung verkürzter Codes und weist einen Code zurück, dessen Pluszeichen bereits an der vollständigen Position steht.
Was kostet eine API-Anfrage?
Jede API-Anfrage kostet $0.002. Die Browserversion läuft lokal und sendet die Berechnung nicht an einen Kartendienst.
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
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/plus-code-recover \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}'const res = await fetch("https://api.kit.forhosting.com/geo/plus-code-recover", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/plus-code-recover",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/plus-code-recover", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"short_code":"9G8F+6X","latitude":47.36559,"longitude":8.524997}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/plus-code-recover", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"short_code": "9G8F+6X",
"latitude": 47.36559,
"longitude": 8.524997
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.plus_code_recover",
"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
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. |