Operation: SegmentLineByPolygon

Mit Operation SegmentLineByPolygon lassen sich für einen Linienzug, der ein Polygon schneidet, die darin liegenden und außerhalb liegenden Liniensegmente bestimmen.

Input

Für Operation SegmentLineByPolygon erwartet der Adapter die gleiche Input-XML-Struktur wie für Operation LineConversion (siehe oben), in der Sie genau ein Polygon in Element Polygon sowie genau einen Linienzug (Polyline) in Element Polyline definieren. Zusätzliche Attribute werden jedoch nicht ins Ausgabe-XML-Dokument übernommen.

Output

Für Operation SegmentLineByPolygon wird ein XML-Dokument ausgegeben, das in den Elementen OriginalPolygon und OriginalPolyline die Punkte des ursprünglichen Polygons und Linienzugs im gewählten Ausgabeformat sowie dessen (Kanten-)Länge in Kilometern in Attribut length enthält.

Innerhalb von Element FinalPolygon und FinalPolyline werden die korrigierten Punkte des Polygons und Linienzugs im gewählten Ausgabeformat sowie die (Kanten-)Länge des Polygons und des Linienzugs in Attribut length in Kilometern ausgegeben.

Innerhalb von Element Inside werden für jedes Liniensegment, das innerhalb des Polygons liegt, in einem Element Part sämtliche Punkte ausgegeben. Je nach gewähltem Ausgabeformat werden dabei die Punktangaben in jeweils einem Kindelement GeoDecimal, GeoE5 oder GooglePoint ausgegeben. Zudem werden in jeweils einem Attribut length die Längen der innenliegenden Liniensegmente in Kilometern ausgegeben.

Innerhalb von Element Outside werden für jedes Liniensegment, das außerhalb des Polygons liegt, in einem Element Part sämtliche Punkte ausgegeben. Je nach gewähltem Ausgabeformat werden dabei die Punktangaben in jeweils einem Kindelement GeoDecimal, GeoE5, GooglePoint oder als GoogleLine ausgegeben. Zudem werden in jeweils einem Attribut length die Längen der außenliegenden Liniensegmente in Kilometern ausgegeben.

Innerhalb von Element Edge werden Linien ausgegeben, die sich exakt auf der Schnittlinie befinden.

<Result>
   <OriginalPolyline length="Länge des ursprünglichen Linienzugs in Kilometern">
      <!-- 0-n Punkte/Linien -->
      <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
   </OriginalPolyline>
   <OriginalPolygon length="Kantenlänge des ursprünglichen Polygons in Kilometern">
      <!-- 0-n Punkte/Linien -->
      <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
   </OriginalPolygon>
   <FinalPolyline length="Länge des korrigierten Linienzugs in Kilometern">
      <!-- 0-n Punkte/Linien -->
      <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
   </FinalPolyline>
   <FinalPolygon length="Kantenlänge des korrigierten Polygons in Kilometern">
      <!-- 0-n Punkte/Linien -->
      <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
   </FinalPolygon>
   <Inside>
      <!-- 0-n Liniensegmente -->
      <Part length="Länge des innenliegenden Linienzugs in Kilometern">
         <!-- 1-n Punkte/Linien -->
         <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
      </Part>
   </Inside>
   <Outside>
      <!-- 0-n Liniensegmente -->
      <Part length="Länge des außenliegenden Linienzugs in Kilometern">
         <!-- 1-n Punkte/Linien -->
         <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
      </Part>
   </Outside>
   <Edge>
      <!-- 0-n Liniensegmente -->
      <Part length="Länge des exakt auf der Linie liegenden Liniensegments in Kilometern">
         <!-- 1-n Punkte/Linien -->
         <Punkt-/Linienformat><!--Punkt-/Liniendefinition--></Punkt-/Linienformat>
      </Part>
   </Edge>
</Result>