ForHosting KIT · Entwickler-Tools

Näherung einer konkaven Hülle aus Koordinaten

Eine konvexe Hülle ist nützlich, umschließt eine Punktmenge jedoch häufig zu großzügig.

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

Diese Näherung einer konkaven Hülle beginnt mit dieser verlässlichen Außengrenze und verfeinert lange Kanten mit bislang ungenutzten inneren Punkten, bis der gewünschte Schwellenwert erreicht ist oder keine gültige Einfügung mehr möglich ist. Das deterministische Ergebnis enthält die geordnete Grenze, Kantenlängen, Umfang, Fläche sowie die Anzahl der nicht verkürzbaren Kanten. So können Sie die Näherung prüfen, statt sie irrtümlich als exakte geometrische Lösung zu verstehen.

Wählen Sie Koordinaten und Schwellenwert sinnvoll

Geben Sie mindestens drei ebene Punkte als numerische x- und y-Koordinaten sowie einen positiven Schwellenwert für die Kantenlänge an. Die Koordinaten können projizierte Kartenpositionen, Zeichnungseinheiten, Messwerte oder ein anderes zweidimensionales kartesisches System darstellen. Sie müssen denselben Maßstab verwenden: Mischen Sie keine Längengrade mit Entfernungen in Metern, wenn der Schwellenwert eine physikalische Bedeutung behalten soll. Ein kleinerer Wert fordert den Algorithmus auf, den verfügbaren Punkten genauer zu folgen, während ein größerer Wert mehr von der konvexen Kontur erhält. Der Schwellenwert ist ein Ziel und keine Garantie, da eine dünn besetzte Punktmenge möglicherweise keinen sicheren inneren Punkt zum Teilen einer bestimmten Kante enthält. Doppelte Koordinaten werden ignoriert. Es müssen mindestens drei eindeutige, nicht kollineare Punkte verbleiben, weil eine Gerade kein Polygon bilden kann. Projizieren Sie Breiten- und Längengrade angemessen, bevor Sie einen als Entfernung angegebenen Schwellenwert verwenden. Das Werkzeug rechnet in der Ebene und verwendet kein kugel- oder ellipsoidförmiges Erdmodell. Beginnen Sie mit einem Wert nahe dem Abstand, den Sie als bedeutsame Lücke ansehen, und vergleichen Sie anschließend die zurückgegebene Grenze mit den ursprünglichen Punkten.

So funktioniert die Verfeinerung der Grenze

Der Algorithmus berechnet zunächst mit dem Monotone-Chain-Verfahren eine deterministische konvexe Hülle. Danach untersucht er alle Grenzkanten oberhalb des angegebenen Schwellenwerts, beginnend mit der längsten. Für jede Kante sucht er ungenutzte Punkte, die innerhalb des aktuellen Polygons liegen und die Kante durch zwei kürzere Abschnitte ersetzen können, ohne einen anderen Grenzabschnitt zu schneiden. Gewählt wird der Kandidat, dessen längerer Ersatzabschnitt am kürzesten ist. Bei Gleichstand entscheiden stabil die Gesamtlänge und anschließend die ursprüngliche Eingabereihenfolge. Nach einer Einfügung beginnt die Auswahl erneut, da sich das Polygon verändert hat. Die Verfeinerung endet, sobald alle Kanten das Ziel erfüllen oder kein verbleibender Punkt eine lange Kante sicher verbessern kann. Diese Konstruktion bevorzugt ein vorhersehbares, nachvollziehbares Ergebnis und behauptet nicht, sämtliche konkurrierenden Definitionen einer exakten konkaven Hülle zu lösen. Sie erfindet keine Eckpunkte, verschiebt keine Koordinaten, nutzt keine Zufallsstichprobe und ruft keinen entfernten Dienst auf. Die zurückgegebene Hülle ist eine offene, geordnete Liste von Eckpunkten; der letzte Punkt ist mit dem ersten verbunden. Die Kantenlängen folgen derselben zyklischen Reihenfolge.

Prüfen Sie die Grenzen vor der weiteren Nutzung

Beachten Sie unresolved_long_edges immer dann, wenn der Schwellenwert betrieblich wichtig ist. Der Wert null bedeutet, dass jede zurückgegebene Kante das Ziel erfüllt. Ein positiver Wert zeigt, dass die vorhandene Punktgeometrie den Wert nicht erreichen konnte, ohne eine Kreuzung, eine Bewegung nach außen oder einen Ersatz zu erzeugen, der die Kante nicht verkürzt. Das ist eine nützliche Angabe und kein verborgener Fehler. Die Näherung kann außerdem von Alpha-Shapes, Hüllen auf Grundlage nächster Nachbarn, Triangulationsfiltern oder speziellen Küstenlinienverfahren abweichen. Vergleichen Sie Methoden, wenn die Topologie rechtliche, wissenschaftliche oder sicherheitsbezogene Folgen hat. Fläche und Umfang gehören zum zurückgegebenen ebenen Polygon und verwenden das von Ihnen gelieferte Koordinatensystem; sie sind keine geodätischen Messungen. Zeichnen Sie die geordnete Hülle über den Quellpunkten, um zu prüfen, ob der Wert die gewünschten Gruppen und Einbuchtungen erfasst. Bleibt die Grenze zu weit, ergänzen Sie repräsentative Punkte oder senken Sie den Schwellenwert; wird sie zu detailliert, erhöhen Sie ihn. Die Fähigkeit akzeptiert höchstens 500 Elemente, damit wiederholte Schnittprüfungen begrenzt und sowohl im Browser als auch bei deterministischer API-Automatisierung praktikabel bleiben.

Ein beprobtes Gebiet umreißen

Erstellen Sie eine prüfbare Grenze um projizierte Vermessungs- oder Sensorpunkte und erhalten Sie sichtbare Einbuchtungen.

Eine Kartenvorschau vorbereiten

Wandeln Sie eine mäßig große Punktsammlung vor einem spezialisierten GIS-Ablauf in ein geordnetes Polygon um.

Die Grenzempfindlichkeit vergleichen

Testen Sie mehrere Schwellenwerte und vergleichen Sie Fläche, Umfang, eingefügte Eckpunkte und offene Kanten.

Ist dies eine exakte konkave Hülle?

Nein. Es gibt mehrere Definitionen; dieses Verfahren verfeinert lange konvexe Kanten deterministisch mit sicheren inneren Punkten.

Was kostet die Ausführung?

Jede API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung kann auch im Browser laufen.

Liegen am Ende alle Kanten unter dem Schwellenwert?

Nicht zwingend. Das Feld unresolved_long_edges meldet Kanten, die mit den verfügbaren Punkten nicht sicher verkürzt werden konnten.

Kann ich Breiten- und Längengrade direkt verwenden?

Die Berechnung läuft, doch Entfernungen und Flächen bleiben ebene Winkelwerte. Projizieren Sie die Daten, wenn physikalische Einheiten wichtig sind.

Wird der erste Hüllenpunkt am Ende wiederholt?

Nein. Die Hülle ist eine offene, geordnete Liste; der letzte Punkt gilt als mit dem ersten verbunden.

Wie werden doppelte oder kollineare Punkte behandelt?

Exakt doppelte Koordinaten werden ignoriert. Eine vollständig kollineare eindeutige Menge wird abgelehnt, da sie kein Polygon definiert.

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/concave-hull-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/concave-hull-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[{"x":0,"y":0},{"x":4,"y":0},{"x":4,"y":4},{"x":2,"y":1},{"x":0,"y":4}],"threshold":3}'
{
  "points": [
    {
      "x": 0,
      "y": 0
    },
    {
      "x": 4,
      "y": 0
    },
    {
      "x": 4,
      "y": 4
    },
    {
      "x": 2,
      "y": 1
    },
    {
      "x": 0,
      "y": 4
    }
  ],
  "threshold": 3
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.concave_hull_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.

max_items500
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 →