### Basic Filter Syntax Example Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This example shows the basic syntax for defining a filter within the 'filters' parameter. It illustrates how to specify a condition, such as filtering by brand, using a simple string format. ```json "filters": [ "pool.brand == Tesla" ] ``` -------------------------------- ### BeNomad Charging Station Search Request Example Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters An example of a BeNomad search request using JSON. It specifies the geoserver, providers, search mode ('LOCAL_OR_REMOTE'), search radius, coordinates, and options for retrieving charging station data. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 1000, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POINT"] } ``` -------------------------------- ### Example Request with PATH_POOL_MAP Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example API request demonstrating the use of PATH_POOL_MAP. This request specifies a geoserver, provider, mode, radius, coordinate, and the PATH_POOL_MAP option to retrieve minimal pool data for map display. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 3000, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POOL_MAP"] } ``` -------------------------------- ### Example API Request with routesheetMode Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This JSON example illustrates a complete API request for routing, including the 'routesheet' and 'routesheetMode' parameters set to 'TEXT_DETAILS'. It specifies vehicle details, start and stop locations, and routing preferences. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "routesheet": true, "routesheetMode": "TEXT_DETAILS", "routesheetLanguage": "en" }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Example Request with PATH_POOL Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example Benomad API request configured with the PATH_POOL option. It includes parameters for geoserver, providers, mode, radius, and coordinate, aiming to fetch complete pool-level data for charging stations. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 300, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POOL"] } ``` -------------------------------- ### Full Routing Request Example with NA Status Enabled Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This comprehensive JSON example illustrates a complete routing request, including the `allowNaStatus: true` setting in the `condition` block. It specifies vehicle details, start and end points, and routing preferences, demonstrating a practical application of the feature. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "allowNaStatus": true }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Example Benomad API Request with Connector Types Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options This example demonstrates a complete Benomad API request that includes the `AVAILABLE_CONNECTOR_TYPES` option. The request specifies provider details, location, and the option to retrieve connector types, which will be reflected in the response. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 300, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["AVAILABLE_CONNECTOR_TYPES"] } ``` -------------------------------- ### Example Response with PATH_STATION Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example API response when the PATH_STATION option is active. The response provides a list of pools, each containing station-level details such as provider name, ID, location, name, status, and a summary of charging station information. ```json { "pools": [ { "providerName": "ecoMovement", "providerMode": "LOCAL", "id": "8f709a26-466d-11e9-8601-42010a840003", "sourceProvider": "Tesla Destination", "updateDate": 1753672005588, "brand": "Tesla Destination", "nameOfPool": "Tesla Destination Charger Relais Christine", "accessibility": "RESTRICTED", "availabilityStatus": "NA", "longitude": 2.34014219, "latitude": 48.8543694, "countryCode": "FRA", "country": "FRA", "postalCode": "75006", "city": "6e Arrondissement", "street": "3 Rue Christine", "siteCategory": "ON_STREET", "phoneNumber": "+(33)-(9)-70730850", "chargingStations": [ { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false } ], "summaryOfConnectorTypeIds": [ 32 ], "maxNominalPower": 11, "numberOfChargingPoint": 3 } ] } ``` -------------------------------- ### Station Configuration Example Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options This snippet shows a sample configuration for a charging station, including details about its current type, voltage, amperage, and power. It also lists associated connector types. ```json { "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ``` -------------------------------- ### Example API Request with Corridor Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This example demonstrates a complete API request object that includes the 'corridor' parameter for searching charging stations along a route, along with other parameters like 'geoserver', 'providers', 'mode', 'options', and 'radius'. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "options": ["PATH_POINT"], "radius": 1000, "corridor": [ { "lat": 48.85693, "lon": 2.3412 }, { "lat": 49.0097, "lon": 2.5479 } ] } ``` -------------------------------- ### Example API Request with PATH_POINT Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example of a complete API request configured to use the PATH_POINT option. It specifies search parameters like location, radius, and providers, along with the option to fetch detailed charging point data. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 1000, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POINT"] } ``` -------------------------------- ### Example Request with PATH_STATION Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example API request utilizing the PATH_STATION option. This request is configured to retrieve station-level information, including location and basic details, for a specified radius and coordinate. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 300, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_STATION"] } ``` -------------------------------- ### Example API Response with PATH_POINT Data Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options A sample API response demonstrating the detailed information returned when the PATH_POINT option is enabled. It includes nested structures for charging stations and individual charging points with their specifications. ```json { "pools": [ { "providerName": "ecoMovement", "providerMode": "LOCAL", "id": "8f709a26-466d-11e9-8601-42010a840003", "sourceProvider": "Tesla Destination", "updateDate": 1753672005588, "brand": "Tesla Destination", "nameOfPool": "Tesla Destination Charger Relais Christine", "accessibility": "RESTRICTED", "availabilityStatus": "NA", "longitude": 2.34014219, "latitude": 48.8543694, "countryCode": "FRA", "country": "FRA", "postalCode": "75006", "city": "6e Arrondissement", "street": "3 Rue Christine", "siteCategory": "ON_STREET", "phoneNumber": "+(33)-(9)-70730850", "chargingStations": [ { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_1", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_1_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_0", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_0_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_2", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_2_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, ``` -------------------------------- ### Example Benomad Routing Request with Weather (JSON) Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This comprehensive JSON example illustrates a full Benomad routing request, including the configuration for weather data. It specifies the start and end points, vehicle details, and importantly, enables weather data retrieval by setting 'weather' to true and 'weatherProvider' to 'owm'. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "weather": true, "weatherProvider": "owm" }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Example Response with PATH_POOL_MAP Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example API response when using the PATH_POOL_MAP option. The response contains a list of pools, with each pool object including only essential details like ID, availability status, longitude, latitude, and max nominal power. ```json { "pools": [ { "id": "8f709a26-466d-11e9-8601-42010a840003", "availabilityStatus": "NA", "longitude": 2.34014219, "latitude": 48.8543694, "maxNominalPower": 11 } ] } ``` -------------------------------- ### Example API Request with Coordinate and Radius Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This example demonstrates a complete API request for finding charging stations. It includes the 'coordinate' parameter to set the search center and 'radius' to define the search area, along with provider and mode configurations. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "options": ["PATH_POINT"], "radius": 1000, "coordinate": { "lat": 48.85693, "lon": 2.3412 } } ``` -------------------------------- ### Full Request with Providers and Options Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This example shows a complete API request configuration including the 'providers' parameter to select 'ecoMovement', along with other parameters like 'geoserver', 'mode', 'radius', 'coordinate', and 'options'. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 1000, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POINT"] } ``` -------------------------------- ### BeNomad Charging Station Search Response Example Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters A sample BeNomad response detailing charging station information. It includes provider details, station location, availability, and charging point specifications like connector type, power, voltage, and amperage. ```json { "pools": [ { "providerName": "ecoMovement", "providerMode": "LOCAL", "id": "8f709a26-466d-11e9-8601-42010a840003", "sourceProvider": "Tesla Destination", "updateDate": 1753672005588, "brand": "Tesla Destination", "nameOfPool": "Tesla Destination Charger Relais Christine", "accessibility": "RESTRICTED", "availabilityStatus": "NA", "longitude": 2.34014219, "latitude": 48.8543694, "countryCode": "FRA", "country": "FRA", "postalCode": "75006", "city": "6e Arrondissement", "street": "3 Rue Christine", "siteCategory": "ON_STREET", "phoneNumber": "+(33)-(9)-70730850", "chargingStations": [ { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_1", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_1_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_0", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_0_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] }, { "nature": "VGROUP", "availabilityStatus": "NA" } ] } ] } ``` -------------------------------- ### Example GeoServer Request with Location Data Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This example shows a complete JSON request for a charging station service, including the 'geoserver' parameter set to 'osm'. It also includes other relevant parameters like 'providers', 'mode', 'radius', 'coordinate', and 'options' for location-based queries. ```JSON { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 500, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POINT"] } ``` -------------------------------- ### Example Request with PATH_POINT_MAP and Connector Filter Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_options An example Benomad API request utilizing the PATH_POINT_MAP option. It specifies a geoserver, provider, mode, radius, coordinate, and filters for connector ID 32. This configuration is suitable for displaying charging pools on a map with performance optimization and specific filtering. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 300, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POINT_MAP"], "connectorIdFilters": [32] } ``` -------------------------------- ### Example GeoServer Response with Charging Station Data Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This JSON snippet represents a typical response from a charging station service when using a specified geoserver. It includes details about charging pools, individual charging stations, their availability, location, and connector types. ```JSON { "pools": [ { "providerName": "ecoMovement", "providerMode": "LOCAL", "id": "8f709a26-466d-11e9-8601-42010a840003", "sourceProvider": "Tesla Destination", "updateDate": 1753672005588, "brand": "Tesla Destination", "nameOfPool": "Tesla Destination Charger Relais Christine", "accessibility": "RESTRICTED", "availabilityStatus": "NA", "longitude": 2.34014219, "latitude": 48.8543694, "countryCode": "FRA", "country": "FRA", "postalCode": "75006", "city": "6e Arrondissement", "street": "3 Rue Christine", "siteCategory": "ON_STREET", "phoneNumber": "+(33)-(9)-70730850", "chargingStations": [ { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_1", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_1_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_0", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_0_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] }, { "nature": "VGROUP", "availabilityStatus": "NA", "chargePasses": [ { "id": "Tesla", "title": "Tesla", "networkName": "Tesla" } ], "bookable": false, "chargingPoints": [ { "id": "491848_2", "availabilityStatus": "NA", "type": 32, "connectorTypes": [ { "id": 32, "key": "TYPE_2-ATTACHED_CABLE", "operatorId": "491848_2_0", "deprecated": false, "name": "Type 2", "norm": "IEC 62196 Type 2 (Mennekes)", "maxPower": 43, "power": 11, "voltage": 230, "ampere": 16, "acSingle": false, "acThree": true, "dc": false, "cable": true } ], "currentType": "AC_THREE_PHASES", "voltage": 230, "ampere": 16, "power": 11 } ] } ] } ] } ``` -------------------------------- ### Complete Charging Station API Request Example Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/first_chargingstation_request A full example of a Charging Station API request combining all configured parameters for searching EV charging stations. ```json { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 300, "coordinate": { "lon": 2.3412, "lat": 48.8569 }, "options": ["PATH_POINT"] } ``` -------------------------------- ### Example Request Payload with CO2 Emissions (JSON) Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This is an example of a complete request payload for the routing engine, including the 'co2emissions' flag set to true. It specifies vehicle details, start and stop points, and routing preferences. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "co2emissions": true }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Full Routing API Request Example Source: https://docs.benomad.com/api-reference/routing/tutorial/routing_1introduction A comprehensive example of a routing API request, combining destinations, options, routing criteria, and vehicle profile configurations. ```JSON { "destinations": [ { "coordinateSat": { "lon": 2.38261, "lat": 48.85356 } }, { "coordinateSat": { "lon": 4.35631, "lat": 50.84531 } } ], "options": [ "POLYLINE" ], "routingCriterias": [ "AVOID_FERRIES", "AVOID_TOLLS" ], "routingVehicleProfile": { "transportMode": "CAR", "routingVehicleFeature": { "height": "190", "width": "230", "length": "1875", "weight": "35", "axleWeight": "10" } } } ``` -------------------------------- ### Example Routing Request with ECO Driving Style Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition A complete routing request example utilizing the 'ECO' driving style. It includes vehicle initialization, start/stop points, and routing conditions, demonstrating a practical application of the drivingStyle feature. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "drivingStyle": { "mode": "ECO" } }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Routing Instructions Example Source: https://docs.benomad.com/api-reference/traceroute/tutorial/traceroute_parameters This snippet demonstrates a typical routing instruction, detailing maneuvers, road names, and distances. It's part of a larger navigation sequence. ```JSON { "type": "EXIT_ROUNDABOUT", "geoElementType": "ROUNDABOUT", "length": 50, "duration": 11, "fromName": "Carrefour du Golf", "manoeuvre": "RIGHT", "coordinate": { "lon": 7.07093, "lat": 43.61741 }, "roundAboutExitNumber": 2, "toName": "D504", "toOn": "Route des Colles", "toRn": "D504", "textDist": "À 50 mètres" } ``` -------------------------------- ### Example Request with adjustEta Source: https://docs.benomad.com/api-reference/traceroute/tutorial/traceroute_parameters This example demonstrates a full request payload with `adjustEta` enabled. It includes routing vehicle profile details, options, and a list of destinations with `coordinateSat` objects containing `time` for ETA adjustment. ```json { "adjustEta": true, "routingVehicleProfile": { "transportMode": "CAR", "routingVehicleFeature": { "height": 380, "width": 40, "length": 1875, "weight": 35 } }, "options": ["ROUTESHEET", "POLYLINE"], "destinations" : [ { "coordinateSat" : { "lon" : 7.066, "lat" : 43.616, "heading" : 17.6, "speed" : 23.1, "time" : 1396241966000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0664, "lat" : 43.6162, "heading" : 95.0, "speed" : 29.3, "time" : 1396241972000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0786, "lat" : 43.6153, "heading" : 119.0, "speed" : 61.9, "time" : 1396242062000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0805, "lat" : 43.6147, "heading" : 200.9, "speed" : 50.6, "time" : 1396242077000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0785, "lat" : 43.6117, "heading" : 115.8, "speed" : 38.1, "time" : 1396242104000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0787, "lat" : 43.6118, "heading" : 15.6, "speed" : 26.0, "time" : 1396242107000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0793, "lat" : 43.6128, "heading" : 76.0, "speed" : 26.6, "time" : 1396242128000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0814, "lat" : 43.6116, "heading" : 269.9, "speed" : 5.6, "time" : 1396242172000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0811, "lat" : 43.6117, "heading" : 338.7, "speed" : 7.5, "time" : 1396242182000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0812, "lat" : 43.6119, "heading" : 47.3, "speed" : 14.9, "time" : 1396241966000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0815, "lat" : 43.6119, "heading" : 127.1, "speed" : 8.5, "time" : 1396242198000, "sat" : 11 } }, { "coordinateSat" : { "lon" : 7.0816, "lat" : 43.6118, "heading" : 0.0, "speed" : 0.0, "time" : 1396242288000, "sat" : 11 } } ] } ``` -------------------------------- ### Example Routing Request with Speed Ponderations Source: https://docs.benomad.com/api-reference/routing/tutorial/routing_vehicleprofile This example shows a complete routing request that includes the routingSpeedPonderations configuration. It defines destinations and the vehicle profile with custom speed settings for different road types. ```json { "destinations": [ { "coordinateSat": { "lon": 4.8357, "lat": 45.7640 } }, { "coordinateSat": { "lon": 4.8270, "lat": 45.7580 } } ], "options": ["POLYLINE"], "routingVehicleProfile": { "transportMode": "CAR", "routingSpeedPonderations": [ { "factor": 0.8, "level": 4, "pondType": "ETA", "roadType": "ROUNDABOUNT" }, { "factor": 1.2, "level": 1, "pondType": "CAL", "roadType": "MOTORWAY" } ] } } ``` -------------------------------- ### Example Benomad search request with radius and coordinate (JSON) Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/chargingstation/tutorial/chargingstation_parameters This example demonstrates a typical Benomad API request using JSON. It includes the 'radius' parameter to define a circular search area around a specified 'coordinate'. Other parameters like 'geoserver', 'providers', 'mode', and 'options' are also shown. ```JSON { "geoserver": "osm", "providers": ["ecoMovement"], "mode": "LOCAL_OR_REMOTE", "radius": 500, "coordinate": { "lat": 48.85693, "lon": 2.3412 }, "options": ["PATH_POINT"] } ``` -------------------------------- ### Place Coordinates Example Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/evsmartrouting A JSON object representing geographical coordinates for a location, used for specifying start, stop, or via points in routing requests. ```JSON { "lon": 5.0415, "lat": 47.3220 } ``` -------------------------------- ### TraceRoute Request with Waypoints and Offroad Options Source: https://docs.benomad.com/api-reference/traceroute/tutorial/traceroute_options An example of a complete TraceRoute request configuration that includes destination coordinates, routing vehicle profile, and the 'WAYPOINTS' and 'OFFROADS' options. This setup is used to identify off-road segments between GPS points. ```json { "destinations": [ { "coordinateSat": { "lon": 2.3470, "lat": 48.8540, "speed": 25.0, "time": 1720519200000 } }, { "coordinateSat": { "lon": 2.3499, "lat": 48.8582, "speed": 32.0, "time": 1720519260000 } } ], "routingVehicleProfile": { "transportMode": "CAR", "routingVehicleFeature": { "height": 150, "width": 50, "length": 420, "weight": 1400 } }, "options": ["WAYPOINTS", "OFFROADS"] } ``` -------------------------------- ### Full JSON Request with Encoded Geometry Enabled Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This example shows a complete JSON request for routing, including the `encodedGeometry: true` setting in the `condition` block. It specifies vehicle details, start and end points, and routing preferences. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "encodedGeometry": true }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Example Configuration with SKIP_EMPTY_STREETNAME Source: https://docs.benomad.com/api-reference/geocoding/tutorial/reversegeocoding_options An example of a complete configuration object that includes the SKIP_EMPTY_STREETNAME option. This configuration specifies transport mode, coordinates, radius, language, and the desired option. ```JSON { "geoserver": "here", "transportMode": "CAR", "maximumResults": 5, "coordinateSat": { "lon": 2.3412, "lat": 48.85693 }, "radius": "1000", "language": "on", "options": ["SKIP_EMPTY_STREETNAME"] } ``` -------------------------------- ### Benomad API Request with Route Details Enabled Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This is a comprehensive example of a Benomad API request configured to analyze a route with detailed information enabled. It includes vehicle specifics, start and end points, and the 'routeDetails' condition set to true. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "routeDetails": true }, "routingVehicleProfile": { "transportMode": "CAR" } } ``` -------------------------------- ### Example Request with routeDetailsFreq Source: https://docs.benomad.com/api-reference/ev-move---electric-mobility/evsmartrouting/tutorial/evsmartrouting_condition This example shows a complete JSON request for routing, including the configuration for route event details and a frequency of 30 seconds. It specifies vehicle details, start/stop points, and routing profiles. ```json { "geoserver": "osm", "csps": ["ecoMovement"], "vehicle": { "initBatLvl": 100, "key": "eb1e9464-8654-4c01-bedd-b2f95412a60d", "payload": 75 }, "routingMode": "MODE_VIAS", "start": { "lon": 2.34755, "lat": 48.85708 }, "stop": { "lon": 4.35497, "lat": 50.83857 }, "condition": { "minBatLvl": 10.0, "routeDetails": true, "routeDetailsFreq": 30 }, "routingVehicleProfile": { "transportMode": "CAR" } } ```