ForHosting KIT · Entwickler-Tools

H3-Hex-Index angenähert: Koordinaten einer Zelle zuordnen

Dieses Werkzeug für angenäherte H3-Hex-Indizes ordnet einer Breiten- und Längenkoordinate eine stabile Zelle in einem globalen, spitz ausgerichteten Sechseckraster zu.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Wählen Sie eine Auflösung von 0 bis 15, um von großen Regionen zu immer feineren Zellen zu wechseln. Das Ergebnis enthält eine lesbare Zellkennung, axiale Rasterkoordinaten, einen geschätzten Mittelpunkt und eine angenäherte Kantenlänge. Es eignet sich für leichtgewichtige Gruppierung, Aufteilung, Zwischenspeicherung und Demonstrationen, bei denen deterministische Hex-Zellen wichtiger als die exakte Kompatibilität mit dem offiziellen H3-System sind.

Wählen Sie eine passende Auflösung für Ihre Gruppierung

Die Auflösung bestimmt den Maßstab des Rasters. Auflösung 0 erzeugt sehr große Zellen; jede höhere Stufe halbiert die Kante in Winkeleinheiten. Dadurch ist die Abstufung vorhersehbar: Nahe Punkte, die auf einer Stufe getrennt sind, können auf einer gröberen Stufe dieselbe Zelle teilen, während eine höhere Auflösung detailliertere Gruppen bildet. Beginnen Sie für Zusammenfassungen über große Regionen mit einer niedrigen Auflösung und erhöhen Sie sie für Gruppierungen auf Stadtteilebene oder dichte Darstellungen. Die ausgegebene angenäherte Kantenlänge bietet einen praktischen Größenhinweis, ist jedoch keine geodätische Zusicherung. Da das Raster eine einfache equirektanguläre Projektion verwendet, werden Ost-West-Entfernungen am Boden zu den Polen hin kleiner, obwohl die Winkelgeometrie regelmäßig bleibt. Prüfen Sie typische Koordinaten aus dem tatsächlich zu untersuchenden Gebiet, statt die Stufe nur nach der Kantenschätzung zu wählen. Speichern Sie vor allem die Auflösung mit jedem Index: Zellen verschiedener Auflösungen stellen nicht dieselbe Fläche dar.

Verstehen Sie die Bildung des angenäherten Index

Der Algorithmus legt den Längengrad auf eine horizontale und den Breitengrad auf eine vertikale Achse, überlagert ein spitz ausgerichtetes Sechseckgitter, wandelt den Punkt in gebrochene axiale Koordinaten um und rundet diese über Würfelkoordinaten. Diese Rundung erhält die Beziehung zwischen den drei Achsen eines Hex-Rasters und weist jeder gültigen Eingabe genau eine deterministische Zelle zu. Die Kennung enthält das Präfix ah3, die gewählte Auflösung sowie vorzeichenbehaftete Base-36-Codes für q und r. Dieselbe Eingabe ergibt deshalb ohne Netzwerk, gespeicherten Zustand, Zufall oder zeitabhängige Daten stets dieselbe Ausgabe. Der ausgegebene Mittelpunkt entsteht durch die Rückwandlung der gerundeten axialen Position in Breiten- und Längengrad; er hilft bei Beschriftung, Fehlersuche und repräsentativen Markierungen. An Zellgrenzen kann eine sehr kleine Koordinatenänderung eine Nachbarzelle auswählen, wie bei jedem räumlichen Index. Verwenden Sie die volle Genauigkeit der Quelldaten, wenn Wiederholbarkeit an Grenzen wichtig ist.

Erkennen Sie, wann das offizielle H3 erforderlich ist

Diese Fähigkeit bildet bewusst den Arbeitsablauf von H3 nach, beansprucht aber keine binäre, textuelle, geometrische oder hierarchische Kompatibilität mit H3-Indizes. Das kompakte analytische Raster liefert reproduzierbare räumliche Gruppen, wenn Sie keine spezielle Geodatenbibliothek laden möchten. Es eignet sich zum Gruppieren von Beispielorten, Aufteilen von Cache-Schlüsseln, Erstellen grober Dichtezählungen, Vermitteln axialer Hex-Koordinaten und Anlegen stabiler Testdaten. Das Feld compatible_with_h3 ist immer false, damit nachgelagerter Code das Ergebnis nicht unbemerkt für eine offizielle H3-Adresse hält. Verwenden Sie die offizielle H3-Bibliothek, wenn Sie Indizes austauschen, echte Eltern und Kinder durchlaufen, kanonische Zellgrenzen erhalten, Fünfecke behandeln oder das ikosaedrische Erdmodell von H3 nutzen müssen. Diese Näherung arbeitet mit ebener Breite und Länge: Zellflächen am Boden verzerren sich mit der Breite und schließen über den Antimeridian nicht aneinander an. Nutzen Sie sie als deterministisches Gruppierungssystem, nicht als Ersatz für geodätische Analysen.

Kartenereignisse gruppieren

Ordnen Sie eingehende Koordinaten stabilen räumlichen Gruppen zu, bevor Sie Ereignisse zählen oder zusammenfassen.

Ortsbezogene Cache-Schlüssel bilden

Verwenden Sie die deterministische Zellkennung in Cache-Schlüsseln für näherungsweise ortsbezogene Ergebnisse.

Eine Hex-Karte prototypisch entwickeln

Erproben Sie Auflösungen und axiale Koordinaten, bevor Sie eine vollständige Geodatenbibliothek einsetzen.

Ist die ausgegebene Zelle ein gültiger H3-Index?

Nein. Sie ist eine unabhängig definierte Näherungskennung und ausdrücklich als nicht mit H3 kompatibel markiert.

Was bedeutet die Auflösung?

Sie legt die Rasterfeinheit von 0 bis 15 fest. Jede Erhöhung halbiert die Winkelkante und erzeugt feinere Gruppen.

Warum ändert sich die Zellgröße am Boden?

Die Berechnung nutzt eine equirektanguläre Ebene; derselbe Längengradbereich deckt daher zu den Polen hin weniger Boden ab.

Ist das Ergebnis deterministisch?

Ja. Gleiche Werte für Breite, Länge und Auflösung erzeugen immer dasselbe Ergebnis.

Was kostet eine Anfrage?

Eine API-Anfrage kostet $0.002. Die Browserversion führt dieselbe reine Berechnung lokal aus.

Kann ich den Mittelpunkt als exakten geografischen Schwerpunkt nutzen?

Nein. Er ist der ebene Mittelpunkt der angenäherten Zelle und nur als repräsentative Koordinate gedacht.

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/h3-cell-approx

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/h3-cell-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":37.7749,"lon":-122.4194}'
{
  "lat": 37.7749,
  "lon": -122.4194
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.h3_cell_approx",
  "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.

Vollständige KIT-Dokumentation lesen →