Smart Data Models - Transportation / Road Segment


This entity contains a harmonised geographic and contextual description of a road segment. A collection of road segments are used to describe a Road.

Type: object

Type: object

Relationship. Unique identifier of the entity

Type: string

Property. Identifier format of any NGSI entity

Must match regular expression: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$

Must be at least 1 characters long

Must be at most 256 characters long

Type: stringFormat: uri

Property. Identifier format of any NGSI entity

Type: stringFormat: date-time

Property. Entity creation timestamp. This will usually be allocated by the storage platform

Type: stringFormat: date-time

Property. Timestamp of the last modification of the entity. This will usually be allocated by the storage platform

Type: string

Property. A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object

Type: string

Property. The name of this item

Type: string

Property. An alternative name for this item

Type: string

Property. A description of this item

Type: string

Property. A sequence of characters identifying the provider of the harmonised data entity

Type: array

Property. A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s)

Each item of this array must be:

Type: object

Relationship. Unique identifier of the entity

Same definition as id


Property. list of uri pointing to additional resources about the item

Type: array of string

Must contain a minimum of 1 items

Each item of this array must be:

Type: stringFormat: uri
Type: stringFormat: uri
Type: object


GeoProperty. Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon

Type: object

GeoProperty. Geojson reference to the item. Point

Type: enum (of string)

Must be one of:

  • "Point"

Type: array of number

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. LineString

Type: enum (of string)

Must be one of:

  • "LineString"

Type: array of array

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. Polygon

Type: enum (of string)

Must be one of:

  • "Polygon"

Type: array of array

Each item of this array must be:

Type: array of array

Must contain a minimum of 4 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. MultiPoint

Type: enum (of string)

Must be one of:

  • "MultiPoint"

Type: array of array

Each item of this array must be:

Type: array of number

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. MultiLineString

Type: enum (of string)

Must be one of:

  • "MultiLineString"

Type: array of array

Each item of this array must be:

Type: array of array

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. MultiLineString

Type: enum (of string)

Must be one of:

  • "MultiPolygon"

Type: array of array

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

Property. The mailing address. Model:'https://schema.org/address'

Type: string

Property. The street address. Model:'https://schema.org/streetAddress'

Type: string

Property. The locality in which the street address is, and which is in the region. Model:'https://schema.org/addressLocality'

Type: string

Property. The region in which the locality is, and which is in the country. Model:'https://schema.org/addressRegion'

Type: string

Property. The country. For example, Spain. Model:'https://schema.org/addressCountry'

Type: string

Property. The postal code. For example, 24004. Model:'https://schema.org/https://schema.org/postalCode'

Type: string

Property. The post office box number for PO box addresses. For example, 03578. Model:'https://schema.org/postOfficeBoxNumber'

Type: string

Property. Number identifying a specific property on a public street

Type: string

Property. A district is a type of administrative division that, in some countries, is managed by the local government

Type: string

Property. The geographic area where a service or offered item is provided. Model:'https://schema.org/Text'

Type: object

Type: string

Property. The color of the product. Model:'https://schema.org/color'

Type: stringFormat: uri

Property. An image of the item. Model:'https://schema.org/URL'

Type: array of string

Property. Annotations about the item. Model:'https://schema.org/Text'

Each item of this array must be:

Type: object

Type: enum (of string)

Property. NGSI Entity type. It has to be RoadSegment

Must be one of:

  • "RoadSegment"


Relationship. Road to which this road segment belongs to

Type: string

Property. Identifier format of any NGSI entity

Must match regular expression: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$

Must be at least 1 characters long

Must be at most 256 characters long

Type: stringFormat: uri

Property. Identifier format of any NGSI entity

Type: object

GeoProperty. Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon

Type: object

GeoProperty. Geojson reference to the item. Point

Type: enum (of string)

Must be one of:

  • "Point"

Type: array of number

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. LineString

Type: enum (of string)

Must be one of:

  • "LineString"

Type: array of array

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. Polygon

Type: enum (of string)

Must be one of:

  • "Polygon"

Type: array of array

Each item of this array must be:

Type: array of array

Must contain a minimum of 4 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. MultiPoint

Type: enum (of string)

Must be one of:

  • "MultiPoint"

Type: array of array

Each item of this array must be:

Type: array of number

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. MultiLineString

Type: enum (of string)

Must be one of:

  • "MultiLineString"

Type: array of array

Each item of this array must be:

Type: array of array

Must contain a minimum of 2 items

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. MultiLineString

Type: enum (of string)

Must be one of:

  • "MultiPolygon"

Type: array of array

Each item of this array must be:

Type: array of number

Must contain a minimum of 4 items

Each item of this array must be:

Type: object

GeoProperty. Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon

Same definition as startPoint

Type: number

