Versioning

Choosing the weekly channel

For most applications, we recommend the weekly channel. This is the most current and up-to-date version and contains the latest bug fixes and performance improvements. You can specify the weekly channel by loading the Maps JavaScript API with the following script tag:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Currently, the weekly channel is version 3.46. This version is updated weekly with new features, bug fixes, and performance improvements.

In mid-November, the weekly channel will be updated to version 3.47. At that time, the new version may remove deprecated features, and/or introduce backwards-incompatibilities.

Choosing the quarterly channel

Some applications may benefit from fewer but larger updates, because it gives greater predictability. These applications should use the quarterly channel. Use this approach if you want bug fixes and performance improvements to arrive at an expected time (see quarterly updates). You can specify the quarterly channel by loading the Maps JavaScript API with the following script tag:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Currently, the quarterly channel is version 3.45. During the quarter, this version does not receive new features, bug fixes, or performance improvements. We may, from time to time, introduce security bug fixes into this version.

In mid-November, the quarterly channel will be updated to version 3.46. At that time, the new version will include new features, remove deprecated features, and/or introduce backwards incompatibilities from the previous three months.

Choosing the beta channel

Use the beta channel to try out new beta features and changes. Beta features are feature complete but might have some outstanding issues (please use Issue Tracker to report issues and provide feedback). The beta channel is not covered by any SLA or deprecation policy, and some changes might not be backward compatible with earlier releases.

This channel is based on the weekly channel, and is updated once per week.

You can specify the beta channel by loading the Maps JavaScript API with the following script tag:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

Choosing a version number

Specify a version by number only if you regularly test and update your application. This is because numbered versions are eventually deleted as new versions are created every quarter. You can specify the version number by loading the Maps JavaScript API with the following script tag:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.45
        &key=YOUR_API_KEY&callback=initMap">
</script>

Currently, you can specify v=3.46, v=3.45, or v=3.44.

• Version 3.46 is receiving weekly updates with new features, bug fixes, and performance improvements.
• Version 3.45 is not receiving weekly updates.
• Version 3.44 is not receiving weekly updates.
• We may, from time to time, introduce security bug fixes into any version.
• We may introduce backwards-incompatible changes when creating a new version.

After mid-November, you will be able to specify v=3.47, v=3.46, or v=3.45.

• Version 3.47 will receive weekly updates with new features, bug fixes, and performance improvements.
• Version 3.46 will no longer receive weekly updates.
• Version 3.45 will no longer receive weekly updates.
• We may, from time to time, introduce security bug fixes into any version.
• Version 3.44 will no longer be available. Any attempt to load this version will be ignored, and you will receive your default channel instead.

The diagram below shows which versions will be available in each channel over the next year.

An update affected my application

When we update the release channels, it could affect your application. This could occur because your application is relying on undocumented or deprecated features, or because of a bug or bug fix we have introduced.

As a temporary workaround, you can reconfigure your application to use an older version.

1. Open the console in your browser developer tools, and look at the value of google.maps.version.
2. Update the script tag that loads the API, and request an older version number.
   For example, if google.maps.version is "3.46.2", use v=3.45 in your script tag.
   This temporary workaround will work for a limited time only.

Once the temporary workaround is in place, you will have time (typically 3 to 6 months) to update your application, so it no longer uses undocumented or deprecated features, and accounts for bugs or bug fixes.

You should then revert to the original script tag to load the API.

You are also welcome to create a support case or report an issue.

Quarterly updates

Once per quarter, the Maps JavaScript API team releases a new version. This happens mid-February, mid-May, mid-August, and mid-November. The next update will be mid-November. The new weekly channel will provide version 3.47, and at that time the other channels will be updated.