Skip to content
Last updated

πŸ“¬ How to Send a Routing Request

You’ve built your JSON request body β€” now let’s send it using Postman or cURL, with the proper headers.


🧾 Required Headers

Whether using Postman or cURL, make sure to include these HTTP headers:

Header NameValue
Content-Typeapplication/json
acceptapplication/json
AuthorizationBearer <your_access_token>

πŸ›‘οΈ You must first authenticate using the /authenticate endpoint to get a valid token.
See the authentication tutorial.


πŸ§ͺ Using Postman

  1. Open Postman and create a new POST request.
  2. Set the URL to:

https://bemap-prod.benomad.com/bgis/service/routing/1.0

  1. Under the Headers tab, add:
KEYVALUE
Content-Typeapplication/json
acceptapplication/json
AuthorizationBearer your_access_token
  1. Under the Body tab:
    • Select raw and choose JSON.
    • Paste your routing request JSON body.
{
  "geoserver": "osm",
  "routingMode": "MODE_VIAS",
  "outputLanguage": "fr",
  "destinations": [
    {
      "coordinateSat": {
        "lon": 2.32158,
        "lat": 48.86533
      }
    },
    {
      "coordinateSat": {
        "lon": 4.35655,
        "lat": 50.8447
      }
    }
  ],
  "options": [
    "POLYLINE"
  ],
  "routingVehicleProfile": {
    "transportMode": "CAR"
  }
}
  1. Click Send. 🎯

πŸ’» Using cURL

curl -X POST "https://bemap-prod.benomad.com/bgis/service/routing/1.0" \
  -H "Content-Type: application/json" \
  -H "accept: application/json" \
  -H "Authorization: Bearer <your_access_token>" \
  -d '{
    "destinations": [
      { "coordinateSat": { "lon": 2.3522, "lat": 48.8566 } },
      { "coordinateSat": { "lon": 5.0415, "lat": 47.3220 } }
    ],
    "routingVehicleProfile": {
      "transportMode": "CAR"
    },
    "routingCriterias": ["AVOID_MOTORWAYS"],
    "options": ["POLYLINE"]
  }'

πŸ“Œ Make sure to replace <your_access_token> with a valid token retrieved from the /authenticate endpoint.