xml-geodesic-string
This is a composite builder that constructs a line geometry. The coordinates of the line are interpolated from geodesic control points that are specified via the data-string parameter or via point geometries.
This geometry builder requires the coordinate-system parameter to be set.
builder type: composite: accepts point geometries
geometry constructed: line geometry
data parameters:
|
Data Name |
Value |
Required/Optional |
|---|---|---|
|
addition-rate |
Scales the number of interpolation points directly relative to the maximum calculated by the selected logarithmic and exponential interpolation methods. Range: 0.01 to 1.0 Default: 0.1 Higher values (for example, 1.0) add the maximum number of points calculated by the interpolation method for the distance; lower values (for example, 0.01) reduce the number of points proportionally, adding fewer points for the same distance. Note Applicable only to the logarithmic and exponential interpolation methods.
|
Optional |
|
axis-order |
Indicates the axis order for a coordinate. Range: A permutation of the numbers 1..N, where N is the number of dimensions. Each number is separated by a comma “,”. Default: “1,2,...,N” |
Optional |
|
axis-separator |
The string separating each axis of a coordinate in the data-string. Range: String | “whitespace” this includes the tab, newline, and space characters. Default: “,” |
Optional |
|
coord-separator |
The string separating each coordinate in the data-string. Range: String Default: “whitespace” this includes the tab, newline, and space characters. |
Optional |
|
coordinate-system |
Specifies the coordinate system name. Range: String |
Required |
|
data-string |
The string containing the coordinate data. Range: String |
Optional |
|
decimal |
The string representing the decimal point for each real number in the data-string. Range: String Default: “.” |
Optional |
|
dimension |
The dimension of the coordinates. Range: String representing a positive integer, or the “implicit” literal, which forces the Default: When not specified the dimension will be automatically determined. |
Optional |
|
distance-threshold |
Specifies the minimum distance, in kilometers, beyond which interpolation starts; no interpolation points are added if the distance between control points is less or equal to the threshold. Range: A positive, real number. Default: 20 |
Optional |
|
enable-interpolation |
Specifies whether control points should be interpolated along geodesic curves. The number of interpolation points is determined by the selected interpolation-method, and their exact locations are calculated using the selected interpolation-formula. Range: true | false Default: true |
Optional |
|
geodesic-distance-trait |
Specifies the trait name to store the line segment’s geodesic distance. Range: String |
Optional |
|
interpolated-segment-trait |
Specifies the trait name to store the boolean value indicating whether the line segment has interpolated points. Range: String |
|
|
interpolation-formula |
Specifies the formula used to calculate the position of interpolation points along a geodesic. This setting determines the mathematical approach for determining point locations based on the underlying Earth model. The formulas are:
Range: ellipsoidal | spherical Default: spherical |
|
|
interpolation-formula-trait |
Specifies the trait name to store the interpolation formula (ellipsoidal or spherical) used. Range: String |
|
|
interpolation-method |
Specifies how the number of interpolation points are calculated between geodesic control points. The methods are:
Range: logarithmic | exponential | fixed-distance Default: logarithmic |
Optional |
|
interval-distance |
Specifies the fixed distance, in kilometers, between interpolation points for the fixed-distance interpolation method, setting the interval at which points are added along the geodesic. Range: Any positive, real number. Default: 0.5*T, where T is the distance-threshold. Note Applicable only to the fixed-distance interpolation method.
|
Optional |
|
label |
Specifies the geometry’s label. Range: String |
Optional |
|
reduction-factor |
This parameter determines how the number of interpolation points decreases as the distance between geodesic control points increases in the logarithmic and exponential interpolation methods. Valid Range: > 0 to 100 Default: 1 Higher values decrease the number of points more rapidly, resulting in fewer points for longer distances; lower values decrease the number of points more gradually, resulting in relatively more points for longer distances. Note Applicable only to the logarithmic and exponential interpolation methods.
|
Optional |
|
segmented-interpolation |
Splits the interpolation of the geodesic control points into multiple line segments, with each segment starting and ending at control points. This is useful when the data-string contains more than two control points. When set to false, the control points in the data-string are read as a single segment, regardless of the number of positions or interpolations. An interpolated-segment-trait trait may also be added to each line segment to indicate whether the segment contains interpolated points. Range: true | false Default: true |
Optional |