ForHosting KIT · Reisen und Geografie

Plus Code kürzen

In der Nähe des Bezugspunkts 47.5, 8.5 wird der vollständige Plus Code 8FVC9G8F+6X zu 9G8F+6X: Die ersten vier Zeichen entfallen, weil die Umgebung sie bereits liefert. Entfernt wird nur, was sich sicher wiederherstellen lässt. Kostenlos in Ihrem Browser.

  • Kostenlos
  • Läuft in Ihrem Browser
  • Ohne Anmeldung
  • Ihre Daten bleiben auf Ihrem Gerät
Nutzen Sie es über WebAPIE-MailTelegramApp bald
Wenn Sie eingeben
Code
8FVC9G8F+6X
Breitengrad
47,5
Längengrad
8,5
Erhalten Sie
Kurzcode
9G8F+6X
Vollständiger Code
8FVC9G8F+6X
Entfernte Zeichen
4
Codelänge
10

Open Location Codes, besser bekannt als Plus Codes, wandeln Breite und Länge in kurze Zeichenketten um, die man diktieren, tippen und drucken kann, ohne Hausnummern zu brauchen. Ein vollständiger Code wie eight F V C nine G eight F plus six X ist weltweit eindeutig, doch der Alltag findet meist in einer bekannten Stadt oder Nachbarschaft statt, wo die führenden Paare sich wiederholen und nur der Schlussblock den Punkt kennzeichnet. Dieser Plus-Code-Kürzer nimmt einen gültigen vollständigen Code sowie eine nahe Referenzbreite und -länge entgegen, misst den Abstand der Referenz zum Zellmittelpunkt und entfernt so viele führende Zeichenpaare, wie die Sicherheitsregel des Open Location Code zulässt.

Wie die Plus-Code-Kürzung relativ zu einem Referenzort funktioniert

Ein vollständiger Open Location Code kodiert eine rechteckige Zelle auf der Erde mit dem zwanzig Zeichen umfassenden Alphabet von zwei bis neun und C F G H J M P Q R V W X sowie einem Pflicht-Plus-Trenner nach acht Zeichen. Die ersten zehn signifikanten Ziffern bilden Breiten- und Längenpaare, die die Zelle mit aufeinanderfolgenden Faktoren von zwanzig verfeinern; optionale Gitterziffern nach dem Trenner verfeinern weiter.

Wenn Sie einen Ort in einem bekannten Gebiet teilen, stimmen die ersten vier oder sechs Zeichen oft für alle nahen Stellen überein und erzeugen eher Rauschen als Nutzen. Die Kürzung streicht nicht einfach ein festes Präfix: Sie dekodiert den Vollcode bis zum Zellmittelpunkt, vergleicht diesen mit Ihrer Referenzbreite und -länge anhand einer Tschebyscheff-Metrik (dem Maximum der absoluten Breiten- und Längendifferenz in Grad) und durchläuft eine feste Auflösungstabelle von zwanzig, eins, null Komma null fünf, null Komma null null zwei fünf und null Komma null null null eins zwei fünf Grad.

Liegt der Bereich unter dreißig Prozent einer Paarauflösung, darf der Algorithmus die entsprechenden führenden Paare entfernen. Dieser Dreißig-Prozent-Faktor ist eine bewusste Sicherheitsmarge, damit der Kurzcode die nächste Übereinstimmung bleibt, wenn ihn jemand später von einem leicht anderen Stadtzentrum oder GPS-Messwert aus wiederherstellt. Ist die Referenz weit entfernt, werden keine Paare entfernt und der Vollcode unverändert zurückgegeben.

Aufgefüllte Codes, die nur ein großes Gebiet beschreiben (mit Nullen vor dem Trenner), lassen sich nicht kürzen, weil ihnen genug Präzisionsziffern für einen sicheren Schnitt fehlen. Die Fähigkeit implementiert nur diesen rein arithmetischen Pfad: Sie sucht keine Ortsnamen, ruft keine Karten-APIs auf und erfindet keine Ortsbezeichnungen, die Sie selbst anhängen sollten.

