Geo Calculation

Der Adapter konvertiert Linienzüge oder Polygone, deren Wegpunkte in den Formaten GeoDecimal, GeoE5, GooglePoint, GoogleLine, PtvLine oder PtvPoint angeben werden, in die Formate GeoDecimal, GeoE5, GooglePoint oder GoogleLine, berechnet die Länge von Linienzügen (Routenlänge) und die Kantenlängen von Polygonen, ermittelt (Kanten-) Schnittpunkte zwischen Linienzügen/Polygonen (für Gebietsgrenzberechnungen) und ermittelt Begrenzungsrahmen für ein oder mehrere Polygone/Linienzüge (z.B. zur Bestimmung eines Kartenausschnitts).

Es können für eine Linie, die ein Polygon schneidet, die darin liegenden und außerhalb liegenden Liniensegmente bestimmt werden (z.B. zur Unterscheidung von Fahrten innerhalb und außerhalb eines Gebiets). Zudem lassen sich Linienzüge/Polygone vereinfachen, sodass für eine Kartendarstellung überflüssige Wegpunkte entfernt werden.

Einschränkungen

Bei Polygon-Berechnungen, die über mehr als die Hälfte einer Erdhalbkugel gehen (mehr als 180°), können ggf. unvorhergesehene Ergebnisse auftreten. Liniensegmente dürfen nicht mehr als 170° umfassen. Falls Sie derartige Operationen durchführen möchten, kontaktieren Sie zunächst den SoftProject-Support über support@softproject.de.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Funktions-Adapter durchführt

Mögliche Werte:

LineConversion: Linienzüge oder Polygone, deren Wegpunkte in den Formaten GeoDecimal, GeoE5, GooglePoint, GoogleLine, PtvLine oder PtvPoint angeben werden, in die Formate GeoDecimal, GeoE5, GooglePoint oder GoogleLine konvertieren
LineLength: Länge von Linienzügen oder die gesamte Kantenlänge von Polygonen in Kilometern berechnen
LineIntersection: (Kanten-)Schnittpunkte zwischen Polygonen oder Linienzügen ermitteln
BoundingBox: Begrenzungsrahmen (kleinstmögliches Rechteck nach Mercator-Zylinder-Projektion in der Ebene) für Polygone oder Linienzüge ermitteln und jeweils mit Breiten-/Höhengrad der Eckpunkte ausgeben
SegmentLineByPolygon: Für einen Linienzug, der ein Polygon schneidet, die darin liegenden und außerhalb liegenden Liniensegmente bestimmen
LineSimplificationPercent: Linienzüge/Polygone vereinfachen, sodass für eine Kartendarstellung überflüssige Wegpunkte proportional zur Gesamtstrecke entfernt werden
LineSimplificationKilometer: Linienzüge/Polygone vereinfachen, sodass für eine Kartendarstellung überflüssige Wegpunkte entfernt werden

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter. geo.calc.GeoCalculationsAdapter: Hauptklasse (Standard)
outputFormat	Geodatenformat, in dem das Ergebnis ausgegeben wird Mögliche Werte: `GeoDecimal`: Geodezimal kodierte Koordinaten mit Breitengrad und Längengrad (Latitude/Longitude) (z.B. `48.952/8.391`) `GeoE5`: Geo E5-kodierte Koordinaten mit Breitengrad und Längengrad (Latitude/Longitude) (z.B. `4895176/839096`) `GooglePoint`: GooglePoint-kodierte Koordinaten (z. B. `o{wiHozer@`) `GoogleLine`: GoogleLine-kodierter Linienzug, bestehend aus GooglePoint-Wegpunkten (z.B. `o{wiHozer@or@ow@_yF?`)
percent	Nur für Operation LineSimplificationPercent: Breite des Korridors, innerhalb dessen der Linienzug vereinfacht werden soll, relativ zur Gesamtstreckenlänge in Prozent geteilt durch 100 Mögliche Werte: Beliebige Zahl zwischen 0 und 1 mit Punkt als Dezimaltrennzeichen (z.B. `0.5`) `0.01`: Innerhalb eines 1 Prozent breiten Korridors alle zusätzlichen Wegpunkte entfernen (Standard)
kilometer	Nur für Operation `LineSimplificationKilometer`: Breite des Korridors, innerhalb dessen der Linienzug vereinfacht werden soll, in Kilometern Mögliche Werte: Beliebige positive Zahl oder 0 mit Punkt als Dezimaltrennzeichen (z.B. `0.5`) `0.01`: Innerhalb eines 10 Meter breiten Korridors alle zusätzlichen Wegpunkte entfernen (Standard)

Statuswerte

1 (successful)

Die Adapter-Operation wurde erfolgreich ausgeführt

0 (empty)

Bei Operation LineIntersection: die Zahl der Linienzüge ist nicht 2

Bei Operation SegmentLineByPolygon: der Input enthält kein Element Polygon, Polyline oder es fehlen beide Elemente, oder es liegt ein Fehler in der Geometrie vor (Polygon mit weniger als drei Punkte, Polyline mit weniger als zwei Punkten)

-1 (failed)

Der Adapter-Input ist kein wohlgeformtes XML-Dokument

Input

Allgemein werden für diesen Adapter Geodaten für Punkte und Linien im Input-XML-Dokument einheitlich notiert. Geodezimal kodierte Koordinaten werden dabei wie folgt angegeben:

HTML/XML

<GeoDecimal>
   <Latitude><!--Breitengrad im Format NN.NNNNN--></Latitude>
   <Longitude><!--Längengrad im Format EE.EEEEE--></Longitude>
</GeoDecimal>

Geo E5-kodierte Koordinaten werden stets als ganzzahlige Werte (geodezimal kodierter Koordinatenwert mit 100.000 multipliziert) angegeben:

HTML/XML

<GeoE5>
   <Latitude><!--Breitengrad im Format NNNNNNN--></Latitude>
   <Longitude><!--Längengrad im Format EEEEEEE--></Longitude>
</GeoE5>

Google Point-kodierte Koordinaten werden wie folgt angegeben:

HTML/XML

<GooglePoint><!--GooglePoint-Code--></GooglePoint>

Google Line-kodierte Linienzüge werden wie folgt definiert:

HTML/XML

<GoogleLine><!--GoogleLine-Code--></GoogleLine>

PTV Point-kodierte Koordinaten (in PTV-Mercator-Projektion) werden wie folgt angegeben:

HTML/XML

<PtvPoint>
   <X><!--"Easting" als Zahl ggf. mit Komma--></X>
   <Y><!--"Northing" als Zahl ggf. mit Komma--></Y>
</PtvPoint>

PTV Line-kodierte Linienzüge (in PTV-Mercator-Projektion) werden wie folgt angegeben. Dabei werden 1–n Wertepaare, bestehend aus "Easting" und "Northing" aneinandergefügt, sodass eine stets gerade Anzahl an Werten hinterlegt sind. Jeder Wert wird durch ein Komma getrennt.

HTML/XML

<PtvLine><!--Easting1,Northing1,Easting..,Northing...--></PtvLine>