EV Navigation's range and route calculation features are accessible through this API.

API Functions

Call this api endpoint to get list of supported ECars.
This api endpoint plans a route with charging stops between waypoints.
This api endpoint calculates a range polygon around a given geocoordinate.

Member Documentation

Get supported ECars list

Call this api endpoint to get list of supported ECars.

Method
GET
Parameter
Response

[
    {
        "id": 136,
        "name": "VW e-Crafter (2018)",
        "type": "volkswagen",
        "topspeed": 90,
        "totalpower": 100,
        "factory_range": 115,
        "designcapacity": 35.8,
        "chargertypes": "[1, 6]",
        "subtype": null,
        "range_source": "WLTP"
    },
    ...
]
                    
Example
https://api.evnavigation.com/v2/getecars?key=API_KEY

Plan Route

This API endpoint plans a route with charging stops between waypoints.

Method
GET
Parameter
carId
ID of the e-car
SOC
State of charge of the e-car (0-100%)
passengerNumber
Number of people in the car
minSOCAtDestination
Minimum SOC you would like to have upon arrival
minSOC
Minimum SOC during the trip
waypoint
Lat lon pairs of waypoints (e.g., 47.497913,19.040236|52.34456,12.540893)
tollroads
Allow tollroads usage (0 or 1)
ferries
Allow ferries usage (0 or 1)
highways
Allow highways usage (0 or 1)
Response

{
    "route": [
        {
            "lat": 47.497913,
            "lon": 19.040236,
            "soc": 95.0, // SOC in percentage
            "maxSpd": 50,
            "battMaxSpd": 0,
            "alt": 120.5,
            "jam": -1
        },
        ...
    ],
    "routeData": {
        "lengthMeters": 13191.754934,
        "durationMinutes": 65,
        "chargeTimeMinutes": 50,
        "stopsCount": 1
    },
    "chargingStations": [
        {
            "lat": 47.52276,
            "lon": 19.413905,
            "maxPower": 50.0,
            "chargeTimeMinutes": 35
        }
    ],
    "turns": [
        {
            "startIdx": 7,
            "endIdx": 3,
            "roundaboutExit": 0,
            "lengthMeters": 651.832335,
            "laneInfo": false
        },
        ...
    ],
    "chargeplan": [
        {
            "startSOC": 16,
            "endSOC": 90,
            "chargeTimeMinutes": 35,
            "distanceMeters": 844,
            "plugType": 1
        }
    ],
    "routeSegments": [
        {
            "maxSpeed": 130,
            "startPointIdx": 0,
            "endPointIdx": 8,
            "middlePointIdx": 3
        },
        ...
    ],
    "waypointsInfo": [
        {
            "country": "Germany",
            "county": "Berlin",
            "city": "Berlin",
            "district": "Mitte",
            "street": "Karl-Liebknecht-Straße",
            "houseNumber": ""
        },
        ...
    ],
    "temperature": 12,
    "weatherCode": 4,
    "wind": [
        {
            "coords": [47.21875, 17.402344],
            "dirDeg": -19.915674,
            "spdMps": 2.341848
        },
        ...
    ],
    "calcTimeMs": 88
}
                        
Example
https://api.evnavigation.com/v2/planroute?carId=38&SOC=100&passengerNumber=4&minSOCAtDestination=20&minSOC=15&waypoints=47.497913,19.040236|48.210033,16.363449&tollroads=1&ferries=0&highway=1&key=API_KEY

Range calculation

This API endpoint calculates a range polygon around a given geocoordinate.

Method
GET
Parameter
carId
ID of the e-car
SOC
State of charge of the e-car (0-100%)
passengerNumber
Number of people in the car
speedLimit
Maximum speed on highways
batteryReserved
SOC value of the inner polygon (e.g., 50%)
position
Lat lon pair of the current position (e.g., 52.520008, 13.404954)
tollroads
Allow tollroads usage (0 or 1)
ferries
Allow ferries usage (0 or 1)
highway
Allow highways usage (0 or 1)
Response

{
    "rangeOuter": [
        [
            [53.041992, 13.392334],
            ...
        ]
    ],
    "rangeInner": [
        [
            [52.78656, 13.40332],
            ...
        ]
    ],
    "temperature": 12,
    "weatherCode": 4,
    "wind": [
        {
            "coordinates": [47.21875, 17.402344],
            "directionDegrees": -19.915674,
            "spd": 2.341848
        }
    ]
}
                        
Example
https://api.evnavigation.com/v2/rangecalculation?carId=69&SOC=80&passengerNumber=3&speedLimit=120&batteryReserved=50&position=52.520008,13.404954&tollroads=1&ferries=0&highway=0&key=API_KEY