Eingabevertrag, Antwortform und Fehlerverhalten

Aufgefüllte Codes mit Null-Padding vor dem Trenner werden mit der Meldung abgelehnt, dass sie nicht gekürzt werden können. Die Breite wird auf das geschlossene Intervall von minus neunzig bis neunzig begrenzt; die Länge wird in das halboffene Intervall von minus einhundertachtzig bis einhundertachtzig normalisiert. Fehlende Felder, leere Zeichenketten und nicht endliche Zahlen scheitern mit feldbezogenen Meldungen und werden nicht berechnet.

Beispiel: Der Code eight F V C nine G eight F plus six X mit Referenzbreite siebenundvierzig Punkt fünf und Länge acht Punkt fünf ergibt den Kurzcode nine G eight F plus six X nach Entfernen der ersten vier Zeichen. Kombinieren Sie den Kurzcode in Ihrer eigenen Oberfläche mit einer Ortsbezeichnung; dieser Endpunkt gibt niemals Städtenamen aus.

Wo ein Plus-Code-Kürzer seinen Nutzen beweist

Liefer-, Außendienst- und Logistik-Apps speichern bereits vollständige Open Location Codes für Türen ohne Hausnummer; wenn sie in einer bekannten Stadt ein Etikett drucken oder eine SMS senden, brauchen sie die Kurzform, die Fahrer aus Google Maps und plus.codes kennen. Katastrophenhilfe und humanitäre Kartierung teilen Notunterkünfte und Wasserstellen als Kurzcodes plus Lager- oder Bezirksnamen, und ein deterministischer Kürzer stellt sicher, dass jeder Client —mobiles Offline-Paket, Edge-Worker oder Tabellenimport— denselben Schnitt für dieselbe Referenz erhält.

Entwickler, die OLC in Formulare einbinden, können in einem Aufruf validieren und kürzen, ohne eine vollständige open-location-code-Bibliothek an jeden Client zu liefern. Fehlgeschlagene Validierung wird nicht berechnet.

SMS- und Etikettenfreigabe in einer bekannten Stadt

Wandeln Sie einen gespeicherten vollständigen Plus Code in einen Kurzcode neben einem Stadt- oder Nachbarschaftsnamen um, damit Fahrer und Kunden die kompakte Form sehen, die sie bereits in Karten-Apps nutzen.

Offline- und humanitäre Kartierungspakete

Erzeugen Sie offline dieselben Kurzcodes für Unterkünfte und Versorgungspunkte mit einem Lager-Referenz-Lat/Lon, damit jedes Gerät später denselben nächsten Vollcode wiederherstellt.

Wie kürze ich einen Plus Code mit einem Referenzort?

Senden Sie einen vollständigen Open Location Code in code sowie endliche Referenzbreite und -länge.

Kann ich einen Kurzcode oder einen aufgefüllten Bereichscode kürzen?

Nein. Die Eingabe muss ein gültiger Vollcode ohne Füllnullen sein.

Wie nah muss der Bezugspunkt liegen?

Nah am Mittelpunkt der Codezelle. Führende Paare entfallen nur, solange der Abstand, gemessen als größere der Breiten- und Längendifferenzen, unter dreißig Prozent der Zellgröße dieses Paares bleibt. Das ist ein Sicherheitsabstand für Ihre spätere Wiederherstellung.

Warum wurde mein Plus Code nicht gekürzt?

Weil der Bezugspunkt zu weit vom Ort des Codes entfernt ist, um etwas sicher wegzulassen. Dann erhalten Sie den vollständigen Code unverändert zurück, und das Ergebnis zeigt, dass kein Zeichen entfernt wurde.

Sollte ich dem Kurzcode einen Ortsnamen hinzufügen?

