Operation: SegmentLineByPolygon

With the operation SegmentLineByPolygon the line segments inside or outside of a polygon that is intersected by a polyline can be calculated.

Input

For the operation SegmentLineByPolygon the adapter expects the same input XML structure as for the operation LineConversion, where you define one polygon within the element Polygon and one polyline within the element Polyline. Additional attributes will not be taken over to the output XML document.

Output

For the operation SegmentLineByPolygon an XML document will be output, where the elements OriginalPolygon and OriginalPolyline contain the points of the original polygon and the polyline in the selected output format, as well as its (edge) length in kilometers within the attribute length.

Within the element FinalPolygon and FinalPolyline the corrected points of the polygon and the polyline will be output in the selected output format. In addition, the polygon's and polyline's (edge) length will be output in kilometers within the attribute length.

Within the element Inside for each line segment that is located inside a polygon, an element Part will be output that contains all points. Depending on the selected output format, the points will be output in a child element GeoDecimal, GeoE5 or GooglePoint. In addition, within each attribute length, the length of the line segments inside will be output in kilometers.

Within the element Outside, for each line segment that is located outside of the polygon an element Part will be output that contains all points.Depending on the selected output format, the points will be output in a child element GeoDecimal, GeoE5, GooglePoint or as GoogleLine. In addition, within each attribute length, the length of the line segments outside will be output in kilometers.

Within the element Edge, lines will be output that are located exactly on the intersection line.

<Result>
   <OriginalPolyline length="Length of the original polyline in kilometers">
      <!-- 0-n points/lines -->
      <Point/Line format><!--Point/Line definition--></Point/Line format>
   </OriginalPolyline>
   <OriginalPolygon length="Edge length of the original polygon in kilometers">
      <!-- 0-n points/lines -->
      <Point/Line format><!--Point/Line definition--></Point/Line format>
   </OriginalPolygon>
   <FinalPolyline length="Length of the corrected polyline in kilometers">
      <!-- 0-n points/lines -->
      <Point/Line format><!--Point/Line definition--></Point/Line format>
   </FinalPolyline>
   <FinalPolygon length="Edge length of the corrected polygons in kilometers">
      <!-- 0-n points/lines -->
      <Point/Line format><!--Point/Line definition--></Point/Line format>
   </FinalPolygon>
   <Inside>
      <!-- 0-n line segments-->
      <Part length="Length of the inside polyline in kilometers">
         <!-- 1-n points/lines -->
         <Point/Line format><!--Point/Line definition--></Point/Line format>
      </Part>
   </Inside>
   <Outside>
      <!-- 0-n line segments-->
      <Part length="Length of the outside polyline in kilometers">
         <!-- 1-n points/lines -->
         <Point/Line format><!--Point/Line definition--></Point/Line format>
      </Part>
   </Outside>
   <Edge>
      <!-- 0-n line segments-->
      <Part length="Length of the line segment lying exactly on the line in kilometers">
         <!-- 1-n points/lines -->
         <Point/Line format><!--Point/Line definition--></Point/Line format>
      </Part>
   </Edge>
</Result>