Release notes

With every update we write release notes. This way you know what has been fixed or what has been added.

4.26.0 - Introduction of Connect

⚡️ New features

  • Added connect to the car, carList and carPremium queries. Chargetrip is even more powerful when connected to telemetry data. Therefore, you can now request the connected car platforms that are supported per vehicle.

✨ Improvements

  • Improved the performance of the stationStats query

🐞 Bug fixes

  • Fixed a bug where we did not expose max_electric_power on the car query
  • Fixed a bug where if the user did not send the State of Charge, the value from the battery capacity was used instead of defaulting to 100% State of Charge

4.25.0 - Addition of SoC to routePath and pathPlot

⚡️ New features

  • Added support for exposing the state of charge on routePath and pathPlot.

🐞 Bug fixes

  • Fixed a bug where if the first stop was a via, the station id inside the leg field was an empty string instead of null.
  • Fixed a bug on navigation where a route without charges included the feature point of the destination on next_station.
  • Fixed a bug where the polyline for legs and steps of a route was missing the final point.

4.24.0 - Introduction of RouteStep walking

⚡️ New features

  • Added type walking to RouteStep to easily identify if the origin, via or destination is unreachable by car.

✨ Improvements

  • Improved the stationAround and stationList queries by extending them with the following filters: Power, PowerGroups, Connectors or ConnectorType, AvailableOnly, PreferredOperator.
  • Improved the stationAround and stationList queries by allowing to search over amenities and properties.
  • Improved route mutation validation by including an error when the finalStateOfCharge exceeds 80% of the capacity.

🐞 Bug fixes

  • Fixed a bug on toll roads where the API did not expose the RouteStep type toll
  • Fixed the schema description on capacity

4.23.1 - Tile Service for all mapping providers

⚡️ New features

  • Added support for exporting the Tile Service as a JSON response, allowing you to display the response on the mapping provider of your choice. An example can be found over here.

✨ Improvements

  • Improved the file size of our images by switching to a new image compressor.

🐞 Bug fixes

  • Fixed a bug on error code CLIENT_AUTH_MANDATORY where it used to extend with HttpNotAllowed instead of the correct HttpForbidden.

4.22.1 - Desired final state of charge fix

🐞 Bug fixes

  • Fixed a bug on the desired final state of charge of the battery, where the actual final state of charge did not match the provided final state of charge.

4.22.0 - Validation state of charge

⚡️ New features

  • Added the new query navigation and included new mutations to update and recalculate a navigation session. Read more here.

✨ Improvements

  • Improved our validation of route mutations by enforcing the error when SoC is 0 or a negative value.

🐞 Bug fixes

  • Fixed a bug on via points, were optimisation rules were causing routes to fail in areas with a low density of stations.

4.21.0 - Turn-by-turn Navigation

⚡️ New features

  • Added the new navigation query and included new mutations to update and recalculate a navigation session. Read more here.

✨ Improvements

  • Improved the performance of the tile service

🐞 Bug fixes

  • Fixed a bug where route steps on legs had undefined ids.
  • Fixed a bug where route steps were shown as an empty array.
  • Fixed a bug where the polyline on route steps was an empty string.
  • Fixed a bug were the polyline on the leg was an empty string.

4.20.2 - Stability

⚡️ New features

  • Improved stability by fixing various small bugs

🐞 Bug fixes

  • Fixed a bug on station stats for new projects; now station stats are directly available after the creation of a new project

4.20.1 - App ID

⚡️ New features

  • Added the app id in the response
  • Added an error message for an incorrect app id

🐞 Bug fixes

  • Fixed a bug on station stats for new projects; now station stats are directly available after the creation of a new project

4.19.2 - Improved description

✨ Improvements

  • Improved the scheme descriptions for fast_charging_support
  • Improved stability by fixing various small bugs

🐞 Bug fixes

  • Fixed a bug in routing with OCPI-status BLOCKED. Status BLOCKED is no longer taken into account.

4.19.0 - External ids on via points

⚡️ New features

  • Added support for external ids on via points

✨ Improvements

  • Improved stability by fixing various small bugs

4.18.0 - Road characteristics

