GtfsShape
This repository is now archived and subsequent works will be carried out the in Smart data models repositories.
Description
See https://developers.google.com/transit/gtfs/reference/#shapestxt
It represents a GTFS shape
.
Data Model
The data model is defined as shown below:
-
id
: Entity ID- It shall be
urn:ngsi-ld:GtfsShape:<shape_identifier>
beingshape_identifier
a value that can derived from the GTFSshape_id
field.
- It shall be
-
type
: Entity Type- It shall be equal to
GtfsShape
- It shall be equal to
-
source
: A sequence of characters giving the source of the entity data. -
dataProvider
: Specifies the URL to information about the provider of this information- Attribute type: Property. URL
- Optional
-
dateCreated
: Entity's creation timestamp.- Attribute type: Property. DateTime
- Read-Only. Automatically generated.
-
dateModified
: Last update timestamp of this Entity.- Attribute type: Property. DateTime
- Read-Only. Automatically generated.
-
location
: The geographical shape associated to this entity encoded as GeoJSONLineString
orMultiLineString
. The coordinates shall be obtained from theshapes.txt
feed file as per the value ofshape_id
,shape_pt_lat
,shape_pt_lon
,shape_pt_sequence
.- Attribute type: GeoProperty.
geo:json
- Optional
- Attribute type: GeoProperty.
-
distanceTravelled
: An array of the distance travelled when reaching each of the points that make theLineString
orMultiLineString
that represents this shape. It shall match the same number of elements as the correspondingLineString
orMultiLineString
.- Attribute type: List of Number if the Shape is defined by a `LineString`. List of List of Number if the Shape is defined by a `MultiLineString`. - Optional
Example 1 (Normalized Format)
{
"id": "urn:ngsi-ld:GtfsShape:S234",
"type": "GtfsShape",
"location": {
"type": "geo:json",
"value": {
"type": "LineString",
"coordinates": [
[-4.421394, 36.73826],
[-4.421428, 36.73825],
[-4.421505, 36.738186],
[-4.421525, 36.738033]
]
}
},
"distanceTravelled": {
"type": "List",
"value": [
0,
6.10,
9.78
13.45
]
}
}
Example 2 (?options=keyValues simplified representation for data consumers)
{
"id": "urn:ngsi-ld:GtfsShape:S234",
"type": "GtfsShape",
"location": {
"type": "LineString",
"coordinates": [
[-4.421394, 36.73826],
[-4.421428, 36.73825],
[-4.421505, 36.738186],
[-4.421525, 36.738033]
]
},
"distanceTravelled": [
0,
6.10,
9.78
13.45
]
}
Summary of mappings to GTFS
Properties
GTFS Field | NGSI Attribute | LinkedGTFS | Comment |
---|---|---|---|
shape_pt_lat |
location |
geo:lat |
Latitude of points. |
shape_pt_lon |
location |
geo:long |
Longitude of points. |
shape_pt_sequence |
location |
gtfs:pointSequence |
Sequence of points. |
shape_dist_traveled |
distanceTravelled |
gtfs:distanceTravelled |
Distance travelled |
Relationships
GTFS Field | NGSI Attribute | LinkedGTFS | Comment |
---|---|---|---|