API reference
53 operations from BeMap's own specification. Every path is relative to https://bemap.benomad.com/bgis/service.
Authentication
How a call proves who sends it, and how BeMap answers when it does not.
Routing
Routes and arrival times for a vehicle profile, isochrones and matrices, and GPS traces matched to the road network.
Route calculation
Optimal routes and ETAs for a vehicle profile, with isochrones and origin-destination matrices from the same endpoint.
Trace route
The most probable driving route from a GPS trace, corrected and ready to display.
Electric mobility
Electric trips with their charging stops, reachable areas, charging stations and tariffs, charging time and cost, and the electric vehicle database.
EV smart routing
A trip planned for one electric vehicle, with the charging stops it needs and the charge at each one.
EV reachable area
How far an electric vehicle can go without charging, as an area around its start point.
Charging stations
Charging stations around a place or along a route, with connectors, availability, networks, tariffs and charge passes.
- POST/chargingstation/search/1.0Charging station search Find charging stations
- POST/chargingstation/tariffs/1.0/searchGet charging station tariffs Look up charging prices
- GET/chargingstation/chargepass/1.0/listCharging station charge pass List charge passes
- GET/chargingstation/chargepass/1.0/autocompleteCharging station charge pass autocomplete suggestions Suggest charge passes as the user types
- GET/chargingstation/brand/1.0/listCharging station brands List charging networks
- GET/chargingstation/brand/autocomplete/1.0Pool brand autocomplete suggestions Suggest charging networks as the user types
- GET/chargingstation/filter/autocomplete/1.0Charging station filters autocomplete suggestions Suggest charging station filters
- GET/chargingstation/connector/list/1.0Connector list of charging station List connector types
Charging time and cost
How long a vehicle needs to charge from one level to another, and what it will cost at a given station.
Electric vehicle database
BeNomad's database of electric vehicles: brands, models, motor types, WLTP data, battery capacity, charging speed, photos and logos.
- GET/vehicle/1.1/findvehiclesFind vehicles (GET) · v1.1 Search the electric vehicle database
- POST/vehicle/1.1/findvehiclesFind vehicles (POST) · v1.1 Search the electric vehicle database
- GET/vehicle/1.1/getbrandsVehicle brands · v1.1 List vehicle brands
- GET/vehicle/1.1/getmotortypesVehicle motor types · v1.1 List motor types
- GET/vehicle/1.1/getlevelvehicleinfoGet level vehicle info · v1.1 · GET Fill a vehicle picker, step by step
- POST/vehicle/1.1/getlevelvehicleinfoGet level vehicle info · v1.1 · POST Fill a vehicle picker, step by step
- GET/vehicle/1.1/getbrandlogoVehicle brand logo object Get a brand logo
- GET/vehicle/1.1/getbrandlogoliteVehicle brand logo in byte Get a brand logo, ready to display
- GET/vehicle/picture/1.0/getallVehicle pictures Get the pictures of a vehicle
- GET/vehicle/picture/1.0/getoneVehicle picture Get one picture of a vehicle
- GET/vehicle/picture/1.0/getviewsAvailable vehicle views List the angles of a vehicle's pictures
- GET/evsmartrouting/vehiclebrands/list/1.0EV vehicle brands List vehicle brands for trip planning
- GET/evsmartrouting/vehiclemodels/list/1.0EV vehicles (GET) List vehicle models for trip planning
- POST/evsmartrouting/vehiclemodels/list/1.0EV vehicles (POST) List vehicle models for trip planningDeprecated
- GET/vehicle/1.0/findvehiclesFind vehicles (GET) · v1.0 Search the electric vehicle databaseDeprecated
- POST/vehicle/1.0/findvehiclesFind vehicles (POST) · v1.0 Search the electric vehicle databaseDeprecated
- GET/vehicle/1.0/getbrandsVehicle brands · v1.0 List vehicle brandsDeprecated
- GET/vehicle/1.0/getmotortypesVehicle motor types · v1.0 List motor typesDeprecated
- GET/vehicle/1.0/getlevelvehicleinfoGet level vehicle info · v1.0 Fill a vehicle picker, step by stepDeprecated
Search
Addresses from text, coordinates from addresses and back, one at a time or in batches.
Geocoding
An address, structured or free text, turned into coordinates: one at a time, as you type, or in batch.
Reverse geocoding
Coordinates turned into a readable address, one at a time or in batch.
Map context
What lies around a position or a route: points of interest, geofences, the road network of an area, live traffic, the weather, and currency conversion for costs.
Near POI
Points of interest around a place, limited by the distance to drive or walk to them.
Geofencing
Whether assets are inside or outside the areas you define.
Roads extractor
Every road segment inside a polygon, filtered by transport mode: the input of a tour that covers a whole zone.
Traffic
Live traffic events and flow for an area.
Weather
Current weather and forecasts at a place.
Currency
Exchange rates and conversions, for costs in the reader's currency.
- GET/currency/1.0/codesCurrency rates · codes List currencies
- GET/currency/1.0/ratesCurrency rates Get all exchange rates
- GET/currency/1.0/rateCurrency single rate Get one exchange rate
- GET/currency/1.0/convertCurrency convert · GET Convert an amount to another currency
- POST/currency/1.0/convertCurrency convert · POST Convert an amount to another currency
Map rendering
Map images over the OGC Web Map Service. BeNomad Tiles, the vector map, has a host and an API of its own.
Older versions
- GetMap service · 1.1.1
- GetCapabilities service · 1.1.1
- GetFeatureInfo service · 1.1.1
- REST API, BND version 0.9 (Deprecate see WMS API)