⚡️ New features

  • Added route steps to easily identify road characteristics like toll and ferries.
  • Added support for OCPI 2.2.1

✨ Improvements

  • Improved performance when creating a new client or updating cars.

4.17.1 - Manually flag road closures

⚡️ New features

  • Added the ability to manually flag road closures. We can manually close roads permanently or for a date range in regions where road closure data is seasonal or not available through traffic and incident API's.

🐞 Bug fixes

  • Fixed a bug in routing that caused the engine to consider the entry and exit ramp over the highway itself.

4.17.0 - Eco-movement pricing module

⚡️ New features

  • Added support for the Eco-movement pricing module. All our customers using the pre integrated Eco-movement database, can use pricing instead of tariff on EVSEs. We recommend customers to switch to the new pricing query. See pricing for more information.
  • Added operatorName and operatorRanking on routeLeg

🐞 Bug fixes

  • Fixed a bug in stationStats on the stations count grouped by amenities.

4.16.0 - Added mapping for Mapbox navigation SDK

Note
This release contains experimental features. They are not supported and may change, break, or disappear at any time.

⚡️ New features

  • Added the new query navigationMapping that converts a route to navigation instructions for a specified mapping provider. Currently Mapbox is supported, other mapping providers will follow.
  • Added an all new dark and light mode to the dashboard.
  • Added date range inputfields to the dashboard calendar dropdown.
  • Added the ability to remove your account from the dashboard.
  • Added the ability to remove your own projects from the dashboard.

✨ Improvements

  • Improved stability by fixing various small bugs

4.15.0 - Added operator ranking to best matching alternative route

⚡️ New features

  • Added operator ranking to bestMatching type. The best matching route is now a combination of operator and amenity preferences.

4.14.0 - WebSocket Protocol

⚡️ New features

  • Added support for the graphql-transport-ws protocol on our WebSocket. Learn more.

📦 Deprecations

  • Deprecated passengers in favor of occupants. See deprecations for more information.

4.13.0 - State management

✨ Improvements

  • Improved state management on the dashboard to remember filter and search states while navigating through pages.
  • Improved the performance of fetching project details.

🐞 Bug fixes

  • Fixed a bug on the dashboard where you were not able to enter certain domains as HTTP referrer.
  • Fixed a bug on the dashboard where an empty graph would sometimes scale on Firefox.

4.12.0 - Stability

✨ Improvements

  • Improved stability by fixing various small bugs.

4.11.0 - Station import improvements

✨ Improvements

  • Improved the station import by comparing old and new station data before adding or removing stations from the database.

🐞 Bug fixes

  • Fixed a bug on alternative routes where an error message was thrown when tariffs were requested.

4.10.0 - Configurable prioritized operators in the dashboard

⚡️ New features

  • Added the ability in the dashboard to prioritize operators on a project / x-client-id.

🐞 Bug fixes

  • Fixed a bug where the safeRiskMargin caused routes to fail when the SoC at origin was below the safeRiskMargin.

4.9.0 - Advanced project settings

⚡️ New features

  • Added the ability to automatically add cars to a project / x-client-id. Note: when enabled only new cars will be added. Cars that are currently available and not attached to a client will not be added.
  • Added the ability to set charge mode on a project / x-client-id
  • Added the ability to set charge stop duration on a project / x-client-id

4.8.0 - Merge into master

⏭ Onto the next one

  • In this release we honor Jay-Z. No new features, improvements or fixes. We are on to the next one.

4.7.0 - Security

⚡️ New features

  • Added the ability to restrict the use of client and application ids based on different security restrictions per platform. Read more here.
  • Added the ability to configure x-app-id security restrictions on the dashboard
  • Added the ability to customize the charge duration and charge mode on the x-client-id through the dashboard

4.6.0 - Under the hood

🛠 Refactoring

  • Some refactoring under the hood that needed to be launched.

4.5.0 - Range in percentages

⚡️ New features

  • Added the ability to query range in percentages on getRoute and use percentages as an input value. Please be aware when adding percentages for the state of charge and the final state of charge they are a percentage of the usableCarBattery or the capacity when including this object in the mutation.

✨ Improvements

  • Improved search and filtering on the operatorList query.

