notes.yaml

notes previous:
  The General Transit Feed Specification (GTFS), also known as GTFS static or
  static transit, defines a common format for public transportation schedules and
  associated geographic information. GTFS "feeds" let public transit agencies
  publish their transit data and developers write applications that consume that
  data in an interoperable way.

[name of data model](link to swagger if exists if not link to schema.json). README (link)

notesEnd:
  This document provides guidelines on how to map GTFS feeds into FIWARE NGSI
  content. This work leverages on
  [LinkedGTFS specification](https://github.com/OpenTransport/linked-gtfs/blob/master/spec.md).
  Whenever possible the NGSI attributes map directly to GTFS fields. Nonethless
  for some Entity Types extra attributes are suggested in order to better support
  the data model using the NGSI information model.

  ## General rules

  Entity Attributes (Properties or Relationships) are subject to the restrictions
  defined by the
  [GTFS specification](https://developers.google.com/transit/gtfs/reference/#term-definitions)
  If an Attribute is an enumeration its value shall be provided as per the GTFS
  specification (not LinkedGTFS).

  ## Summary of Entity mappings with GTFS

    | GTFS Feed Member Name                                                                           | NGSI Entity Type                                                                                                                  |
    | :---------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |
    | [agency.txt](https://developers.google.com/transit/gtfs/reference/#agencytxt)                   | [GtfsAgency](../GtfsAgency/doc/spec.md)                                                                                           |
    | [stops.txt](https://developers.google.com/transit/gtfs/reference/#stopstxt)                     | [GtfsStop](../GtfsStop/doc/spec.md). [GtfsStation](../GtfsStation/doc/spec.md). [GtfsAccessPoint](../GtfsAccessPoint/doc/spec.md) |
    | [routes.txt](https://developers.google.com/transit/gtfs/reference/#routestxt)                   | [GtfsRoute](../GtfsRoute/doc/spec.md)                                                                                             |
    | [trips.txt](https://developers.google.com/transit/gtfs/reference/#tripstxt)                     | [GtfsTrip](../GtfsTrip/doc/spec.md). See also [GtfsService](../GtfsService/doc/spec.md)                                           |
    | [stop_times.txt](https://developers.google.com/transit/gtfs/reference/#stop_timestxt)           | [GtfsStopTime](../GtfsStopTime/doc/spec.md)                                                                                       |
    | [calendar.txt](https://developers.google.com/transit/gtfs/reference/#calendartxt)               | [GtfsCalendarRule](../GtfsCalendarRule/doc/spec.md)                                                                               |
    | [calendar_dates.txt](https://developers.google.com/transit/gtfs/reference/#calendar_datestxt)   | [GtfsCalendarDateRule](../GtfsCalendarDateRule/doc/spec.md)                                                                       |
    | [fare_attributes.txt](https://developers.google.com/transit/gtfs/reference/#fare_attributestxt) | N/A                                                                                                                               |
    | [fare_rules.txt](https://developers.google.com/transit/gtfs/reference/#fare_rulestxt)           | N/A                                                                                                                               |
    | [shapes.txt](https://developers.google.com/transit/gtfs/reference/#shapestxt)                   | See [GtfsRoute](../GtfsRoute/doc/spec.md), [GtfsTrip](../GtfsTrip/doc/spec.md)                                                    |
    | [frequencies.txt](https://developers.google.com/transit/gtfs/reference/#frequenciestxt)         | [GtfsFrequency](../GtfsFrequency/doc/spec.md)                                                                                     |
    | [transfers.txt](https://developers.google.com/transit/gtfs/reference/#transferstxt)             | [GtfsTransferRule](../GtfsTransferRule/doc/spec.md)                                                                               |
    | [feedinfo.txt](https://developers.google.com/transit/gtfs/reference/#feed_infotxt)              | N/A                                                                                                                               |