🚗 Routing API

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

The BeMap Routing API lets you compute vehicle routes, optimize trips with multiple stops, generate isochrones (travel-time zones), and calculate matrices between locations.

📌 Use Cases

• Standard route A to B
• Optimized delivery trip with 5 stops
• Show reachable areas in 15min (isochrone)
• Avoid toll roads with truck restrictions
• Estimate toll cost and distance for a bus

🔧 Endpoint

POST /bgis/service/routing/1.0

Environments:

• https://bemap-beta.benomad.com
• https://bemap-preprod.benomad.com
• https://bemap-prod.benomad.com

📥 Example: Passenger Car Route from Paris to Brussels

{
  "geoserver": "here",
  "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"
  }
}

📥 Example: Truck Avoiding Toll Roads from Brussels to Paris

{
  "routingMode": "MODE_VIAS",
  "outputLanguage": "fr",
  "destinations": [
    {
      "coordinateSat": {
        "lon": 4.35655,
        "lat": 50.8447
      }
    },
    {
      "coordinateSat": {
        "lon": 2.32158,
        "lat": 48.86533
      }
    }
  ],
  "options": [
    "POLYLINE"
  ],
  "routingCriterias": [
    "AVOID_TOLLS"
  ],
  "routingVehicleProfile": {
    "transportMode": "TRUCK"
  }
}

🧠 Routing Modes

The routingMode field defines how the route will be calculated, depending on how many origin and destination points you provide, and the type of result you expect.
Default: MODE_VIAS.

"routingMode": "MODE_VIAS"

👉 For detailed examples and usage, check out the tutorial.

⚙️ Routing Criterias

Comma-separated list (e.g. "AVOID_TOLLS,FASTEST"):

• FASTEST (default): Find the route which optimizes travel time.
• SHORTEST: Find the route which optimizes travel distance.
• AVOID_TOLLS: Finds a route which avoids tolls.
• AVOID_FERRIES: Finds a route which avoids ferries.
• AVOID_MOTORWAYS: Finds a route which avoids motorways.
• AVOID_UNPAVED: Finds a route which avoids unpaved roads.
• AVOID_CROSSING_BORDER: Finds a route which avoids country border crossings (only when all coordinates are in a same country)
• CARPOOL: Finds a route which avoids roads reserved to carpooling.
• ECO_ENERGY: Find the route which optimizes travel energy consumption.

  "routingCriterias": [
    "FASTEST",
    "SHORTEST",
    "AVOID_FERRIES",
    "AVOID_MOTORWAYS",
    "AVOID_TOLLS",
    "AVOID_UNPAVED",
    "AVOID_CROSSING_BORDER",
    "CARPOOL",
    "ECO_ENERGY"
  ],

👉 For detailed examples and usage, check out the tutorial

🚛 Vehicle Profile (routingVehicleProfile)

"routingVehicleProfile": {
  "transportMode": "CAR",
  "routingVehicleFeature": {
    "maxSpeed": 90,
    "vehicleWeight": 1500,
    "emissionClass": "EURO6"
  }
}

👉 For detailed examples and usage, check out the tutorial

🔄 Optimization Options (routingMode)

"options": [ "OPTIMIZED_TRIP", "OPTIMIZED_TRIP_CLOSE" ]

• OPTIMIZED_ROUTE_FOR_CHARGING_STATION: Optimizes electric vehicles charges. Checks if the route is feasible with the. current vehicle profile and the given smart routing profile. If not, the method will try to find optimal (according to the criteria used to compute the route) charging stops.
• OPTIMIZED_TRIP: Optimized trip (preserve start/stop)
• OPTIMIZED_TRIP_CLOSE: Return to start by closing the loop
• OPTIMIZED_TRIP_ROUND: Return to start but don't close loop
• OPTIMIZED_TRIP_UNDEFSTOP: Optimized trip with flexible stop

👉 For detailed examples and usage, check out the tutorial

⚡ Energy Vehicle (routingEnergyVehicleFeature)

👉 For detailed examples and usage, check out the tutorial

Routing Speed Coefficient (routingSpeedPond)

👉 For detailed examples and usage, check out the tutorial

🚐 Vehicle Feature Fields (routingVehicleFeature)

👉 For detailed examples and usage, check out the tutorial

📡 EVENT Options – Route Segment Events

The EVENT option enriches the routing response by including detailed per-segment information about the computed path. This is particularly useful for applications needing granular insight into road conditions, elevation, traffic, costs, and more.

Activating EVENT adds an array of event entries to the response. Each entry corresponds to a segment of the route and can include various attributes depending on the sub-options (EVT_XXXX) selected.

📋 List of EVENT Sub-options

The EVENT option enriches the routing response with detailed road segment information. Below are its sub-options:

"options": [ "EVENT", "EVT_ELEVATION2", "EVT_TRAFFIC" ]

👉 For detailed examples and usage, check out the tutorial

🧭 Tips for Non-Developers

• You can use Postman to test routes visually.
• The more fields you provide, the more precise the results.
• Start simple (origin/destination + mode) and add filters.

🔗 API Playground

You can test this API endpoint directly in our dedicated BeMap documentation environment.

👉 Go to BeMap API Playground