🐞 Bug fixes

  • Fixed an issue where rangeEnd and rangeEndKwh were 0 when plotting a route using a car that does not support fast charging.

4.4.0 - Error handling

✨ Improvements

  • Improved error handling on the login section of the dashboard.

4.3.1 - Bug fix review module

🐞 Bug fixes

  • Fixed a bug where station.review.count and station.review.rating were not incremented when a review was added.

4.3.0 - Stability Improvements

✨ Improvements

  • Improved stability through several software updates.

4.2.0 - Test merge into master

👉 My finger ... is on the button

Like The Chemical Brothers once said; the time has come to push the button.

4.1.0 - Route mutation validation

✨ Improvements

  • Improved error coverage for the route mutation validation. All errors are currently collected and used to improve the error messages. Routes will be returned for now, even if there are mistakes in the route mutation. We will notify you before enforcing the new errors.

🐞 Bug fixes

  • Fixed a bug where safeRiskMargin was applied twice in winter scenarios.

4.0.0 - Stability improvements

✨ Improvements

  • Improved stability through several software updates.

3.33.0 - Bug fixes

🐞 Bug fixes

  • Fixed a bug where an incorrect start range when using OPTIMIZE_TRAVEL_TIME was displayed.

3.32.0 - Improved tile service expansion zoom

✨ Improvements

  • Improved tile service cluster break-up by adjusting the expansion zoom calculation.
  • Improved filtering of stations by excluding onboard chargers below 20 kW for all models with onboard capabilities higher than 20 kW.

🐞 Bug fixes

  • Fixed a bug where the routePath query changed the route path location search from a strict find to nearest point search.
  • Fixed a bug where list queries accepted negative integers.

3.31.0 - Tiered preferred operators and excluded operators

⚡️ New features

  • Added the input argument operators to the newRoute mutation! We are happy to announce the release of a tiered preferred operator system and the ability to exclude operators from routing! From now on, in your route request, you will be able to add what operators you want us to prefer in order of ranking, and let us know if there are operators you wish to exclude from the route calculation! The same functionality is possible to include in the config of your client ID, which will soon be possible to adjust in the dashboard; get in touch with us directly until then.

3.30.0 - Improved Charge Time estimates

✨ Improvements

  • Improved charge time estimates by introducing a generalized charge curve model that accounts for the On Board Charging (OBC) power threshold and drop-off characteristic at higher state of charges. The generalized charge curve model is used for all cars for which we have sufficient data. We will increase our coverage over time when more data becomes available.

3.29.0 - E2E Maintenance

✨ Improvements

  • Improved release times by lowering the memory usage on our end to end tests.
  • Improved performance for several sections of the Chargetrip dashboard.

🐞 Bug fixes

  • Fixed an issue with the optimal route where in some cases a station was selected far from the optimal route.

3.28.0 - Introduction of chargeMode

⚡️ New features

  • Added chargeMode. This field can be set to OPTIMIZE_TRAVEL_TIME and ALWAYS_TO_MAX_CHARGE.

ALWAYS_TO_MAX_CHARGE will give you a route response where we recommend charging to the maximum capacity at every charging stop. The default maximum charging capacity is 80%. For all our existing customers, this is the default setting.


OPTIMIZE_TRAVEL_TIME optimizes the charging time at each station, in order to decrease the total travel time. You will only charge up until the state of charge you need in order to reach the next stop.

3.27.0 - CI/CD Upgrade

✨ Improvements

  • Improved CI/CD for faster releases.

3.26.0 - Turn-by-turn instructions

Note
This release contains experimental features. They are not supported and may change, break, or disappear at any time.

⚡️ New features

  • Added 'raw' turn-by-turn instructions that can be used in combination with navigation SDK's to offer turn-by-turn navigation. To receive the instructions, add the instructions argument to the newRoute mutation. Don’t forget to also request the instructions in the getRoute request. Important: this feature is still in active development and it should only be used for test purposes until further notice.

✨ Improvements

  • Improved performance for several sections of the Chargetrip dashboard.

3.25.0 - Client configuration options

⚡️ New features

  • Added the field max_electric_power which gives the maximum electric power in kW of a connector/adapter. max_electric_power is exposed on the carList, Car and CarPremium query.
  • Added the ability to configure the time it takes to halt, start and stop charging on client level. We default to 5 minutes if you choose not to change this. This functionality will soon become available to you in the dashboard.

