# Module road-sign

Package com.here.mom.feature.road-sign

Features

Parts

Enums

## Category

enum Category

Represents different categories of Road Sign. Enumeration of Category:

Value Description
UNDEFINED Category of road sign is not defined.
UNKNOWN Category of road sign is not known.
REGULATING Regulatory and priority signs indicate the order in which vehicles should pass intersection points.
WARNING General warning signs are used in instances in which the particular hazard, obstacle or condition is not covered by

a standard sign.
INFORMING Informing signs are used to guide road users along routes, inform them about destination and distance, also provide

other information that will make road travel easier and safe.

## DetectedBoundingBox

part DetectedBoundingBox

Represents the 2D coordinates of detected text/icon with respect to image width and height.

Property Type Modifier Description
leftCoordinate double The left coordinate of the bounding box as a fraction of overall image width.
topCoordinate double The top coordinate of the bounding box as a fraction of overall image height.
widthRatio double The width of the bounding box as a fraction of the overall image width.
heightRatio double The height of the bounding box as a fraction of the overall image height.

## RelatedSignInfo

part RelatedSignInfo

This object represents related signs/supplemental info detected as separate sign.

Property Type Modifier Description
objectId string ObjectId holds the common value for related signs. If two signs are related,

both of them need to have same value in objectId.

Road Signs are representations of textual and graphic information posted along roadways. Signs provide travellers with route guidance information.

Property Type Modifier Description
id string
bbox BoundingBox optional
geometry Point Sign geometry defines the position of the center of the sign, and the center is the center of the rectangle

which encloses the sign.
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. One

example 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.
pointDefined non-empty(.referencePoint) Ensure that the reference-point is defined.

Road Sign Properties represents different attributes of road signs. e.g. sign type, speed sign, warning sign, weight sign, etc.

Property Type Modifier Description
@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, so

if data needs to be JSON schema validated by clients before 2.6 this property must be

set 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 be

agreed 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 features

that are not participating in Quality Index.
category Category optional Represents different categories of Road Sign.

Types of Categories are Warning, Regulatory, Informing.
signType SignType Sign Type identifies the type of Road Sign.

Types of Signs are Crossing Sign, Animal Crossing, Tourism Sign, etc.
signUnit SignUnit optional Sign Unit represents small set of units corresponding to speed, weight and length.
signValue string optional Sign Value represents information present on signboards located at the decision point. A decision point will be

any intersection where the driver can follow instructions present on the signboard, e.g. right or left turn, etc.
installDate integer list Deprecated. Represents the installation date of sign.
validityPeriods TimeConstraint list Validity Time indicates additional sign shields that appear below the traffic sign indicating a specific

time(s) at which the traffic sign is applicable.
supplementalTextInfo SupplementalTextInfo list Text information on/around the sign board.
supplementalIconInfo SupplementalIconInfo list Icons on/around the sign board.
relatedSignInfo RelatedSignInfo list RelatedSignInfo is used when the producer of sign is unable to identify between independent sign and

supplemental info.

If the relationship is known use the supplementalTextInfo/supplementalIconInfo else create two signs similar

relatedSignInfo.
heightCm CentimeterEstimate optional Height of the bounding box around the sign.
widthCm CentimeterEstimate optional Width of the bounding box around the sign.
shapeEstimate SignShape optional Shape of sign's face.

The shape attribute defines the physical shape of the metal placard or the electronic panel that contains

the sign content.

Examples: Diamond, Round, Octogon, Square, etc.
orientation OrientationEstimate optional Represennts the orientation of the sign face. This is rotation of sign

FLU(Forward, left, up) coordinate frame to the ENU(East, North, Up)

coordinate frame at the location of the sign point geometry.

The FLU coordinate frame of the sign is defined by

the forward being the normal vector to the sign face, up being defined by

the characters/figures on the sign being properly oriented, and left

being the cross product of up and forward. In the case that the up vector

isn't known use the vector perpendicular to the normal vector and closest

to the ENU up vector.
colorEstimate SignColor optional Defines the dominant background color of the sign.

Examples: Red, White, Yellow, etc.
vehicleHeading integer optional Defines the NED heading of the aggregated drive path that most frequently observes a sign.

The value is in degrees. NORTH = 0, EAST = 90, SOUTH = 180 and WEST = 270
gfrGroupName string optional The ground feature repository (GFR) group name for a sign.

Finer version of the sign type, which helps to derive sign shape and sign color.

The GFR group names are maintained by a HERE specific service.

The group names are more dynamic than an enumeration.

relativeAltitudeCm integer optional Altitude of the sign relative to the feature it was referenced from or it is referencing to.

The default altitude from sea level in geometry is not suitable for all use cases

e.g. for indoor maps, where car may not get GPS altitude but has to work on local sensors only.

