Skip to content

Latest commit

 

History

History
143 lines (108 loc) · 3.66 KB

spec.md

File metadata and controls

143 lines (108 loc) · 3.66 KB

GtfsStation

Description

See https://developers.google.com/transit/gtfs/reference/#stopstxt

It is a GTFS stop which location_type is equal to 1.

Data Model

The data model is defined as shown below:

  • id: Entity ID

    • It shall be urn:ngsi-ld:gtfs:Station:<station_identifier> being station_identifier a value that can derived from the stop_id field.

  • type: Entity Type

    • It shall be equal to GtfsStation

  • source : A sequence of characters giving the source of the entity data.

    • Attribute type: Text or URL
    • Optional

  • dataProvider : Specifies the URL to information about the provider of this information

    • Attribute type: URL
    • Optional

  • dateCreated : Entity's creation timestamp.

    • Attribute type: DateTime
    • Read-Only. Automatically generated.

  • dateModified : Last update timestamp of this Entity.

    • Attribute type: DateTime
    • Read-Only. Automatically generated.

  • hasStop : It shall point to another Entity(ies) of type GtfsStop

    • Type: Relationship. List of GtfsStop.
    • Mandatory

  • hasAccessPoint : It shall point to another Entity(ies) of type GtfsAccessPoint

The specification for the following attributes is the one mandanted by GtfsStop:

  • name
  • code
  • page
  • description
  • location
  • wheelChairAccessible
  • zoneCode
  • address
  • hasParentStation

Examples

Normalized Example

Normalized NGSI response

{
    "id": "urn:ngsi-ld:GtfsStation:Madrid:est_90_21",
    "type": "GtfsStation",
    "code": {
        "value": "21"
    },
    "name": {
        "value": "Intercambiador de Plaza de Castilla"
    },
    "hasStop": {
        "type": "Relationship",
        "value": ["urn:ngsi-ld:GtfsStop:Madrid_par_4_1"]
    },
    "location": {
        "type": "geo:json",
        "value": {
            "type": "Point",
            "coordinates": [-3.6892, 40.4669]
        }
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressLocality": "Madrid",
            "addressCountry": "ES",
            "streetAddress": "Paseo de la Castellana 189"
        }
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "id": "urn:ngsi-ld:GtfsStation:Madrid:est_90_21",
    "type": "GtfsStation",
    "code": "21",
    "name": "Intercambiador de Plaza de Castilla",
    "location": {
        "type": "Point",
        "coordinates": [-3.6892, 40.4669]
    },
    "address": {
        "streetAddress": "Paseo de la Castellana 189",
        "addressLocality": "Madrid",
        "addressCountry": "ES"
    },
    "hasStop": ["urn:ngsi-ld:GtfsStop:Madrid_par_4_1"]
}

Summary of mappings to GTFS

Properties

Same as GtfsStop

Relationships

GTFS Field NGSI Attribute LinkedGTFS Comment
hasStop shall point to Entities of type GtfsStop
hasAccessPoint shall point to Entities of type GtfsAccessPoint
hasParentStation shall point to an Entity of type GtfsStation

Open issues