New pricing changes went into effect on July 16, 2018. For more information, check out the Guide for Existing Users.

Versioning

The Maps JavaScript API team regularly updates the API with new features, bug fixes, and performance improvements. This page describes the versions of the API that are available for use in your applications.

Release channels and version numbers

In your application you can now specify release channels or version numbers:

  • The weekly channel is specified with v=weekly.
    This channel is updated once per week, and is the most current.
  • The quarterly channel is specified with v=quarterly.
    This channel is updated once per quarter, and is the most predictable.
  • The version number is specified with v=n.nn.
    You can choose v=3.34, v=3.33, or v=3.32.
    Version numbers are updated once per quarter (see Quarterly updates).

If you do not explicitly specify a channel or version, you will receive the weekly channel by default. If you're on the premium plan and do not explicitly specify a channel or version, you will receive the quarterly channel by default. If you specify an invalid version, you will receive your default channel.

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 defer
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Currently, the weekly channel is version 3.34. 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.35. At that time, the new version will 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 defer
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Currently, the quarterly channel is version 3.33. 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.34. At that time, the new version will include new features, remove deprecated features, and/or introduce backwards incompatibilities from the previous three months.

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 defer
    src="https://maps.googleapis.com/maps/api/js?v=3.33
        &key=YOUR_API_KEY&callback=initMap">
</script>

Currently, you can specify v=3.34, v=3.33, or v=3.32.

  • Version 3.34 is receiving weekly updates with new features, bug fixes, and performance improvements.
  • Version 3.33 is not receiving weekly updates.
  • Version 3.32 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.35, v=3.34, or v=3.33.

  • Version 3.35 will receive weekly updates with new features, bug fixes, and performance improvements.
  • Version 3.34 will no longer receive weekly updates.
  • Version 3.33 will no longer receive weekly updates.
  • We may, from time to time, introduce security bug fixes into any version.
  • Version 3.32 will no longer be available. Any attempty to load this version will be ignored, and you will receive your default channel instead.

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 version will be 3.35. At that time, versions will be updated and the following changes will take place.

Weekly channel update

The weekly channel currently points to version 3.34.

In mid-November, the weekly channel will be updated from version 3.34 to version 3.35. At this point, the new version will include new features, remove deprecated features, and/or introduce backwards-incompatibilities. You may need to test for these changes when the channel is updated.

Over the course of the quarter, the new version will be updated weekly with new features, bug fixes, and performance improvements. It will not remove deprecated features and will not introduce backwards-incompatibilities.

Quarterly channel update

The quarterly channel currently points to version 3.33.

In mid-November, the quarterly channel will be updated from version 3.33 to version 3.34. Upon update, this version will include new features, remove deprecated features, and/or introduce backwards-incompatibilities from the previous three months. You may need to test for these changes when the channel is updated.

Over the course of the quarter, this version will not include new features, bug fixes, or performance improvements. It will not remove deprecated features and will not introduce backwards-incompatibilities.

Version updates

In mid-November, the version numbers roll over to accommodate the release of a new version.

Version 3.35

A new version 3.35 will be released in mid-November. Upon release, this version will include new features, remove deprecated features, and/or introduce backwards-incompatibilities compared to version 3.34. You should test your application when changing between version numbers.

During the quarter, the new version will be updated weekly with new features, bug fixes, and performance improvements. It will not remove deprecated features and will not introduce backwards-incompatibilities.

Version 3.34

This version includes new features, removes deprecated features, and/or introduces backwards-incompatibilities compared to version 3.33. You should test your application when changing between version numbers.

After mid-November, this version will no longer be updated with new features, bug fixes, or performance improvements. It will not remove deprecated features and will not introduce backwards-incompatibilities.

Version 3.33

This version includes new features, removes deprecated features, and/or introduces backwards-incompatibilities compared to version 3.32. You should test your application when changing between version numbers.

After mid-November, this version will no longer be updated with new features, bug fixes, or performance improvements. It will not remove deprecated features and will not introduce backwards-incompatibilities.

Version 3.32

After mid-November, this version will be deleted, and can no longer be used. Any attempt to load this version will be ignored, and you will receive your default channel instead.

Version support

In any given quarter, three versions are available. All three of these versions are supported.

Version checks

For debugging, use the google.maps.version property to obtain the current version of the Maps JavaScript API in your application. The following code sample writes the API version to the browser console. (For more information about the browser console, see the guide to checking errors in your browser.)

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    async defer></script>
  </body>
</html>

Documentation for the API versions

The developer's guide always describes the weekly version.

In addition, there is a separately maintained reference for each version:

다음에 대한 의견 보내기...

Maps JavaScript API
도움이 필요하시나요? 지원 페이지를 방문하세요.