Public Transit API Developer's Guide

Alert

Alert contains all available information about an individual transit alert or an announcement.

Table 1. AlertType Attributes
Attribute Always Included Type Description
id Yes, in responses to transit alert requests String Identifier for the alert. The id is a unique value.
operator Yes, in responses to transit alert requests String Name of the operator of the public transit line.
origin Yes, in responses to transit alert requests String Source of the alert. Available values are:
  • API- received from API
  • RSS- received from RSS
  • WEB- obtained from WEB
  • TWITTER- received from Twitter
  • INVITRO - alert issued internally
sec_ids Yes IDREFS Whitespace-separated list of section ids of a connection relevant to the given Alert.
url - anyUrl URL which can be used be end-users to access the original alert. For example, for Twitter it would be an URL of the tweet.
severity - String The severity value The following values are possible:
  • DISRUPT - The disruption exists but the severity is unknown
  • INFO - No disruption, just information
  • LOW - Low severity disruption
  • MEDIUM - Medium severity disruption
  • HIGH - High severity disruption
valid_from - DateTime Time from which the alert is valid, UTC timestamp in ISO 8601 (for example, 2016-06-22T06:36:40) format.
valid_till - DateTime Time until which the alert is valid, UTC timestamp in ISO 8601 (for example, 2016-06-22T06:36:40) format.
Table 2. AlertType Elements
Element Always Included Type Description
Info Yes String Contains information about the public transit line or lines, such as expected closures or special requirements.
Lines - Lines List of lines affected by the alert.
Link - Link Link to a web resource with additional information. link nodes do not contain any text if inside an alert node.
Branding - Branding Some alert sources (like Twitter) have branding requirement and clients must comply to these, for example by showing branding info to user.
Note: The Alerts are sourced from transit agencies' API feeds and/or Twitter accounts (where available). If the alerts' origin is from Twitter, you are required to follow Twitter's general principles for presenting alerts correctly. We do not provide any data for Twitter's logos and links for Twitter's actions. The full guidance on the display requirements can be found on Twitter Display Requirements page.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.