JouloDocs
Api referenceEnergy

Fast chargers along a driven route

Fast chargers within 1.5 km of the driven route between two places in the Netherlands, cheapest first for a session of kwh. Joulo asks Google Routes for the route by car, without traffic, and sends it only the two coordinates. km_from_start says how far along the route a stop lies; off_route_m is the straight distance from the route, not the detour by road. With after_km and before_km only stops on that stretch count. Any personal token may call it. One account gets a burst of 5 routes, then one per 15 minutes (429).

GET
/public-chargers/route
AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

Query Parameters

fromstring

Where the trip starts: a postcode, an address or a town in the Netherlands.

Lengthlength <= 100
tostring

Where the trip ends.

Lengthlength <= 100
kwh?number

The kWh the car charges at the stop.

Default30
Range1 <= value <= 150
after_km?number

Only stops at least this many km from the start.

Range0 <= value <= 1000
before_km?number

Only stops at most this many km from the start.

Range0 <= value <= 1000
max_results?integer

How many stops, cheapest first.

Default5
Range1 <= value <= 10

Response Body

curl -X GET "https://api.joulo.nl/functions/v1/api/public-chargers/route?from=string&to=string&kwh=30&after_km=0&before_km=0&max_results=5"
{
  "from": "string",
  "to": "string",
  "distance_km": 0,
  "drive_minutes": 0,
  "kwh": 0,
  "after_km": 0,
  "before_km": 0,
  "found_along_route": 0,
  "count": 0,
  "sort": "total_cost",
  "locations": [
    {
      "party_id": "string",
      "location_id": "string",
      "km_from_start": 0,
      "off_route_m": 0,
      "session_cost": {}
    }
  ],
  "notes": [
    "string"
  ]
}
Empty
Empty
Empty
Empty