# helsinki

`https://hel.fi/models/helsinki/helsinki/views/ajaezssvx3bwqgejgepmq4ig3frgan4e`

## Alert

One road work or traffic announcement of Fintraffic in the capital region, or one service alert of HSL with the lines and stops it affects.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| name | string | LanguageProperty | no | no | The name, per language. |
| description | string | LanguageProperty | no | no | A short description, per language. |
| category | string | Property | no | no | The alert's domain; traffic for everything Fintraffic and HSL publish. |
| subCategory | string | Property | no | no | The Smart Data Models code of the alert, roadWorks for a Fintraffic road work. Left out where no code fits: a Fintraffic traffic announcement and an HSL service alert. |
| alertSource | string | Property | no | no | Who raised the alert, Fintraffic or HSL. |
| effect | string | Property | no | no | What an HSL service alert does to the service, as GTFS-RT names it, such as DETOUR or REDUCED\_SERVICE. |
| cause | string | Property | no | no | Why an HSL service alert is in force, as GTFS-RT names it, such as CONSTRUCTION or MAINTENANCE. |
| severity | string | Property | no | no | How much the alert matters, informational, medium or high \(GTFS-RT INFO, WARNING, SEVERE\). |
| address | uriorcurie | Property | no | no | The postal address as the source publishes it, field by field \(Smart Data Models' common PostalAddress\); a field the source leaves out is absent, never guessed from a line of text. |
| dateIssued | datetime | Property | no | no | When the situation was published. |
| validFrom | datetime | Property | no | no | When the situation starts. |
| validTo | datetime | Property | no | no | When the situation ends; absent while open-ended. |
| refRoute | GtfsRoute | Relationship | no | yes | The lines an HSL service alert affects, each a GtfsRoute of this space. |
| refStop | GtfsStop | Relationship | no | yes | The stops an HSL service alert affects, each a GtfsStop of this space. |
| unknownReference | string | Property | no | yes | What an HSL service alert names that this space holds no entity for, as \`route:\<id\>\` or \`stop:\<id\>\`, kept as text rather than as a relationship that would point at nothing. |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## GtfsAgency

The transit agency HSL's GTFS feed names, HSL itself.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| agencyName | string | Property | no | no | The transit agency's full name. |
| page | uri | Property | no | no | The publisher's web page about it. |
| timezone | string | Property | no | no | The agency's time zone, an IANA name such as Europe/Helsinki. |
| language | string | Property | no | no | The agency's main language, a two-letter code. |
| phone | string | Property | no | no | The agency's public customer service number. |
| routes | GtfsRoute | Relationship | no | yes | The lines the agency operates, computed from their operatedBy and never stored. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## GtfsRoute

One HSL line as GTFS gives it, both directions and every variant: its number, its name, what runs it and who operates it. Its stops in order are PublicTransportRoute's.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| shortName | string | Property | no | no | The line number riders see, such as 4 or 550. |
| name | string | LanguageProperty | no | no | The name, per language. |
| routeType | string | Property | no | no | GTFS's basic route type: 0 a tram, 1 the metro, 2 a train, 3 a bus, 4 a ferry. HSL's extended codes \(109, 700s, 900\) are written as the basic one they extend. |
| transportMode | TransportMode | Property | no | no | What serves the stop or runs the line. |
| operatedBy | GtfsAgency | Relationship | no | no | The agency that runs the line. |
| routeAlerts | Alert | Relationship | no | yes | The HSL service alerts on the line, computed from their refRoute and never stored. |
| page | uri | Property | no | no | The publisher's web page about it. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## GtfsShape

The line one HSL route variant draws on the map, about 200 of its points, and the distance travelled at each.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| name | string | LanguageProperty | no | no | The name, per language. |
| distanceTravelled | float | Property | no | yes | The distance along the shape at each point of its line, in kilometres. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## GtfsStation

One HSL station \(GTFS location type 1\), where it is and the platforms it gathers.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| name | string | LanguageProperty | no | no | The name, per language. |
| fareZone | string | Property | no | no | The HSL fare zone the stop lies in, A to D; none for a stop beyond HSL's zones. |
| transportMode | TransportMode | Property | no | no | What serves the stop or runs the line. |
| wheelChairAccessible | string | Property | no | no | Whether a wheelchair can board here, GTFS's wheelchair\_boarding; 0 unknown, 1 possible, 2 not possible. |
| hasStop | GtfsStop | Relationship | no | yes | The platforms of the station, computed from their hasParentStation and never stored. |
| nearbyParking | OffStreetParking | Relationship | no | yes | The park and ride sites whose nearest station this is, computed from their refNearestStation and never stored. |
| page | uri | Property | no | no | The publisher's web page about it. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## GtfsStop

One HSL stop or station platform, where it is, its sign's code and its fare zone.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| name | string | LanguageProperty | no | no | The name, per language. |
| stopCode | string | Property | no | no | The code on the stop's sign, such as H2014; empty for a stop HSL gives none. |
| description | string | LanguageProperty | no | no | A short description, per language. |
| fareZone | string | Property | no | no | The HSL fare zone the stop lies in, A to D; none for a stop beyond HSL's zones. |
| transportMode | TransportMode | Property | no | no | What serves the stop or runs the line. |
| wheelChairAccessible | string | Property | no | no | Whether a wheelchair can board here, GTFS's wheelchair\_boarding; 0 unknown, 1 possible, 2 not possible. |
| hasParentStation | GtfsStation | Relationship | no | no | The station the stop or platform belongs to; absent for a stop on its own. |
| departures | string | JsonProperty | no | no | The next departures from the stop, at most five, soonest first, each an object with the line \(\`route\`, the GtfsRoute's id, and \`routeId\`\), its \`directionId\`, the \`expected\` time and its \`status\` \(scheduled, skipped or canceled\), and \`delay\` in seconds with the \`scheduled\` time it implies when HSL sends one. Set every 30 s for a curated set of stops from HSL's GTFS-RT trip updates; empty after five minutes without a feed. |
| stopAlerts | Alert | Relationship | no | yes | The HSL service alerts on the stop, computed from their refStop and never stored. |
| page | uri | Property | no | no | The publisher's web page about it. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## OffStreetParking

One park and ride site of the HSL area from Fintraffic's LIIPI register \(T-3894\), where it is, what it holds, whether it is open, the free spaces when it reports them, and its station.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| name | string | LanguageProperty | no | no | The name, per language. |
| status | string | Property | no | no | A bike station's working while it rents and takes returns, otherwise outOfService; a park and ride site's open, closed or closedAbnormal \(Fintraffic LIIPI's IN\_OPERATION, INACTIVE or TEMPORARILY\_CLOSED, EXCEPTIONAL\_SITUATION\). |
| allowedVehicleType | string | Property | no | yes | What may park, the site's own kind first \(car or bicycle\), then motorcycle where it has spaces for them. |
| totalSpotNumber | integer | Property | no | no | The number of vehicles the site holds, as the publisher states or estimates it; for a park and ride site, of its own kind \(car or bicycle\). |
| capacityByType | string | JsonProperty | no | no | The built capacity per kind of space, as LIIPI names them in lower case \(car, disabled, bicycle, electricCar, motorcycle, bicycleSecureSpace\), each a count. |
| availableSpotNumber | integer | Property | no | no | Free spaces at the park and ride site when it last reported, LIIPI's spacesAvailable. |
| refNearestStation | GtfsStation | Relationship | no | no | The HSL station within 500 m of the park and ride site, the nearest one, a GtfsStation of this space. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## PublicTransportRoute

One HSL line in one direction: its number, where it runs to, its stops in order and the line through them. A line with several variants has one entity per variant. The Smart Data Model's generic public transport route \(T-4329\); GtfsRoute is the line without a direction.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| name | string | LanguageProperty | no | no | The name, per language. |
| route | string | Property | no | no | The HSL route id the vehicle is serving, as GTFS names it \(2550, 1009, 31M1, 3001K\). |
| routeShortName | string | Property | no | no | The line number riders see, such as 4 or 550. |
| headsign | string | Property | no | no | Where the line runs to in this direction, as its sign shows it. |
| directionId | integer | Property | no | no | HSL's direction of the line, 1 or 2. |
| transportMode | TransportMode | Property | no | no | What serves the stop or runs the line. |
| transportationType | integer | Property | yes | no | What runs the line as its GTFS route type \(0 tram, 1 metro, 2 train, 3 bus, 4 ferry\), the number the Smart Data Model requires beside the word \`transportMode\` gives. |
| stopSequence | string | Property | no | yes | The stops the line serves in this direction, in order, each the GTFS stop id that ends the id of a GtfsStop of this space. |
| dataProvider | string | Property | no | no | Who publishes the data the entity was read from, as an application credits it beside the licence \(CC BY 4.0 for every feed of this space\). |
| source | uri | Property | no | no | The open-data service the entity was read from. |

## Vehicle

One HSL bus, tram, metro, train or ferry in service, where it is, how fast it moves and how late it runs.

| Slot | Range | Kind | Required | Multivalued | Description |
|---|---|---|---|---|---|
| location | string | GeoProperty | no | no | Where the entity is, as GeoJSON geometry. |
| speed | float | Property | no | no | Ground speed of the vehicle. |
| heading | float | Property | no | no | Compass heading of the vehicle, degrees clockwise from north. |
| route | string | Property | no | no | The HSL route id the vehicle is serving, as GTFS names it \(2550, 1009, 31M1, 3001K\). |
| vehicleType | string | Property | no | no | The Smart Data Models kind of vehicle - bus, tram, passengerVessel for a ferry, other for metro and train; transportMode names HSL's mode. |
| transportMode | TransportMode | Property | no | no | What serves the stop or runs the line. |
| fleetVehicleId | string | Property | no | no | The operator and vehicle number HSL publishes, operator-vehicle. |
| onRoute | uriorcurie | Relationship | no | no | The line the vehicle is running, the URN of a GtfsRoute of this space. |
| nextStop | uriorcurie | Relationship | no | no | The stop the vehicle stands at or comes to next, the URN of a GtfsStop of this space; HSL moves it on at each departure from or passing of a stop. |
| delay | integer | Property | no | no | Seconds behind the timetable, negative when ahead \(HSL's dl with the sign turned\). |
| occupancy | integer | Property | no | no | How full the vehicle is, in percent; HSL sends 0 \(room\) or 100 \(full\). |

## TransportMode (enum)

- bus: A bus.
- ferry: A ferry.
- metro: The metro.
- train: A commuter train.
- tram: A tram.