Property. The kilometer number (measured from the road's start point) where this road segment starts. Model:'https://schema.org/Number'.

Value must be greater or equal to 0

Type: number

Property. The kilometer number (measured from the road's start point) where this road segment ends. Model:'https://schema.org/Number'.

Value must be greater or equal to 0

Type: array of enum (of string)

Property. Vehicle type(s) allowed to transit through this road segment. Model:'https://schema.org/Text'. Enum:'agriculturalVehicle, bicycle, bus, car, caravan, carWithCaravan, carWithTrailer, constructionOrMaintenanceVehicle, lorry, moped, motorcycle, motorcycleWithSideCar, motorscooter, tanker, trailer, van, anyVehicle'. Allowed values: The following values defined by VehicleTypeEnum, DATEX 2 version 2.3:

Each item of this array must be:

Type: enum (of string)

Must be one of:

  • "agriculturalVehicle"
  • "bicycle"
  • "bus"
  • "car"
  • "caravan"
  • "carWithCaravan"
  • "carWithTrailer"
  • "constructionOrMaintenanceVehicle"
  • "lorry"
  • "moped"
  • "motorcycle"
  • "motorcycleWithSideCar"
  • "motorscooter"
  • "tanker"
  • "trailer"
  • "van"
  • "anyVehicle"

Type: number

Property. Total number of lanes offered by this road segment. Model:'https://schema.org/Number'

Value must be greater or equal to 1

Type: number

Property. Total length of this road segment in kilometers. Model:'https://schema.org/length'. Units:'Kilometer (Km)'

Value must be greater or equal to 0

Type: number

Property. Maximum allowed speed plying the road segment. More restrictive limits might be applied to specific vehicle types (trucks, caravans, etc.). Model:'https://schema.org/Number'. Units:'Kilometer per hour (Km/h)'

Value must be greater or equal to 0

Type: number

Property. Minimum allowed speed while transiting this road segment. Model:'https://schema.org/Number'. Units:'Kilometer per hour (Km/h)'

Value must be greater or equal to 0

Type: number

Property. Maximum allowed height for vehicles transiting this road segment. Model:'https://schema.org/Number'. Units:'Meter (m)'. Model:'https://schema.org/height'

Value must be greater or equal to 0

Type: number

Property. Maximum allowed weight for vehicles transiting this road segment. Model:'https://schema.org/Number'. Units:'Kilogram (Kg)'. Model:'https://schema.org/weight'

Value must be greater or equal to 0

Type: number

Property. Road's segment width.. Model:'https://schema.org/Number'. Units:'Meter (m)'

Value must be greater or equal to 0

Type: array of enum (of string)

Property. This attribute can be used to convey specific parameters describing each lane. Model:'https://schema.org/Text'. It must contain a string per road segment lane. The element 0 of the array must contain the information of lane 1, and so on. Format of the referred string must be: , , , , . is a text string with the following allowed values: forward. The lane is currently used in the forwards direction. backward. The lane is currently used in the backwards direction. The only mandatory parameter is lane_direction. If not specified, the rest of parameters can be assumed to be equal to those specified at entity level

Each item of this array must be:

Type: enum (of string)

Must be one of:

  • "forward"
  • "backward"

Type: array of enum (of string)

Property. Allows to convey extra characteristics of a road segment. Model:'https://schema.org/Text'. Enum:'oneway, toll, link'. oneway: Flags whether the road segment can only be used in one direction. If not present it means road segment can be used in both directions (forwards and backwards). See also http://wiki.openstreetmap.org/wiki/Key:oneway. toll : Flags whether the road segment is under toll fees. link : Flags whether this road segment is an auxiliary link segment for exiting or entering a road. See https://wiki.openstreetmap.org/wiki/Tag:highway%3Dmotorway_link. Any other value meaningful to an application

Each item of this array must be:

Type: enum (of string)

Must be one of:

  • "oneway"
  • "toll"
  • "link"

Type: string

Property. Specific driving conditions on the roadsegment. Use statusDescription for additional information. Enum: ‘open, closed, limited’. open: the roadsegment can be used in full intended capacity, closed: no traffic is possible, e.g. due to roadworks, an open bridge or lock, or any other event preventing traffic. limited: traffic is possible, but not in the full capacity

Type: string

Property. Additional information to the status attribute


Relationship. URI pointing to the data-descriptor entity

Type: string

Property. Identifier format of any NGSI entity

Must match regular expression: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$

Must be at least 1 characters long

Must be at most 256 characters long

Type: stringFormat: uri

Property. Identifier format of any NGSI entity

Type: string

Property. Construction material used for laying the cycle path on the sides of the road corresponding to this observation

Type: number

Property. Total length of the carriage way of the road segment corresponding to this observation

Type: number

Property. Number of bridges in the road segment corresponding to this observation. Takes 0 (zero) as the value when the road segment has no bridges

Type: number

Property. Height of the walkway placed on the left edge of the road corresponding to this observation

Type: number

Property. Total length of the walkway present in the road corresponding to this observation

Type: number

Property. Total width of the walkway present in the road corresponding to this observation

Type: number

Property. Number of culverts prevalent in the trace of the road corresponding to this observation

Type: string

Property. The name of the road corresponding to this observation

Type: enum (of string)

Property. The type of road corresponding to this observation. Enum: [OTHERPUBLICROAD, PRIVATEROAD, MINORCITYROAD, MAJORDISTRICTROAD, MAJORCITYROAD, NATIONALHIGHWAY, SERVICEROAD, STATEHIGHWAY, OTHERDISTRICTROAD, PORT_ROAD]

Must be one of:

  • "MAJOR_DISTRICT_ROAD"
  • "MAJOR_CITY_ROAD"
  • "MINOR_CITY_ROAD"
  • "NATIONAL_HIGHWAY"
  • "OTHER_DISTRICT_ROAD"
  • "OTHER_PUBLIC_ROAD"
  • "PORT_ROAD"
  • "PRIVATE_ROAD"
  • "SERVICE_ROAD"
  • "STATE_HIGHWAY"

Type: number

Property. Height of the median or central reservation in the road corresponding to this observation

Type: enum (of string)

Property. Reasons for the road work in case of urgent intervention. A combination of these values. Enum:'COLLAPSE, DERAILMENT, FIRE, FLOOD, GASLEAK, LANDSLIDE, OTHER, POWERCUT, ROCKFALL, SAGGING, WATERLEAK'

Must be one of:

  • "COLLAPSE"
  • "DERAILMENT"
  • "FIRE"
  • "FLOOD"
  • "GASLEAK"
  • "LANDSLIDE"
  • "OTHER"
  • "POWERCUT"
  • "ROCKFALL"
  • "SAGGING"
  • "WATERLEAK"

Type: string

Property. Unique internal representation of the road corresponding to this observation

Type: number

Property. Width of the cycle track on the right edge of the road corresponding to this observation

Type: string

Property. The construction material used for laying the carriageway corresponding to this observation. For eg. concrete, earthen, tar etc

Type: number

Property. Width of the median or central reservation in the road corresponding to this observation

Type: number

Property. Total width of the carriage way of the road segment corresponding to this observation

Type: number

Property. Height of the cycle track on the right edge of the road corresponding to this observation

Type: string

Property. Represents the direction the road is heading to. Enum:' ['N, S, E, W'. The values N,S,E,W represent North,South,East,West respectively

Type: number

Property. Length of the median or central reservation in the road corresponding to this observation

Type: string

Property. Construction material used for laying the walkway / footpath on the sides of the road corresponding to this observation

Type: number

Property. Width of the cycle track on the left edge of the road corresponding to this observation

Type: number

Property. Maximum allowed width for vehicles using the entity corresponding to this observation

Type: number

Property. Right of Way (RoW) is the total land area available for the roadway. Its width accommodates for carriages way + other necessities + future extension, along the road's alignment

Type: number

Property. Height of the cycle track on the left edge of the road corresponding to this observation

Type: number

Property. Width of the walkway placed on the right edge of the road corresponding to this observation

Type: number

Property. Width of the walkway placed on the left edge of the road corresponding to this observation

Type: object

Property. Describes the aspects of lanes of the road corresponding to this observation

Type: number

Property. Unique identification number of the lane corresponding to this observation

Type: enum (of string)

Property. Describes the direction in which vehicles are plying on the lane corresponding to this observation. Enum:'FORWARD, BACKWARD, INBOUND, OUTBOUND, RIGHT, LEFT'

Must be one of:

  • "BACKWARD"
  • "FORWARD"
  • "INBOUND"
  • "LEFT"
  • "OUTBOUND"
  • "RIGHT"

Type: string

Property. Describes the presence and placement of pedestrian along the road segment corresponding to this observation. Enum:'RIGHT, LEFT, BOTH, NOT_AVAILABLE'

Type: number

Property. Height of the walkway placed on the right edge of the road corresponding to this observation

Type: enum (of string)

Property. Describes the placement of cycle track along the road segment corresponding to this observation. Enum:' ['RIGHT, LEFT, BOTH, NOT_AVAILABLE'

Must be one of:

  • "BOTH"
  • "LEFT"
  • "NOT_AVAILABLE"
  • "RIGHT"

Type: number

Property. Total width of the cycle track present in the road corresponding to this observation

Type: string

Property. The agencyname field contains the full name of the agency or organisation responsible for maintenance of the entity under consideration. SameAs: 'agencyname' field from GTFS Static Field Definition - agency.txt (https://developers.google.com/transit/gtfs/reference#agencytxt)

Type: object

Property. Model:'https://schema.org/Text. Municipality information corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. District name corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. Name of the Urban Local Body corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. City ID corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. Ward ID corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. Name of the state corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. City name corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. Zone name corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. Zone ID corresponding to this observation

Type: string

Property. Model:'https://schema.org/Text'. Ward name corresponding to this observation

Type: number

Property. Model:'https://schema.org/Number'. Ward number corresponding to this observation

The following properties are required: