Get Started - HERE developer portal

This section outlines how to get started quickly using the Intermodal Routing API v8 on the HERE developer portal.

  1. Get a HERE Account
  2. Register your App
  3. Get an API Key
  4. Send a Request

Note

This section provides information on the minimum setup required to begin quickly using the Intermodal Routing API v8. For more detailed information on HERE account setup, app registration, and authentication, see the Identity & Access Management Developer Guide.

Get a HERE Account

If you are an individual developer who has signed up for one of the plans listed on our Developer plans page on developer.here.com, you received a HERE account ID when you signed up. You can use your HERE account to log in to developer.here.com to create applications. Applications (uniquely identified by an app ID) enable development with HERE products and services.

Register your App

To register your app, follow these steps:

  1. Sign in to developer.here.com.
  2. Click your name, select Projects, and then choose your project from the list. Your project details and available application credentials are then displayed.
  3. Select JavaScript or REST and click Generate App. When your application is created, its app ID is displayed.

Get an API key

To get an API key, follow these steps:

  1. Sign in to developer.here.com.
  2. Click your name, select Projects, and then choose your project from the list. Your project details and available application credentials are then displayed.
  3. Click Create API key to generate a maximum of two API keys for your application. The API key is created and displayed.

Send a Request

This example begins at the HERE Campus in Berlin Mitte and provides routing to travel to Potsdam, a city near the German capital. In this example, you would also like to know at least 3 ways to reach Potsdam.

GET https://intermodal.router.hereapi.com/v8/routes
    ?apiKey={YOUR_API_KEY}
    &alternatives=1
    &destination=52.40358749909618,13.058351363288239
    &origin=52.53105637575095,13.384944833815183

By default, the Intermodal Routing API v8 returns only one optimal intermodal route. The optional parameter alternatives represents the number of alternate routes to return alongside the optimal route. By default, it is set to alternatives=0. Since you passed the alternatives=2 parameter, the router of the Intermodal Routing API v8 computes three optimal intermodal routes with all transport types that are available in your area.

If the intermodal route calculation was successful, the /routes response contains the requested details about the calculated route:

  • Three optimal intermodal routes.
  • One or a combination of the following transport types, each of which contains departure and arrival times, duration, coordinates, and other section information:
    • taxi
    • transit
    • vehicle
    • rented
    • pedestrian
  • A set of operators that run the services included in the alternatives, including operator code, operator name, and links to operator websites, if any.

Note

Since you do not specify multiple optional parameters, particularly departureTime, arrivalTime, or <transport-type>[enable]=<route-section>, you might not obtain the same output as shown below in your response.

