Routing API Developer's Guide

Requesting Matrix Calculation using POST method

In a POST body, you can only send start and destinations points in the same format as in the REST URL. However, this allows to send a larger amount of points than in the REST method, which has a length limitation for URLs. If you use wget, there are two ways of sending a POST body:
  • POST body from file (Note: Make sure there is no dot character '.' at the end of file in the hex editor to avoid an error response from the server)
  • POST body from string

The following example demonstrates a request of a matrix of routes for one start and two destinations points using a POST body from string and setting output filename with -O switch.

Note: These examples use a HERE API Key to authenticate your request. For information on other possible options, see https://developer.here.com/documentation/authentication. For examples of how to use the other authentication options with the Routing API, see Authentication Examples.
wget "https://matrix.route.ls.hereapi.com/routing/7.2/calculatematrix.json
?apikey={YOUR_APIKEY}
&mode=fastest;pedestrian;traffic:disabled"
--post-data="start0=52.43%2C13.4&destination0=52.5%2C13.43&destination1=52.5%2C13.46"
-O output.json

The following example demonstrates a request of a matrix of routes for one start and two destinations points using POST body from file and setting output filename with -O switch.

wget "https://matrix.route.ls.hereapi.com/routing/7.2/calculatematrix.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&mode=fastest;pedestrian;traffic:disabled"
--post-file=points.txt
-O output.json
wget "https://matrix.route.ls.hereapi.com/routing/7.2/calculatematrix.json
?apikey={YOUR_APIKEY}
&mode=fastest;pedestrian;traffic:disabled"
--post-file=points.txt
-O output.json

Contents of file points.txt:

start0=52.43%2C13.4&destination0=52.5%2C13.43&destination1=52.5%2C13.46

Both examples result in the same response:

{
  response: {
  metaInfo: { /*content omitted*/ },
  matrixEntry: [
    {
    startIndex: 0,
    destinationIndex: 0,
    summary: { costFactor: 9462 }
    },
    {
    startIndex: 0,
    destinationIndex: 1,
    summary: { costFactor: 10600 }
    }
  ]
  }
}