Module lane-group
Package com.here.mom.feature.lane.lane-group
Features
Parts
Enums
LaneBoundary
part LaneBoundary
Module lane-group
Property | Type | Modifier | Description |
laneBoundaryId | integer | | Lane boundary identifier within a lane group. |
geometry | LineString | | Geometry for this lane boundary.All geometries are 3-dimensional. |
parallelElements | LaneBoundaryParallelElement | list | Array of lane boundary elements, ordered left to right according to the lane marking geometry orientation. |
laneBoundaryAttributes | LaneBoundaryAttributes | optional | Contains lane boundary attributes. |
confidence | ConfidenceData | optional | Confidence values for the lane-boundary |
Constraint | Expression | Description |
parallelElementsNonEmpty | non-empty(.parallelElements) |
LaneBoundaryAttributes
part LaneBoundaryAttributes
Module lane-group
Attributes of lane boundary object.
Property | Type | Modifier | Description |
adjacentLaneGroups | ParametricLaneGroupReference | list | An attribute array representing reference to adjacent lane group along range of LaneBoundary.geometry. |
laneBoundaryTraversal | ParametricLaneBoundaryTraversal | list | An attribute array representing boundary traversal along range of LaneBoundary.geometry. |
roadBoundaryType | ParametricRoadBoundaryType | list | An array representing road boundary type along range of LaneBoundary.geometry when applicable.This is applicable when the lane boundary is also the road boundary.The road boundary type comes from the road boundary used to derive the lane group itself.The parametric ranges should not overlap and are in order. Gaps are acceptable. |
centerDivider | LaneBoundaryRange | list | An attribute array representing center dividers along range of LaneBoundary.geometry.Center Divider indicates that a given range of lane boundary lies between opposing travel directions. |
LaneBoundaryParallelElement
part LaneBoundaryParallelElement
Module lane-group
Constraint | Expression | Description |
sequentialElementsNonEmpty | non-empty(.sequentialElements) |
LaneBoundaryRange
part LaneBoundaryRange
Module lane-group
Subtypes ParametricLaneBoundaryTraversal, ParametricLaneGroupReference, ParametricRoadBoundaryType
Defines the common attribution for all range based boundary attributes.
Property | Type | Modifier | Description |
boundaryRange | LinearRange | | Boundary range is relative to LaneBoundary.geometry. |
LaneBoundarySequentialElement
part LaneBoundarySequentialElement
Module lane-group
Property | Type | Modifier | Description |
range | LinearRange | | Linear range against lane boundary geometry. |
stripeDetail | StripeDetail | | Stripe details boundary element. |
laneBoundaryTraversal | LaneBoundaryTraversal | optional | Deprecated. Lane Boundary Traversal describes whether traffic is legally restricted tomove laterally into a legally available adjacent lane, in either or both directions.New location is LaneBoundary.laneBoundaryAttributes.laneBoundaryTraversal |
LaneBoundaryTraversal
enum LaneBoundaryTraversal
Module lane-group
Lane Boundary Traversal attributes.
- Undefined: Lane Boundary Traversal is not defined.
- Left: Traffic can change lanes to the left only.
- Right: Traffic can change lanes to the right only.
- Both: Traffic can change lanes to the left or right.
- None: Traffic cannot change lanes.
Value | Description |
UNDEFINED | |
LEFT | |
RIGHT | |
BOTH | |
NONE |
LaneGroup
feature LaneGroup extends MomFeature
Module lane-group
A LaneGroup is self contained, meaning that lanes and boundaries have been cut so that consumers don't have to perform those operations which require cross domain lookups. All geometries are 3-dimensional.
Property | Type | Modifier | Description |
momType | "lane.LaneGroup" | | |
id | string | | |
bbox | BoundingBox | optional | |
geometry | Polygon | | A polygon that represents the lane group boundary geometry, created using the left and right lane groupboundaries. |
properties | LaneGroupProperties | | |
referencePoint | Point | optional | This is the location of this feature, collapsed to a single point.This is for any application where an approximate, but deterministic and consistent, location is useful. Oneexample is deciding where to "anchor" a feature within a tiled map database.Any Reference to this feature should include this point. |
nonSpatialPartitionKey | string | optional | The partition id for a generically partitioned feature.Generically partitioned features fall into two categories:1. Features that have a spatial component but may not make sense to partition based on that geometry.2. Features that don't have a strong spatial component.How keys will be assigned and what value ranges will be used are not specified.Examples of generically partitioned features are admin, zone, postal, phonetics, metadata, etc. |
Constraint | Expression | Description |
atMostOneDefinedProperty | (is-empty(.referencePoint) | | is-empty(.nonSpatialPartitionKey)) | At most one of non-spatial-partition-key and reference-point can be defined. |
LaneGroupLane
part LaneGroupLane
Module lane-group
A lane that is part of a lane group. Contains a reference to the original MOM Lane objects this was generated from.
Property | Type | Modifier | Description |
drivePathGeometry | LineString | | Drive path geometry, useful for map-matching. |
lengthInCm | integer | | Length of the drive path geometry rounded to the nearest centimeter.Computed in ECEF (Earth-centered, Earth-fixed) after converting from WGS84 (The World Geodetic System 1984)coordinates. |
leftLaneBoundaryId | integer | | References the left-side lane boundary from the parent lane group, relative to the parent lane groupdigitization direction. |
rightLaneBoundaryId | integer | | References the right-side lane boundary from the parent lane group, relative to the parent lane groupdigitization direction. |
directionOfTravel | DirectionOfTravel | | Relative to the lane group digitization direction.Direction of Travel indicates the direction of traffic flow on a navigable lane. |
isTransitioning | boolean | optional | Deprecated. Transition status was moved into LaneParametericAttributes object.Identifies if the lane is in transition? |
startLaneConnectorId | integer | | Lane connector identifier at the start of this lane.This identifier is locally-unique within a lane group connector.Lane extremities that share the same lane connector id while their corresponding lane group extremitiesshare the same lane group connector id are connected to each other. |
endLaneConnectorId | integer | | Lane connector identifier at the end of this lane.This identifier is locally-unique within a lane group connector.Lane extremities that share the same lane connector id while their corresponding lane group extremitiesshare the same lane group connector id are connected to each other. |
roadReferences | RoadReference | list | Road reference mappings for this lane.The drive path is used as reference geometry for a lane.Note: Leave this field empty when it is equal to the road references for the lane group. |
sourceLaneSegments | LaneSegment | list | A back reference to the original lane segments that were used to create this lane.Oriented in the lane group digitization direction and sorted from lane start to end.Needed for change detection. |
laneParametericAttributes | LaneParametericAttributes (Deprecated) | optional | Deprecated. Old deprecated attributes, replaced by shared lane-attributes field.Writer must still populate it until removed, but a reader must also check for the same content.Same data populated in this structure must be identical as data in lane-attributes. |
laneAttributes | LaneAttributes | optional | Parametric attributes of this lane group lane. |
Constraint | Expression | Description |
sourceLaneSegmentsNonEmpty | non-empty(.sourceLaneSegments) | |
someAttributesDefined | (non-empty(.laneParametericAttributes) | | non-empty(.laneAttributes)) |
LaneGroupProperties
part LaneGroupProperties extends Common
Module lane-group
Property | Type | Modifier | Description |
@ns:com:here:mom:meta | Metadata | optional | |
@ns:com:here:mom:rmob | string | optional | Currently not specified - may be specified by each Feature individually in future |
featureType | FeatureType | optional | Deprecated. This property is redundant to MomFeature.momType and should not be used.MOM clients before 2.6 release had this deprecated property set to required, soif data needs to be JSON schema validated by clients before 2.6 this property must beset by the writer. |
isoCountryCode | Country | optional | Deprecated. This indicates which country a Feature is in, with a couple caveats.- It may be unknown ("NONE" is a valid value, in addition to "UNDEFINED" like all MOM enums) simply because the writer has not tried to figure it out or has otherwise not had the means to do so.- It may be outright incorrect or a simplification of reality, specifically when a Feature is close to a country border or in a disputed area (e.g., two or more countries claim the same area).In all cases, writers and readers of this data should understand that the semantics of this property must beagreed upon (if it is used at all). The preferred method of relating a Feature to a Country is through a(direct or transitive) Reference from the Feature to an Admin. |
@ns:com:here:mom:delta | Branch | optional | |
@ns:com:here:mom:mapcreator | MapCreator | optional | |
@ns:com:here:xyz | Xyz | optional | Generic Data Hub namespace |
extensionOSM | MomOsm | optional | Optional extension for OSM (Open Street Map) metadata,in case the object came from OSM |
@ns:com:here:groundTruth | GroundTruth | optional | Ground truth namespace |
confidence | ConfidenceData | optional | Confidence of a feature, optional only for the featuresthat are not participating in Quality Index. |
referenceGeometry | LineString | | Reference geometry for the lane group, which represents a generalized path useful for map matching, withgeneralized curvature and slope. |
leftBoundaryGeometry | LineString | | Left side of the bounding geometry for the lane group (in the lane group digitization direction).This is usually specified by the outermost left lane boundary.Together with the right boundary geometry, this forms a polygon for the lane group. |
rightBoundaryGeometry | LineString | | Right side of the bounding geometry for the lane group (in the lane group digitization direction).This is usually specified by the outermost right lane boundary.Together with the left boundary geometry, this forms a polygon for the lane group. |
lengthInCm | integer | | Length of the reference geometry rounded to the nearest centimeter.Computed in ECEF (Earth-centered, Earth-fixed) after converting from WGS84 (The World Geodetic System 1984)coordinates. |
lanes | LaneGroupLane | list | Lanes in this lane group ordered left to right relative to the lane group digitization direction. |
laneBoundaries | LaneBoundary | list | Lane boundaries used by the lanes in this lane group. The boundaries are sorted left to right |
roadReferences | RoadReference | list | Road reference mappings for this lane group. |
incomingLaneGroups | LaneGroup | list | References to other lane groups that are connected to the start of this lane group. |
outgoingLaneGroups | LaneGroup | list | References to other lane groups that are connected to the end of this lane group. |
startLaneGroupConnectorId | long | | Lane group connector id at the start of this lane group (in the digitization direction).Lane groups that share the same lane group connector id are connected.Incoming lane groups will share the same lane group connector id, either at their start or end depending onrelative orientation.Note: lane group connector ids are globally unique. |
endLaneGroupConnectorId | long | | Lane group connector id (globally unique) at the end of this lane group (in the digitization direction).Lane groups that share the same lane group connector id are connected.Outgoing lane groups will share the same lane group connector id, either at their start or end depending onrelative orientation.Note: lane group connector ids are globally unique. |
Constraint | Expression | Description |
lanesNonEmpty | non-empty(.lanes) | |
laneBoundariesMinSize2 | (size(.laneBoundaries) >= 2) | |
roadReferencesNonEmpty | non-empty(.roadReferences) |
LaneParametericAttributes (Deprecated)
part LaneParametericAttributes (Deprecated)
Module lane-group
A lane group lane parametric attributes. All attributes from this property are part of new lane-attribute property, attribute names are slightly different. Attributes are parametrized along LaneGroupLane.DrivePathGeometry
Property | Type | Modifier | Description |
laneWidthProfile | LaneWidthProfile | | Deprecated. A width profile of this lane group lane. |
parametricLaneType | LaneTypeInfo | list | Deprecated. Array of parametric lane type attribute for this lane group lane.Deprecated, new location is inside extended schema lane-attributes.lane-types |
parametricTransitionStatus | ParametricTransitionStatus (Deprecated) | list | Deprecated. An attribute array representing parametric transition status along lane group lane.Deprecated, new location is inside extended schema lane-attributes.transitions |
parametricSpeedLimit | SpeedLimitInfo | list | Deprecated. An attribute array representing parametric lane speed limit information along lane group lane.Deprecated, new location is inside extended schema lane-attributes.speed-limits |
parametricAccessCharacteristics | LaneAccessCharacteristicInfo | list | Deprecated. An attribute array representing parametric lane access characteristic information along lane group lane.Deprecated, new location is inside extended schema lane-attributes.lane-accesses |
parametricStoppingLocation | PointAttributeInfo | list | Deprecated. An attribute array representing Stopping location positions as parametric lane points along lane group lane.Deprecated, new location is inside extended schema lane-attributes.stop-locations |
LaneSegment
part LaneSegment
Module lane-group
Property | Type | Modifier | Description |
lane | Lane | | Reference to MOM Lane. |
range | LinearRange | | The linear range on the referenced lane. |
ParametricLaneBoundaryTraversal
part ParametricLaneBoundaryTraversal extends LaneBoundaryRange
Module lane-group
Attribute representing boundary traversal along parametric range of LaneBoundary.geometry.
Property | Type | Modifier | Description |
boundaryRange | LinearRange | | Boundary range is relative to LaneBoundary.geometry. |
laneBoundaryTraversal | LaneBoundaryTraversal | | This attribute of the Lane Boundary describes whether traffic is legally restricted tomove laterally into a legally available adjacent lane, in either or both directions.This attribute is only required when the adjacent lane is available for use:it indicates if this is a location where a lateral lane change is not allowed.For example, an HOV lane may be adjacent to a general traffic lane.At some locations, boundary markings indicate that lane change is prohibited;at other locations, boundary markings indicate that lane change is allowed.Lane Traversal is not used to indicate that the adjacent lane is unavailable for use;that would be indicated by attributes on the adjacent lane, such as travel direction or access characteristics. |
ParametricLaneGroupReference
part ParametricLaneGroupReference extends LaneBoundaryRange
Module lane-group
Parametric attribute along LaneBoundary.geometry pointing to a lane group object.
Property | Type | Modifier | Description |
boundaryRange | LinearRange | | Boundary range is relative to LaneBoundary.geometry. |
laneGroupRef | LaneGroup | | Mom reference to lane group. |
ParametricRoadBoundaryType
part ParametricRoadBoundaryType extends LaneBoundaryRange
Module lane-group
Parametric Road Boundary Type along LaneBoundary.geometry pointing to a Road Boundary type when applicable.
Property | Type | Modifier | Description |
boundaryRange | LinearRange | | Boundary range is relative to LaneBoundary.geometry. |
roadBoundaryType | RoadBoundaryType | | Road Boundary Type of the parent boundary if applicable |
ParametricTransitionStatus (Deprecated)
part ParametricTransitionStatus (Deprecated) extends AttributeInfo
Module lane-group
Parametric attribute for transition status extending AtttributeInfo with LinearRange.
Property | Type | Modifier | Description |
laneRange | LinearRange | | Linear Range restricts the applicability of an attribute to the range between startOffset and endOffset ofa feature.Lane Range defines the start and end offset of a lane within which it restricts the applicability of an attribute. |
confidence | ConfidenceData | optional | Confidence values for an attribute |
transitionStatus | TransitionType | | Represents the topology change due to a lane splitting into multiple lanes, multiple lanes merging togetherinto one lane, or no transitioning present. |
RoadReference
part RoadReference
Module lane-group
Property | Type | Modifier | Description |
sourceRange | LinearRange | | Linear range against the reference geometry of referenced entity (lane or lane group). |
roadTopologySegmentRef | Road | optional | Reference to a road link. This attribute was mandatory to till Mom 2.7.For backward compatibility this attribute has to be set for the consumers that are based on earlier than 2.7 Mom. |
roadTopologySegmentRange | LinearRange | optional | Linear range on a road link. |
topologySegmentRef | Topology | optional | Reference to a topology segment. |
topologySegmentRange | LinearRange | optional | Linear range on a topology segment. |