{
  "routes": [
    {
      "id": "R00347b-C0",
      "sections": [
        {
          "id": "R00347b-C0-S0",
          "type": "pedestrian",
          "notices": [
            {
              "code": "walkOptionViolated"
            }
          ],
          "departure": {
            "time": "2020-04-28T17:53:00+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.531055,
                "lng": 13.384947
              }
            }
          },
          "arrival": {
            "time": "2020-04-28T17:57:00+02:00",
            "place": {
              "name": "U Naturkundemuseum [Invalidenstr.]",
              "type": "station",
              "location": {
                "lat": 52.530336,
                "lng": 13.382223
              },
              "id": "vbb_900100709"
            }
          }
        },
        {
          "id": "R00347b-C0-S1",
          "type": "transit",
          "departure": {
            "time": "2020-04-28T17:57:00+02:00",
            "place": {
              "name": "U Naturkundemuseum [Invalidenstr.]",
              "type": "station",
              "location": {
                "lat": 52.530336,
                "lng": 13.382223
              },
              "id": "vbb_900100709"
            },
            "delay": 0
          },
          "arrival": {
            "time": "2020-04-28T18:01:00+02:00",
            "place": {
              "name": "S+U Berlin Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.52585,
                "lng": 13.368928
              },
              "id": "vbb_900003201"
            },
            "delay": 0
          },
          "transport": {
            "mode": "lightRail",
            "name": "Tram M10",
            "category": "Tram",
            "color": "#DF6A1C",
            "textColor": "#FFFFFF",
            "headsign": "S+U Hauptbahnhof"
          },
          "agency": {
            "id": "BVG",
            "name": "Berliner Verkehrsbetriebe"
          }
        },
        {
          "id": "R00347b-C0-S2",
          "type": "transit",
          "departure": {
            "time": "2020-04-28T18:12:00+02:00",
            "place": {
              "name": "S+U Berlin Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.52585,
                "lng": 13.368928
              },
              "id": "vbb_900003201",
              "platform": "14"
            },
            "delay": 60
          },
          "arrival": {
            "time": "2020-04-28T18:36:00+02:00",
            "place": {
              "name": "S Potsdam Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.390931,
                "lng": 13.067187
              },
              "id": "vbb_900230999",
              "platform": "3"
            },
            "delay": 0
          },
          "transport": {
            "mode": "regionalTrain",
            "name": "RE1",
            "category": "RE",
            "color": "#D7081D",
            "textColor": "#FFFFFF",
            "headsign": "Magdeburg, Hauptbahnhof"
          },
          "agency": {
            "id": "DB",
            "name": "DB Regio AG"
          }
        },
        {
          "id": "R00347b-C0-S3",
          "type": "transit",
          "departure": {
            "time": "2020-04-28T18:42:00+02:00",
            "place": {
              "name": "S Potsdam Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.390931,
                "lng": 13.067187
              },
              "id": "vbb_900230999",
              "platform": "2"
            }
          },
          "arrival": {
            "time": "2020-04-28T18:49:00+02:00",
            "place": {
              "name": "Potsdam, Nauener Tor",
              "type": "station",
              "location": {
                "lat": 52.403102,
                "lng": 13.057919
              },
              "id": "vbb_900230022"
            }
          },
          "transport": {
            "mode": "lightRail",
            "name": "Tram 96",
            "category": "Tram",
            "color": "#CC0A22",
            "textColor": "#FFFFFF",
            "headsign": "Potsdam, Campus Jungfernsee"
          },
          "agency": {
            "id": "ViP",
            "name": "Verkehrsbetrieb Potsdam GmbH"
          }
        },
        {
          "id": "R00347b-C0-S4",
          "type": "pedestrian",
          "notices": [
            {
              "code": "walkOptionViolated"
            }
          ],
          "departure": {
            "time": "2020-04-28T18:49:00+02:00",
            "place": {
              "name": "Potsdam, Nauener Tor",
              "type": "station",
              "location": {
                "lat": 52.403102,
                "lng": 13.057919
              },
              "id": "vbb_900230022"
            }
          },
          "arrival": {
            "time": "2020-04-28T18:51:00+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.403588,
                "lng": 13.058351
              }
            }
          }
        }
      ]
    },
    {
      "id": "R00347b-C1",
      "sections": [
        {
          "id": "R00347b-C1-S0",
          "type": "pedestrian",
          "notices": [
            {
              "code": "walkOptionViolated"
            }
          ],
          "departure": {
            "time": "2020-04-28T18:03:00+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.531055,
                "lng": 13.384947
              }
            }
          },
          "arrival": {
            "time": "2020-04-28T18:07:00+02:00",
            "place": {
              "name": "U Naturkundemuseum [Invalidenstr.]",
              "type": "station",
              "location": {
                "lat": 52.530336,
                "lng": 13.382223
              },
              "id": "vbb_900100709"
            }
          }
        },
        {
          "id": "R00347b-C1-S1",
          "type": "transit",
          "departure": {
            "time": "2020-04-28T18:07:00+02:00",
            "place": {
              "name": "U Naturkundemuseum [Invalidenstr.]",
              "type": "station",
              "location": {
                "lat": 52.530336,
                "lng": 13.382223
              },
              "id": "vbb_900100709"
            },
            "delay": 0
          },
          "arrival": {
            "time": "2020-04-28T18:11:00+02:00",
            "place": {
              "name": "S+U Berlin Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.52585,
                "lng": 13.368928
              },
              "id": "vbb_900003201"
            },
            "delay": 0
          },
          "transport": {
            "mode": "lightRail",
            "name": "Tram M10",
            "category": "Tram",
            "color": "#DF6A1C",
            "textColor": "#FFFFFF",
            "headsign": "S+U Hauptbahnhof"
          },
          "agency": {
            "id": "BVG",
            "name": "Berliner Verkehrsbetriebe"
          }
        },
        {
          "id": "R00347b-C1-S2",
          "type": "transit",
          "departure": {
            "time": "2020-04-28T18:17:00+02:00",
            "place": {
              "name": "S+U Berlin Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.52585,
                "lng": 13.368928
              },
              "id": "vbb_900003201",
              "platform": "16"
            },
            "delay": 0
          },
          "arrival": {
            "time": "2020-04-28T18:52:00+02:00",
            "place": {
              "name": "S Potsdam Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.390931,
                "lng": 13.067187
              },
              "id": "vbb_900230999",
              "platform": "6"
            },
            "delay": 0
          },
          "transport": {
            "mode": "cityTrain",
            "name": "S7",
            "category": "S-Bahn",
            "color": "#7760B0",
            "textColor": "#FFFFFF",
            "headsign": "S Potsdam Hauptbahnhof"
          },
          "agency": {
            "id": "DBS",
            "name": "S-Bahn Berlin GmbH"
          }
        },
        {
          "id": "R00347b-C1-S3",
          "type": "transit",
          "departure": {
            "time": "2020-04-28T18:57:00+02:00",
            "place": {
              "name": "S Potsdam Hauptbahnhof",
              "type": "station",
              "location": {
                "lat": 52.390931,
                "lng": 13.067187
              },
              "id": "vbb_900230999",
              "platform": "2"
            },
            "delay": 0
          },
          "arrival": {
            "time": "2020-04-28T19:04:00+02:00",
            "place": {
              "name": "Potsdam, Nauener Tor",
              "type": "station",
              "location": {
                "lat": 52.403102,
                "lng": 13.057919
              },
              "id": "vbb_900230022"
            },
            "delay": 0
          },
          "transport": {
            "mode": "lightRail",
            "name": "Tram 92",
            "category": "Tram",
            "color": "#CC0A22",
            "textColor": "#FFFFFF",
            "headsign": "Potsdam, Kirschallee"
          },
          "agency": {
            "id": "ViP",
            "name": "Verkehrsbetrieb Potsdam GmbH"
          }
        },
        {
          "id": "R00347b-C1-S4",
          "type": "pedestrian",
          "notices": [
            {
              "code": "walkOptionViolated"
            }
          ],
          "departure": {
            "time": "2020-04-28T19:04:00+02:00",
            "place": {
              "name": "Potsdam, Nauener Tor",
              "type": "station",
              "location": {
                "lat": 52.403102,
                "lng": 13.057919
              },
              "id": "vbb_900230022"
            }
          },
          "arrival": {
            "time": "2020-04-28T19:06:00+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.403588,
                "lng": 13.058351
              }
            }
          }
        }
      ]
    }
  ]
}

results matching ""

    No results matching ""