✨ Improvements

  • Improved the description of the power field for connectors and adapters to: "Usable electric power in kW".

🐞️ Bug fixes

  • Fixed an issue where the route mutation returned an internal server error when the operatorPrefer parameter was set to true and the operatorIds parameter set to null.
  • Fixed an issue where safeRiskMargin could be set to null. An integer between 0 and 60 is now required.

3.24.0 - Stability improvements

✨ Improvements

  • Improved stability through several software updates.

3.22.1 - Configurable charge speed

⚡️ New features

  • Added configurable charge speed for our customers. By default we use the average charge speed, but customers can now choose to use the maximum charge speed instead. This functionality will soon become available to you in the dashboard.

🐞️ Bug fixes

  • Fixed an issue with the tariffs module where in some cases the wrong tariff was displayed.
  • Fixed an issue when the WebSocket broke and it didn’t return a result on a subscription by adding a KeepAlive message.

3.14.1-supercluster.15 - Tile service performance

✨ Improvements

  • Improved the performance of our Tile Service to provide more structured clustering and faster response times.

3.14.1 - Password changes

⚡️ New features

  • Added the ability to change your Chargetrip account password through your profile.

3.9.0 - Performance improvements

✨ Improvements

  • Improved performance for several sections of the Chargetrip dashboard.

3.8.0 - pathPlot Release

In this release, we introduce pathPlot, a new property that combines the data from our previous elevationPlot and aggregated data from routePath query. The received data is more accurate, and the response is quicker.

⚡️ New features

  • Added the pathPlot property in favour of elevationPlot.
  • Added support to search the carList by id.

✨ Improvements

  • Improved how routes should be queried. A single additional route query is no longer needed after you started a route subscription.

🐞️ Bug fixes

  • Removed the unused operator and station subscriptions.
  • Fixed an issue where in some cases an incorrect connector type was selected at charge stations.

3.3.4 - Routing in Low Density Charge Station Regions

⚡️ New features

  • Added support for URL parameter authentication on top of header authentication to provide a more seamless Mapbox integration. See our updated documentation here.

✨ Improvements

  • Improved our calculations in regions where the density of stations is still low by widening our search for possible stations if the first route fails.

3.0.0 - GraphEngine 3.0

⚡️ New features

  • Chargetrip's Graph Engine has been rebuild from the ground-up to maintain performance and withstand higher loads. The new version of the engine calculates routes faster, uses more variables and gives back better results.

✨ Improvements

  • Improved the client environment's stability by moving the import and processing of station data outside the client environment.
  • Improved route calculation speeds when searching for stations along a route.
  • Improved route calculation speeds when using preferred operators.
  • Improved car data processing.

2.58.6 - Introducing pagination to the car database

Today we are rolling out an overhauled carlist query which allows for better frontend performance and search results. For an example on how to use all these new features, you can go here.

⚡️ New features

  • Added pagination to the carList query.
  • Added search over naming.make, naming.model, naming.chargetrip_version to the carList query.
  • Added filter for availability to the carList query.

2.38.3 - Car Database Structure

✨ Improvements

  • Improved car data clustering. Fields are now categorized by using nesting.

2.38.3 - Car Database Structure

This release improves the structuring of our car data. This improvement however includes breaking changes and requires migration. The fields that require migration can be found on the deprecation page.

✨ Improvements

  • Improved car data structuring which allows for better clustering and query scalability.

🐞️ Bug fixes

  • Fixed a bug that prevented using stations as via point.

2.33.1 - Predictive Availability Module

This week we extended our station data by including historical station availability. Not every station includes this information at the moment but this will increase over time.

The predictive availability module contains this week's predictions. For every hour, there is an availability scale ranging from 1 to 5.

Value Prediction
1 very busy - high probability that the charging station is occupied
2 busy
3 average
4 quiet
5 very quiet - high probability that the charging station will be free

The days of the week start at 1 which results in the following weekdays values:

Value Day of the week
1 Monday
2 Tuesday
3 Wednesday
4 Thursday
5 Friday
6 Saturday
7 Sunday

