Within the GeoJSON "properties", the Marketplace Object Model can be logically categorized into the following sections:
Metadata – such as timestamps, type, and version information (mandatory).
Feature-specific payload - such as road segment properties (mandatory).
System-specific extensions – such as extended Carto properties (optional).
Figure 1. Marketplace Object Model feature structure
All features that are part of the Markeplace Object Model can, in theory, reference any other feature in order to ensure maximum flexibility. Only when relations are essential for the feature definition are the references specifically spelled out.
References may be represented:
In "short notation" (Layer name + feature Type + ID).
As "fully qualified" with uri for the layer.
In their "resolved form", as in with the referenced object embedded in the parent object.
The "resolved form" representation enables the design principle that every object will be de-normalized and self-contained as much as possible.
Common metadata
Independent from the payload specific to each feature type, a set of properties carrying metadata is common to all objects found within the HERE Map Layers collection of catalogs.
General
Attribute
Value
Description
id
Object identifier.
box
An optional bounding box.
geometry
The object geometry. This may be null for non-spatial features.
Type
"Feature"
Clients may be able to handle the type "FeatureCollection,” but this is out of scope of the objects.
category specifies a generic "free text" subcategory description for the feature. To be used for display only.
featureType, such as Place, Roadsegment, and Building.
isoCountryCode identifies the ISO-3166 Alpha-3 code of the country. This is included for all countries. For more information about ISO-3166 Alpha-3 codes, refer to the International Organization for Standardization.