Ja. Ein Kurzcode funktioniert nur zusammen mit der Stadt oder dem Viertel, für das er gekürzt wurde, teilen Sie ihn also mit diesem Namen. Das Werkzeug sucht oder erfindet keine Ortsnamen, die Ortsangabe ergänzen Sie selbst.

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.

POSThttps://api.kit.forhosting.com/geo/plus-code-shorten

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

curl -X POST https://api.kit.forhosting.com/geo/plus-code-shorten \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"8FVC9G8F+6X","latitude":47.5,"longitude":8.5}'
{
  "code": "8FVC9G8F+6X",
  "latitude": 47.5,
  "longitude": 8.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.plus_code_shorten",
  "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.

pro Anfrage$0.002

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

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Das Ergebnis ist ein kompakter Kurzcode, der sich mit einem Ortsnamen kombinieren lässt; die API meldet außerdem, ob gekürzt wurde, wie viele Zeichen entfielen und welcher Winkelbereich galt. Ungültige Vollcodes, aufgefüllte Bereichscodes und fehlende Koordinaten scheitern mit klaren invalid_input-Fehlern, statt ein mehrdeutiges Fragment zu erfinden.

Eingabevertrag, Antwortform und Fehlerverhalten

Senden Sie per POST einen JSON-Körper mit drei Pflichtfeldern: code, eine Zeichenkette mit dem vollständigen Open Location Code wie eight F V C nine G eight F plus six X; latitude, eine endliche Referenzbreite in signierten Dezimalgraden; und longitude, eine endliche Referenzlänge in signierten Dezimalgraden. Aliase werden der Bequemlichkeit wegen akzeptiert: plus_code, olc, full_code oder location_code für den Code; lat, ref_latitude oder reference_latitude für die Breite; lon, lng, ref_longitude oder reference_longitude für die Länge. Der Code wird getrimmt und in Großbuchstaben gesetzt; Kurzcodes (Trenner vor Position acht) und Zeichenketten, die die Gültigkeitsregeln des Open Location Code verfehlen, werden mit invalid_input unter Nennung des Feldes abgelehnt. Bei Erfolg liefert der Körper den normalisierten Vollcode und bereinigte Koordinaten, short_code (der dem Vollcode entsprechen kann, wenn kein sicherer Schnitt möglich ist), was_shortened als Boolesch, characters_removed als nicht negative Ganzzahl, code_length als Anzahl signifikanter Ziffern der Eingabe, short_length als die der Kurzform, range_degrees als den für stabile Goldens gerundeten Tschebyscheff-Bereich und method gleich olc_shorten.

Wo ein Plus-Code-Kürzer seinen Nutzen beweist

Weil die Implementierung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz. Halten Sie Anfragen klein, pinnen Sie short_code und characters_removed in Tests, und Sie erhalten reproduzierbare kurze Plus Codes für Etiketten, Chatbots und Edge-Worker, ohne eine eigene Geokodierungsinfrastruktur aufzubauen.

Außendienst und Letzte-Meile-Zustellung

Kürzen Sie türgenaue OLC-Codes relativ zum Schwerpunkt eines Depots oder einer Zone, bevor Sie Arbeitsaufträge drucken — ohne externe Karten-API.

Was passiert, wenn die Referenz weit vom Code entfernt ist?

Es werden keine führenden Paare entfernt. short_code entspricht dem Vollcode, was_shortened ist false und characters_removed ist null, damit Sie niemals ein mehrdeutiges Fragment versenden.

Fügt die API nach dem Kurzcode einen Städtenamen hinzu?

Nein. Sie schneidet nur führende OLC-Zeichen. Hängen Sie selbst eine Ortsbezeichnung (Stadt, Bezirk oder Lager) an, wenn Sie den Kurzcode anzeigen oder senden.

Was kostet der Plus-Code-Kürzer?

Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen das vorausbezahlte KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →