ForHosting KIT · Entwickler-Tools

Punktsichtbarkeit über ein Geländeprofil prüfen

Der Punktsichtbarkeitstest ermittelt, ob ein Ziel von einem Beobachtungspunkt entlang eines vorgegebenen Geländeprofils sichtbar ist.

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

Dazu wird eine Gerade zwischen den Höhen von Beobachter und Ziel einschließlich ihrer jeweiligen Höhe über dem Boden gezogen. Anschließend wird jeder dazwischenliegende Geländemesspunkt mit dieser Geraden verglichen. Das Ergebnis nennt die Sichtbarkeit des Ziels, bestimmt den Punkt mit dem geringsten vertikalen Abstand und gibt dort den vorzeichenbehafteten Abstand an. Dadurch bleibt die Berechnung für Vermessung, Funkplanung, Standortprüfung und kartengestützte Geländeanalysen nachvollziehbar und wiederholbar.

Bereiten Sie ein geordnetes Geländeprofil vor

Geben Sie die Geländemesspunkte in der Reihenfolge vom Beobachter zum Ziel an. Der erste Abstand muss null sein, jeder folgende Abstand muss größer als der vorherige sein und der letzte Messpunkt stellt den Zielort dar. Abstände und Höhen können in Metern, Fuß oder einer anderen Längeneinheit angegeben werden. Sämtliche Werte müssen jedoch dieselbe Einheit verwenden, da sie unmittelbar miteinander verglichen werden. Ergänzen Sie die Beobachter- und Zielhöhe als Abstand über der jeweiligen Geländehöhe. Die Beobachterhöhe kann der Augenhöhe, dem Mittelpunkt einer Antenne oder einem Instrument auf einem Stativ entsprechen. Die Zielhöhe kann eine Person, einen Mast oder ein Bauwerk darstellen oder null betragen, wenn die Sichtbarkeit des Bodenpunkts selbst geprüft werden soll. Fügen Sie nach Möglichkeit Messpunkte an Geländeknicken und örtlichen Hochpunkten ein. Der Test kann ausschließlich das gelieferte Profil bewerten; ein Geländerücken zwischen weit auseinanderliegenden Messpunkten wird weder erfunden noch abgeleitet. Damit fließen sowohl das Geländemodell als auch die Grenzen seiner Abtastung in das Ergebnis ein.

Verstehen Sie die Prüfung der geraden Sichtlinie

Zunächst addiert die Berechnung die Beobachterhöhe zur Geländehöhe am Abstand null und die Zielhöhe zur Geländehöhe am letzten Abstand. Diese beiden absoluten Höhen legen eine Gerade fest. Für jeden dazwischenliegenden Messpunkt liefert eine lineare Interpolation die Höhe dieser Geraden am jeweiligen Abstand. Von der Sichtlinienhöhe wird anschließend die Geländehöhe abgezogen, um den vertikalen Abstand zu erhalten. Ein positiver Wert bedeutet, dass die Linie über dem erfassten Boden verläuft. Null bedeutet eine Berührung, während ein negativer Wert zeigt, dass der Messpunkt über die Linie hinausragt und die Sicht versperrt. Das Ziel gilt nur dann als sichtbar, wenn alle dazwischenliegenden Abstände mindestens null sind. Die Ausgabe enthält außerdem den kritischen Punkt, also den Messpunkt mit dem kleinsten Abstand, sowie dessen Entfernung, Geländehöhe, Sichtlinienhöhe und Abstand. Dieser vorzeichenbehaftete Wert bietet mehr als eine Ja-Nein-Antwort: Er zeigt die am kritischen Ort benötigte Zusatzhöhe oder verdeutlicht, wie knapp die vorhandene Reserve ist.

Deuten Sie das Ergebnis innerhalb der Modellgrenzen

Betrachten Sie das Ergebnis als Punkt-zu-Punkt-Prüfung über das gelieferte Profil und nicht als vollständiges geografisches Sichtfeldraster. Bewertet wird ausschließlich der gerade Vertikalschnitt zwischen zwei Orten. Erdkrümmung und atmosphärische Refraktion werden nicht berücksichtigt; lange Verbindungen können daher eine gesonderte Analyse mit gekrümmter Erde oder effektivem Erdradius erfordern. Gebäude, Bäume, Fahrzeuge, jahreszeitliches Blätterdach und andere Oberflächenobjekte fehlen, sofern deren Höhen nicht bereits in den gelieferten Geländehöhen enthalten sind. Die Berechnung interpoliert auch keine durchgehende Geländeoberfläche zwischen den Messpunkten. Eine dichtere Abtastung um Geländerücken liefert im Allgemeinen eine verlässlichere Aussage. Ein sichtbares Ergebnis mit sehr kleinem positivem Abstand reagiert daher empfindlich auf Höhenfehler und ausgelassene Hindernisse, während eine große positive Reserve robuster ist. Ein negativer Mindestabstand weist in den gelieferten Daten auf ein eindeutiges Hindernis hin; der kritische Punkt unterstützt eine gezielte Ortsprüfung oder Planungsänderung. Dieselbe deterministische Eingabe erzeugt stets dieselbe Ausgabe und eignet sich deshalb für dokumentierte Prüfabläufe und automatisierte Vergleiche.

Funkverbindung vorprüfen

Prüfen Sie vor einer ausführlichen Ausbreitungsstudie, ob das erfasste Gelände die direkte Linie zwischen zwei Antennenhöhen schneidet.

Vermessungsprofil kontrollieren

Testen Sie die Sicht auf Augen- oder Instrumentenhöhe zwischen Messstationen und ermitteln Sie die Station mit dem kleinsten Abstand.

Standorte vergleichen

Führen Sie einheitliche Punkt-zu-Punkt-Geländetests für mehrere Beobachterpositionen durch und bewahren Sie die Abstandsdaten je Ergebnis auf.

Was bedeutet sichtbar?

Kein dazwischenliegender Geländemesspunkt ragt über die Gerade zwischen Beobachter- und Zielhöhe hinaus. Gelände, das die Linie genau berührt, gilt als sichtbar.

Müssen Abstände und Höhen in Metern angegeben werden?

Nein. Jede Längeneinheit ist geeignet, sofern alle Abstände, Höhen sowie Beobachter- und Zielhöhen dieselbe Einheit verwenden.

Berücksichtigt der Test Erdkrümmung oder Refraktion?

Nein. Er verwendet ein gerades Profil in einem ebenen Vertikalschnitt. Korrigieren Sie die Eingangshöhen vorher, wenn diese Effekte relevant sind.

Werden Bäume und Gebäude berücksichtigt?

Nur wenn deren Höhen bereits in den gelieferten Profilhöhen enthalten sind. Oberflächenobjekte werden nicht automatisch ergänzt.

Was ist der kritische Punkt?

Das ist der geprüfte Messpunkt mit dem geringsten Sichtlinienabstand. Ein negativer Wert kennzeichnet das stärkste erfasste Hindernis.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung kann als Tier-A-Funktion im Browser ausgeführt werden.

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/viewshed-point-test

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/viewshed-point-test \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"terrain_profile":[{"distance":0,"elevation":100},{"distance":500,"elevation":112},{"distance":1000,"elevation":108}]}'
{
  "terrain_profile": [
    {
      "distance": 0,
      "elevation": 100
    },
    {
      "distance": 500,
      "elevation": 112
    },
    {
      "distance": 1000,
      "elevation": 108
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.viewshed_point_test",
  "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_points10000
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 →