Maps API for JavaScript Developer's Guide

API versions

Version numbers

Version 3 of the HERE Maps API for JavaScript introduces a new way we release the API and a new versioning scheme. Developers using version 2 of the Maps API will remember that each deployment to the CDN was accompanied by a new version number and a new directory within the CDN structure. This, in turn, meant that after each bug-fix release, we needed to ask all customers to switch to the latest version. The new scheme makes this unnecessary.

The new version scheme uses a four-digit version number, where:

  • The first digit is the product version (i.e. 3) – remains unchanged over the lifespan of the Maps API for JavaScript v3
  • The subsequent three digits represent (in this order):
    • major version – changes when the functionality of the API is changed in non-backwards compatible way
    • minor version – is incremented with each release that adds features in a backwards-compatible manner
    • patch version – is incremented with each fully backwards-compatible bug-fix release

Thus, for example, a complete version string of "", means that the product version is "3", the major version is "0", the minor version "1", and finally the patch version is "2". A version string like this, indicates a bug fix release, with no new features.

Versions on the CDN

Although the download path includes the version number, we want to ensure that developers using the API receive backwards-compatible changes as soon as possible, without the need to switch to a new URL. For this reason, the version number in the download path is restricted to the product version and major version only.

Below you can see an example of the Maps API download path:

The version number string in this download path is "3.0" (the product version is "3", the major version "0"). It will change only when a release breaks backwards-compatibility with version 3.0. Until then, bug fixes and feature additions will continue to be delivered under the same download URL.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on