GtfsStop

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/#stopstxt

It represents a GTFS stop which location_type shall be equal to 0.

Data Model

The data model is defined as shown below:

• id: Entity ID

  • It shall be urn:ngsi-ld:GtfsStop:<stop_identifier> being stop_identifier a value that can derived from the GTFS stop_id field.

• type: Entity Type

  • It shall be equal to GtfsStop

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

  • Attribute type: Property. Text or URL
  • Optional

• 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.

• name: Same as GTFS stop_name.

  • Attribute type: Property. Text
  • Normative References: https://uri.etsi.org/ngsi-ld/name equivalent to name
  • Mandatory

• code: Same as GTFS stop_code.

  • Attribute type: Property. Text
  • Optional

• page: Same as GTFS stop_url.

  • Attribute type: Property. URL
  • Optional

• description: Same as GTFS stop_desc.

  • Attribute type: Property. Text
  • Normative References: https://uri.etsi.org/ngsi-ld/description equivalent to description
  • Optional

• location: Stop's location encoded as GeoJSON Point which coordinates shall be in the form [stop_long,stop_lat].

  • Attribute type: GeoProperty. geo:json.
  • Normative References: rfc7946
  • Mandatory

• wheelChairAccessible: Same as GTFS wheelchair_boarding.

  • Attribute type: Property. Text
  • Allowed values: (0, 1, 2) as per the GTFS
  • Optional

• zoneCode : Transport zone to which this stop belongs to. Same as GTFS zone_id.

  • Attribute type: Property. Text
  • Optional

• address: Stop's civic address.

  • Attribute type: Property. PostalAddress
  • Optional

• hasParentStation : Same as GTFS parent_station.

  • Attribute type: Relationship. It shall point to an Entity of Type GtfsStation
  • Optional

• operatedBy : Agency that operates this stop.

  • Attribute type: List of Relationships. They shall point to an Entity of Type GtfsAgency
  • Optional

Examples

Normalized Example

Normalized NGSI response

{
    "id": "urn:ngsi-ld:GtfsStop:Malaga_101",
    "type": "GtfsStop",
    "code": {
        "value": "101"
    },
    "operatedBy": {
        "type": "Relationship",
        "value": "urn:ngsi-ld:GtfsAgency:Malaga_EMT"
    },
    "location": {
        "type": "geo:json",
        "value": {
            "type": "Point",
            "coordinates": [-4.424393, 36.716872]
        }
    },
    "name": {
        "value": "Alameda Principal Sur"
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "id": "urn:ngsi-ld:GtfsStop:Malaga_101",
    "type": "GtfsStop",
    "code": "101",
    "name": "Alameda Principal (Sur)",
    "location": {
        "type": "Point",
        "coordinates": [-4.424393, 36.716872]
    },
    "operatedBy": "urn:ngsi-ld:GtfsAgency:Malaga_EMT"
}

LD Example

Sample uses the NGSI-LD representation

{
    "id": "urn:ngsi-ld:GtfsStop:Malaga_101",
    "type": "GtfsStop",
    "code": {
        "type": "Property",
        "value": "101"
    },
    "operatedBy": {
        "type": "Relationship",
        "object": "urn:ngsi-ld:GtfsAgency:Malaga_EMT"
    },
    "location": {
        "type": "GeoProperty",
        "value": {
            "type": "Point",
            "coordinates": [-4.424393, 36.716872]
        }
    },
    "name": {
        "type": "Property",
        "value": "Alameda Principal Sur"
    },
    "@context": [
        "https://schema.lab.fiware.org/ld/context",
        "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
    ]
}

Summary of mappings to GTFS

Properties

GTFS Field	NGSI Attribute	LinkedGTFS	Comment
stop_name	name	foaf:name
stop_code	code	gtfs:code
stop_url	page	foaf:page
stop_desc	description	dct:description
stop_long,stop_lat	location	geo:long,geo:lat	Encoded as a GeoJSON Point.
zone_id	zoneCode
wheelchair_boarding	wheelChairAccessible	gtfs:wheelChairAccessible	0, 1, 2 as per GTFS spec.
	address		Stop's address. Schema.org

Relationships

GTFS Field	NGSI Attribute	LinkedGTFS	Comment
parent_station	hasParentStation	gtfs:parentStation	Shall point to another Entity of Type GtfsStation
	operatedBy		Shall point to another Entity of Type GtfsAgency

Open issues