segments
Types
Attributes which describe the combined transport properties of the segment in detail.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
name | String | yes | - | 2.0 | The name of the combined transport in the selected language. Usually the connection has an ID. In rare cases combined transports without ID could exist. In such cases the field is missing. |
type | CombinedTransportType | yes | - | 2.0 | The type of combined transport. If this information is missing in the digital map the field UnspecifiedMapDataLimitation is generated and the field is set to BOAT (see CombinedTransportType). |
Contains the features of a Feature Layer theme valid for the segment in question.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
themeId | ThemeId (String) | yes | - | 2.3 | The ID of the Feature Layer theme to which this feature belongs to. |
attributes | KeyValuePair[] | 0..* | - | 2.3 | The list of attributes of a segment. For each attribute its type (key) and value is provided via key-value pairs. See the documentation of the layer-specific attributes for more information on the type and the range of available attributes. |
Legal and physical attributes which describe the road segment in detail.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
prohibited | boolean | yes | - | 2.0 | This segment is usually prohibited for the selected vehicle. |
toll | boolean | yes | - | 2.0 | The segment is part of a toll road. This attribute does not reflect the specific toll pricing conditions, so it is not guaranteed that the selected vehicle has to pay toll for this segment. |
urban | boolean | yes | - | 2.0 | The segment is within an urban, i.e. built-up area. It can be avoided or prohibited during route calculation using the parameter SpecialAreas.urbanPenalty. |
residentsOnly | boolean | yes | - | 2.0 | The segment is within a residents only area. It can be avoided, or prohibited during route calculation using the parameters SpecialAreas.residentsOnlyPenalty. |
pedestrianZone | boolean | yes | - | 2.0 | The segment is within a pedestrian zone. To open, avoid, or block it during route calculation see attribute prohibited. |
oneWay | boolean | yes | - | 2.0 | The segment is a one-way street. |
roundabout | boolean | yes | - | 2.0 | The segment is part of a roundabout. |
ramp | boolean | yes | - | 2.0 | The segment is part of a ramp. It can be avoided or prohibited during route calculation using the parameter Network.rampPenalty. |
bridge | boolean | yes | - | 2.0 | The segment is a bridge. |
tunnel | boolean | yes | - | 2.0 | The segment is a tunnel. |
deliveryOnly | boolean | yes | - | 2.0 | The segment is in a delivery only area. It can be allowed, avoided, or prohibited during route calculation using the parameters SpecialAreas.deliveryOnlyPenalty and LegalCondition.isDelivery. |
allowedForEmergency | boolean | yes | - | 2.0 | The segment is allowed for emergency vehicles (see LegalCondition.isEmergency). |
lowEmissionZoneType | String | no | - | 2.0 | The low-emission zone types the selected vehicle must have to travel this segment. It can be opened, avoided, or prohibited during route calculation using the parameters SpecialAreas.forbiddenLowEmissionZonePenalty and Engine.lowEmissionZoneTypes. The available types can be requested through the xRuntime service, e.g. DE_GREEN, DE_YELLOW, DE_RED for Germany. |
The attributes of the underlying segments.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
descriptors | SegmentDescriptors | no | - | 2.0 | Attributes which basically describe the segment such as road name and number. |
roadAttributes | RoadAttributes | no | - | 2.0 | Legal and physical attributes of the segment such as toll, one-way, or tunnels. |
features | Feature[] | 0..* | - | 2.3 | The features of all enabled Feature Layer themes related to this segment, if requested by SegmentResultFields.featureThemeIds. |
Attributes which basically describe the segment such as road name and number.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
country | CountryCode (String) | yes | - | 2.0 | The country the segment is located in. |
roadName | String | no | - | 2.0 | The name of the road in the selected language. It remains empty, if it is not available in the data. |
roadNumber | String | no | - | 2.0 | The road number. The string may consist of several number entries divided by "/". It remains empty, if it is not available in the data. |
networkClass | NetworkClass (int) | yes | - | 2.0 | The network class of the segment. |
Enumeration
CombinedTransportType
used by CombinedTransportAttributes, CombinedTransportEvent, ManeuverEvent
since 2.0
The type of the combined transport segment, i.e. how the vehicle is transported.
Enumeration Value | Since | Description |
---|---|---|
BOAT | 2.0 | The combined transport is by boat, i.e. by a ferry. Transport by boat can be avoided or prohibited during route calculation using the parameter CombinedTransport.boatPenalty. |
RAIL | 2.0 | The combined transport is by rail, i.e. on a train. Transport by rail can be avoided or prohibited during route calculation using the parameter CombinedTransport.railPenalty. |
The direction of the segment.
The type of a segment.
Enumeration Value | Since | Description |
---|---|---|
NETWORK_SEGMENT | 2.0 | This segment is a network segment. |
LINK_SEGMENT | 2.0 | This segment is a virtual one, but not a network segment. It links the input coordinate to the routing network and does not have SegmentAttributes. |
COMBINED_TRANSPORT | 2.0 | This segment is a combined transport, i.e. the vehicle is carried by some other vehicle such as a boat or a train. The CombinedTransportAttributes are available only for segments of this type. |
NOT_DRIVING | 2.0 | This segment is a virtual one which denotes that the vehicle is not driving. Thus, the segment has distance and travelSpeed 0 and does not have a polyline nor SegmentAttributes.
|