API

Get all your questions answered about our API. Learn about our vehicles, stations, routes, tile service, vehicle connectivity, isolines and navigation modules.

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, whereas the chargetrip_range is using a drive cycle that's based on real-world driving data. We recommend it, of course, but ultimately it’s up to you! More information on the CT range can be found at https://chargetrip.com/blog/what-is-ct-real-range

    What is the difference between vehicle and vehiclePremium?
    • vehiclePremium provides you with even more data on your vehicles. Additional fields include: the tire pressure, prices, drivetrain data, and more. Please contact us to get access to premium 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

    Does Chargetrip have a station database?
    • All of our accounts come pre-integrated with the Eco-Movement station database! They have great coverage of Europe and North-America.

      We are also able to integrate with a customer station database if you can supply us with the data ☀️

    How do I add preferred operators to my project in the dashboard?
    • You can add preferred or excluded operators to your project by navigating to ‘advanced settings’ on the project and scrolling down, where you can click 'update' in the operator section. Simply pick the operator, give them a level of preference, and don’t forget to save! Your new selection will take affect after 30 minutes.

    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.

      This is an example of a filter on powerGroups:

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 no-code solutions?
    • 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.