API

All questions answered about our API. Learn about our vehicles, stations, routes, tile service, vehicle connectivity, isolines and navigation modules and our white label.

Vehicle

  • Is it possible to reduce the image file size?
    • We provide thumbnail and high-resolution files only. The client side is responsible for scaling the high-resolution image if needed.

  • Do you recommend using the chargetripRange field instead of WLTP?
    • Both wltp and chargetrip_range are estimates. WLTP is a testing cycle that vehicle manufacturers use and their estimation is usually high. ChargetripRange comes from our own research. We recommend it, of course, but ultimately it’s up to you!

  • What is the difference between vehicle and vehiclePremium?
    • vehiclePremium shows you all data we have on the vehicles in our database. It also allows you to cache this vehicle data.

  • What vehicles do you have in your database?
    • We have over 558 EVs in our database and are constantly adding more! You can find all the vehicles in our database here. You can also find the vehicles that we are expecting to add soon. Still missing a vehicle? Be sure to let us know in the chat or via email.

Station

  • Do you offer any roaming agreements through Chargetrip?
    • We specialise in EV routing and range predictions and unfortunately don’t offer any roaming agreements.

  • Station data is incorrect how can I report this?
    • Please let us know what data is incorrect by sending us an email with the following data points:

      • station ID

      • Problem

      • Urgency

      • Context

  • Are you OCPI compliant?
    • Yes we are! We are currently using the OCPI 2.1.1 version

  • Can I see alternative stations along a planned route?
    • Yes. While our route calculates the best charging stations for you and your vehicle — you can also view alternative stations. Simply add the stationsAlongRouteRadius flag to your newRoute mutation, and set the search radius in meters (the max is 5 km). Make sure to also add stationsAlongRoute to your route query. For more information, please see our documentation and examples.

  • Do you also show the station ID from the station database provider?
    • Yes. We show an external ID next to the Chargetrip ID. You can find it under the external_id property. We receive this ID from an external data source.

  • What do you define as slow, fast, and turbochargers?
      • Slow: < 43 kW

      • Fast: 43 kW - 150 kW

      • Turbo: 150 kW >

  • Why is the availability UNKNOWN?
    • Unknown appears when we do not know the status of a charger. It could be free, busy or broken.

  • Why do you only consider fast and turbochargers in your routing?
    • When calculating routes we only include chargers of 43 kW or more. This reduces charging time and thus creates faster routes.

  • Which connector types are available?
    • You can find a list of all connectors in our schema, under OCPIConnectorType. The list updates when new connectors become available.

  • Do you have different levels of preferred operators?
    • Yes! You can have up to 10 levels of preference. You also have the ability to exclude operators. Read more about this in our documentation and check out this example to try it yourself.

  • Why do I not see the name of my company’s (CPO) charging stations?
    • Charging station names flow from our station database. They receive these names either from the CPO itself or an intermediate party. Unfortunately, we’re not able to change the names of stations.

Route

  • Do you offer a back office and payment solution?
    • At Chargetrip we specialise in EV routing and range predictions! So we unfortunately don’t offer any back office and payment solutions.

  • How long does it take to integrate routing into my application?
    • This depends on your particular use case, but we wrote an article about how you can add the basics in just three weeks!

  • Can I show alternative routes?
    • Definitely. Just add alternatives to your route query, with all the parameters you want from your alternative routes.

  • How do I share a route calculated with the Chargetrip API to a navigation application?
    • A route calculated with the Chargetrip API can be exported to any navigation application. You must export the charging stations as waypoints. Google or similar navigation software will then display the charging stations as waypoints along the route.

  • Why is my desired final state of charge not reached on my route?
    • When calculating your journey, we find chargers along the route to meet your desired final state of charge best. However, sometimes we are not able to find a station close enough to fulfill your request. For example, that can happen when chargers are too far away from the route.

  • How can I best decode a polyline?
    • There are different tools available online. In the examples, we use the Mapbox polyline package. It is essential to look at the order in which latitude and longitude are returned. In some cases, you might need to flip the coordinates before plotting them on your map.

  • Is it possible to avoid toll roads when requesting a route?
    • No, this isn’t supported yet. But we’re working on it! In the meantime, you can show if a route had toll roads with route steps. Read more about this in our documentation.

  • Can I add a waypoint to my route?
    • You can add waypoints to your route by adding the via property to your route request. For more information, please take a look at our documentation.

  • Do you recommend using a subscription or a query for routes?
    • We recommend that you subscribe to route updates, and unsubscribe when a route has reached a final status. For more information, consult our documentation and examples.

  • Do you account for traffic in your route calculations?
    • We do not take traffic into account when calculating routes. The impact of traffic on your consumption is minimal.

  • Do you consider road closures?
    • Yes, Chargetrip considers road closures. Most road closures are added automatically to OSM. We also offer the ability to add road closures manually. We can close a road permanently or for a specific date, for example, when a road is closed during winter. If you are still missing a road closure, please reach out to our support team.

Tile Service

  • Can I build an MVP without using Chargetrip’s tile server? We don’t want to use Mapbox.
    • Yes, this is possible! You can see how to use our Tile service with a different mapping provider in this example.

  • How do I filter stations?
    • You can add a set of filters to the tile request. These filters are sent as query parameters. To request a tile you must have a combination of connectors and powers. For more information, refer to our examples and documentation.

White Label

  • Which platform does the White Label support?
    • We have a web white-label and a mobile white-label that runs on IOS and Android.

  • What can I customize?
    • Together with our developers, we will add your branding and feel to the application. We can also configure operator preferences and much more.

  • How long does it take to get the White Label up and running?
    • You can go live within eight weeks from initial contact to launch. We will, of course, always be available for support.

Vehicle Connectivity

  • What data providers can be used with Connect?
    • Chargetrip is data vendor agnostic and works with leading connected vehicle and telemetry data providers. Connect currently comes pre-integrated with Enode, and we are actively working on integrating with more data providers.

  • Which vehicles do you support for Connect?
    • Check out this page to view a complete list of vehicles available for Connect!

  • How can I start using connected vehicle data?
    • Great to hear that you’re interested in Chargetrip Connect. Drop us an email, and we will get you set up and ready to go!

  • Can I bring my own data provider?
    • We are data vendor agnostic and would love to learn more about your data provider to see how we could fit together. Please send us an email to learn more about our custom data integration flow.

  • Does Chargetrip offer turn-by-turn navigation?
    • Yes, we do! Our navigation module is currently out in beta and ready for you to use. Read more about it in our documentation or plan a demo to hear about it in person.



Isoline

  • Are isolines available in the White Label
    • Yes, they are! You can go to Chargetrip GO to create your own isolines right now. Simply search for a location and pick your desired vehicle. After a few seconds, you'll see far your vehicle can take you.

  • What are isolines?
    • With isolines, you can visually see the range of a vehicle from a certain point on the map. It will show you how far you can get with your EV and can significantly help combat range anxiety.

      Read more about isolines in our documentation, or try them for yourself in Chargetrip GO.