⚡️ New features

  • Station data has been extended and now includes historical station availability.

🐞️ Bug fixes

  • Fixed a bug where error codes were not consistent.

2.30.3 - Bug fixes & improvements

🐞️ Bug fixes

  • Fixed a bug that hid 24 / 7 information for some stations.
  • Fixed a bug where alternative routes with a single charge were not displayed correctly.

2.30.2 - Chargetrip Range

This release introduces the chargetripRange field. The Chargetrip Real Range helps displaying a realistic range for all EV models. The range is based on Chargetrip's research and driving data. You can find more details on the car section.

⚡️ New features

  • Added the chargetripRange field.

✨ Improvements

  • Migrated fields from the carList query to the car query to allow caching of the carList query.

🐞️ Bug fixes

  • Fixed a bug where the number of amenities were not equal when comparing between the stationList and amenityList.

2.27.5 - New Outside Temperature Model

✨ Improvements

  • Improved outside temperature model which enhances the route computation speed and improves the charge stop accuracy.
  • Various other improvements to improve our route calculation speed.

🐞️ Bug fixes

  • Fixed a bug where the ordering of alternative routes was wrong.

2.24.0 - Custom Error Codes

This release is all about errors. We know, you hate getting them but we tried to make debugging a little bit easier. Apart from that we also included all custom error codes in our documentation. Please be aware that in addition to our custom error codes, GraphQL throws an INTERNAL_SERVER_ERROR as a generic HTTP-error. Please ignore this error and use only our custom error codes.

⚡️ New features

  • Added custom error codes and detailed error descriptions. No more guess-work.

🐞️ Bug fixes

  • Various small bug fixes.

2.22.2 - Bug Fixes & improvements

✨ Improvements

  • Improved the description of our recently released chargetripEdition field.
  • Improved various chargetripEdition field names to be more descriptive.

🐞️ Bug fixes

  • Fixed a bug where via points were not correctly added to the route.

2.22.0 - Chargetrip Edition

This week the chargetripEdition field has been released. Often car manufacturers don't make a distinction between different versions of the same modal. By using the chargetrip edition we make sure you always have a unique car name.

⚡️ New features

  • Added the chargetripEdition field.

2.21.8 - Bug Fixes

🐞️ Bug fixes

  • Fixed a spelling mistake by renaming recommandedSpeed to recommendedSpeed.
  • Fixed the destination type from stationVia to stationFinal when adding a station as final destination.

2.21.0 - Alternative Stations

⚡️ New features

  • Added the ability to request alternative stations along an existing route.
  • Added the ability to set charge stations as waypoints to an existing route.

🐞️ Bug fixes

  • Renamed the stationAlong field to stationsAlongRoute.

2.19.0 - Tile Service Filter

⚡️ New features

  • Added support for selecting different power filters.
  • Added support to select all available connectors.

🐞️ Bug fixes

  • Fixed various spelling mistakes and inconsistencies in our documentation.

2.15.0 - OCPI 2.2 Support

⚡️ New features

  • Added support for OCPI 2.2. OCPI specifications can be found here. The full specifications can be found here.

2.0.0 - OCPI 2.1.1 Support

Today's release contains an exclusive Eco-Movement Integration. Next to our free Open Charge Map stations, your account can be pre-loaded with over 100.000 highly curated premium charge stations across Europe. Our premium station data includes real-time availability, pricing, and charging history. You no longer need to connect several costly charge station database providers to get European coverage. See Eco-Movement for more details about regional limitations. Contact us for pricing.

⚡️ New features

  • Added an exclusive Eco-Movement integration.
  • Added support for OCPI 2.1.1

🐞️ Bug fixes

  • Fixed various spelling mistakes and inconsistencies in our documentation.
  • Fixed missing descriptions for all types that return values with a unit.

1.0.0 - Generation 3 of the Chargetrip API

⚡️ New features

  • Added support for Peugeot e-208 and Seat Mii Electric.
  • Added support for the OCPI Tarrif Module. More information about the OCPI 2.1.1 specifications can be found here. The full specifications can be found here.

🐞️ Bug fixes

  • Fixed various spelling mistakes and inconsistencies in our documentation.