Guidesv3.2 API Referencev3.1 API Reference
Guides

Explore HERE Maps API for JavaScript versions

 HERE Maps API for JavaScript version 3.2

Version Numbers

Version 3 of the HERE Maps API for JavaScript uses a four-digit version number, wherein:

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

For example, a complete version string of 3.2.1.2 indicates a product version of 3, a major version of 2, a minor version of 1, and a patch version of 2.

Versioning via the CDN

Although the download path includes a version number, this number only contains the product version and major version numbers so that API users can quickly receive backward-compatible changes without needing to change the URL.

Below is an example of the Maps API download path:

https://js.api.here.com/v3/3.2/mapsjs-core.js
📘

Note

In a high load production environment, it is recommended to use the full API version number (3.2.x.y) instead of the standard 3.2. This ensures continuity, and protects against disruption when the library version is updated on the CDN.

The version number string in this download path is 3.2 - the product version being 3 and the major version being 2. This number only changes when a release breaks backward compatibility with version 3.2. Until that point, bug fixes and feature additions are delivered through the same download URL.