Relative altitude gives altitude of the center of the sign in centimeters from surface of

indoor map level (floor) or outdoor road.

## SignColor

enum SignColor

Sign color values. The color attribute defines the dominant background color of the sign. Enumeration of SignColor:

Value Description
UNDEFINED Sign Color is not defined.
UNKNOWN Sign Color is not known.
OTHER This value has been deprecated as it is not a part of valid sign colors as per sign color PRD

WHITE White signs are used for most regulatory signs and some route markers. Example: Special speed limit sign, legal

speed limit sign, etc.
RED Red signs offer a warning of some kind, similar to the warning a triangular sign gives. Examples: Stop sign, Yield

Sign, No entry sign, etc.
GREEN Green signs are to give information for exit the main road, such as the split point of a turn lane, exit ramp, etc.

Also, provides bicycle, and school warning signs.
BLUE Blue signs give you some kind of instruction, whether it’s to do with changing your speed or making you choose a

junction on a motorway. Examples: One way sign, Turn left or right sign, No stopping sign, etc.
YELLOW Yellow traffic signs are usually warning signs that stand for slowing down, driving with caution, or a general

warning.
BLACK Black signs are used for one way, night speed limit, and truck regulatory signs.
BROWN Brown signs are information signs related to points of recreational or cultural interest. Example: Tourist sign.
ORANGE Orange signs are used for temporary traffic control signs. Example: Construction sign.

## SignShape

enum SignShape

CROSS value has been removed. Clients are requested to use CROSSBUCK instead of CROSS. The shape attribute defines the physical shape of the metal placard or the electronic panel that contains the sign content. Enumeration of SignShape:

Value Description
UNDEFINED Sign Shape is not defined.
UNKNOWN Sign Shape is not known.
OTHER Sign Shape is other than rectangle, round, triangle, diamond, octagon, square, hexagon, pentagon.
RECTANGLE Rectangle-shaped signs give you some kind of information about what’s ahead. This could be an upcoming junction,

a tourist attraction, services or diverted traffic. Examples: Lane merge, One way sign, etc.
ROUND Round-shaped signs are used to give orders; usually something that you must or must not do. Examples: No overtaking

sign, no entry sign, etc.
TRIANGLE_TIP_UP Triangle-shaped signs warn drivers about upcoming hazards or a change in the traffic flow. Examples: Environmental

Awareness and Situation Awareness sign i.e. animal crossing, icy conditions, etc.
TRIANGLE_TIP_DOWN Triangle-shaped signs warn drivers about upcoming hazards or a change in the traffic flow. Example: Yield sign.
TRIANGLE_TIP_SIDE Triangle-shaped signs warn drivers about upcoming hazards or a change in the traffic flow. Example: No passing zone.
DIAMOND Diamond-shaped traffic signs warn drivers of upcoming road conditions and hazards. Examples: Advisory Speed Limit,

Start/End of Priority sign, Falling Rocks sign, etc.
CROSSBUCK A crossbuck sign is a regulatory sign, which indicates there is a railroad crossing.
OCTAGON Octagon-shaped signs are used for Stop signs.
SQUARE This value has been deprecated as it is not a part of valid sign shapes as per sign shape PRD

(https://confluence.in.here.com/display/Features/.Sign+Shape+v1.0)
HEXAGON This value has been deprecated as it is not a part of valid sign shapes as per sign shape PRD

(https://confluence.in.here.com/display/Features/.Sign+Shape+v1.0)
PENTAGON Pentagon-shaped signs are used for school advance warning signs.

## SignUnit

enum SignUnit

Represents small set of units corresponding to speed, weight and length. Enumeration of SignUnit:

Value Description
UNDEFINED Sign Unit is not defined.
UNKNOWN Sign Unit is not known.
KMH The speed limit sign unit indicates the speed of a vehicle in kilometers per hour.
MPH The speed limit sign unit indicates the speed of a vehicle in miles per hour.
TONS Represents vehicle weight limit in tons allowed on a specific road.
POUNDS Represents vehicle weight limit in pounds allowed on a specific road.
METER Represents vehicle height or length limit in meters allowed on a specific road.
FEET Represents vehicle height or length limit in feet allowed on a specific road.
PERCENT Represents a unit of traffic sign value, which gives a percentage indication for slope.

## SupplementalIconInfo

part SupplementalIconInfo

Icons on/around the sign board. Examples: Crossing Sign, Animal Crossing, Tourism Sign, etc.

Property Type Modifier Description
icon SignType Sign Type identifies the type of Road Sign.

Types of Signs are Crossing Sign, Animal Crossing, Tourism Sign, etc.
detectionBox DetectedBoundingBox optional Coordinates of the detection with respect to 2D image width and height.

## SupplementalTextInfo

part SupplementalTextInfo