Public Transit API Developer's Guide

Transit Modes

The transit modes allow you to specify (using the modes request parameter) various types of vehicles that you wish to be included in the transit routing results. By default, all types of transits are supported if this parameter is omitted in a request. Currently a total of nine (9) modes of transit (trains, buses, ferries, trams, and others) are supported, with up to 14 unique vehicle types.

The modes parameter is constructed using a string, where the modes specified by name separated by commas. There are two possible format:
  • code_1,code_2,...,code_N - enable specified vehicle types and disable everything else
  • -code_1,-code_2,...,-code_N - disable specified vehicle types and enabled everything else
Note: It is not allowed to mix enabling and disabling vehicle types at the same time like this: code_1,-code_2,code_3,...,-code_N. Request will be considered as invalid and API will return an error.
Table 1. List of Transit Codes and Corresponding Vehicle Types
Code Name Vehicle Types
0 high_speed_train High-speed Trains
1 intercity_train Intercity/EuroCity Trains
2 inter_regional_train Inter-regional and fast trains
3 regional_train Regional and other trains
4 city_train City trains
5 bus Buses
6 ferry Boats/Ferries
7 subway Metros/Subways
8 light_rail Trams
9 private_bus Ordered services/Taxis
10 inclined Inclined/Funiculars
11 aerial Aerials/Cable Cars
12 bus_rapid Rapid Buses
13 monorail Monorails
14 flight Airplanes

The examples below show which vehicle types should be included in the response for different modes values:

  • all or the absent of the parameter - all supported vehicle types
  • intercity_train,bus,light_rail - Intercity/EuroCity Trains (code 1), Buses (code 5) and Trams (code 8) only
  • subway,bus - Metros/Subways (code 7) and Buses (code 5) only
  • -bus - all types except Buses (code 5)
  • -high_speed_train,-subway,-monorail - all types except High-speed Trains (code 0), Metros/Subways (code 7) and Monorails (code 13)

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.