Lập phiên bản

Chọn kênh hằng tuần

Đối với hầu hết các ứng dụng, bạn nên chọn kênh hằng tuần. Đây là phiên bản mới nhất và mới nhất, đồng thời chứa các bản sửa lỗi và cải tiến hiệu suất mới nhất. Bạn có thể chỉ định kênh hằng tuần bằng cách tải Maps JavaScript API như sau thẻ tập lệnh:

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

Hiện tại, kênh hằng tuần là phiên bản 3.58. Phiên bản này được cập nhật hằng tuần, trong đó có các tính năng mới, bản sửa lỗi và điểm cải tiến về hiệu suất.

Vào giữa tháng 11, kênh đăng ký hằng tuần sẽ được cập nhật thành phiên bản 3.59. Vào thời điểm đó, phiên bản mới có thể xoá các tính năng không dùng nữa và/hoặc tạo ra trường hợp không tương thích ngược.

Chọn kênh hằng quý

Một số ứng dụng có thể hưởng lợi từ số lượng bản cập nhật ít hơn nhưng quy mô lớn hơn, vì nó mang lại trải nghiệm tốt hơn khả năng dự đoán. Những đơn đăng ký này nên sử dụng kênh hằng quý. Sử dụng phương pháp này nếu bạn muốn các bản sửa lỗi và cải thiện hiệu suất đến vào thời gian dự kiến (xem thông tin cập nhật hằng quý). Bạn có thể chỉ định kênh hằng quý bằng cách tải Maps JavaScript API như sau thẻ tập lệnh:

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

Hiện tại, kênh hằng quý là phiên bản 3.57. Trong quý, phiên bản này không nhận được tính năng mới, bản sửa lỗi hoặc hiệu suất. Thỉnh thoảng, chúng tôi có thể triển khai các bản sửa lỗi bảo mật trong phiên bản này.

Vào giữa tháng 11, kênh phát hành hằng quý sẽ được cập nhật lên phiên bản 3.58. Vào thời điểm đó, phiên bản mới sẽ bao gồm các tính năng mới, xoá các tính năng không dùng nữa, và/hoặc tạo ra sự không tương thích ngược từ 3 tháng trước.

Chọn kênh thử nghiệm beta

Hãy sử dụng kênh thử nghiệm beta để trải nghiệm các tính năng beta mới và các thay đổi. Các tính năng thử nghiệm tính năng đã hoàn chỉnh nhưng có thể có một số vấn đề chưa được xử lý (vui lòng sử dụng Công cụ theo dõi lỗi để báo cáo vấn đề và đưa ra ý kiến phản hồi). Kênh thử nghiệm beta không được hỗ trợ bởi bất kỳ SLA hoặc chính sách về việc ngừng sử dụng và một số thay đổi có thể không tương thích ngược với các bản phát hành trước đó.

Kênh này dựa trên kênh weekly và được cập nhật mỗi tuần một lần.

Bạn có thể chỉ định kênh thử nghiệm bằng cách tải Maps JavaScript API bằng tập lệnh sau thẻ:

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

Chọn kênh alpha

Sử dụng kênh alpha để dùng thử các tính năng và thay đổi thử nghiệm mới. Vui lòng sử dụng Công cụ theo dõi lỗi để báo cáo vấn đề và đưa ra ý kiến phản hồi. Kênh alpha không thuộc phạm vi điều chỉnh của Thoả thuận mức độ cung cấp dịch vụ (SLA) hoặc việc ngừng sử dụng nào của Google và một số thay đổi có thể không tương thích ngược với các bản phát hành trước đó. Tệp này chỉ dành cho mục đích phát triển và không được sử dụng trong phiên bản phát hành chính thức.

Kênh này dựa trên kênh beta và được cập nhật mỗi tuần một lần.

Bạn có thể chỉ định kênh alpha bằng cách tải API JavaScript cho Maps bằng tập lệnh sau thẻ:

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

Chọn số phiên bản

Chỉ chỉ định phiên bản theo số nếu bạn thường xuyên kiểm tra và cập nhật ứng dụng của mình. Điều này là do phiên bản được đánh số cuối cùng sẽ bị xoá khi phiên bản mới được tạo hằng quý. Bạn có thể chỉ định số phiên bản bằng cách tải Maps JavaScript API bằng thẻ tập lệnh sau:

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

Hiện tại, bạn có thể chỉ định v=3.58, v=3.57, v=3.56 hoặc v=3.55.

• Phiên bản 3.58 đang nhận được các bản cập nhật hằng tuần về các tính năng mới, bản sửa lỗi và hiệu suất.
• Phiên bản 3.57 không nhận được bản cập nhật hằng tuần.
• Phiên bản 3.56 không nhận được bản cập nhật hàng tuần.
• Phiên bản 3.55 không nhận được bản cập nhật hàng tuần.
• Thỉnh thoảng, chúng tôi có thể đưa ra các bản sửa lỗi bảo mật vào bất kỳ phiên bản nào.
• Chúng tôi có thể tạo ra những thay đổi không có khả năng tương thích ngược khi tạo một phiên bản mới.

Sau giữa tháng 11, bạn sẽ có thể chỉ định v=3.59, v=3.58, v=3.57 hoặc v=3.56.

• Phiên bản 3.59 sẽ nhận được bản cập nhật hàng tuần với các tính năng mới, bản sửa lỗi và hiệu suất.
• Phiên bản 3.58 sẽ không còn nhận được bản cập nhật hằng tuần nữa.
• Phiên bản 3.57 sẽ không còn nhận được bản cập nhật hằng tuần nữa.
• Phiên bản 3.56 sẽ không còn nhận được bản cập nhật hằng tuần nữa.
• Thỉnh thoảng, chúng tôi có thể đưa ra các bản sửa lỗi bảo mật vào bất kỳ phiên bản nào.
• Phiên bản 3.55 sẽ không được cung cấp nữa. Mọi lần thử tải phiên bản này sẽ bị bỏ qua và bạn sẽ nhận được kênh mặc định.

Sơ đồ dưới đây cho biết các phiên bản sẽ có trong mỗi kênh trong năm tới.

Một bản cập nhật ảnh hưởng đến đơn đăng ký của tôi

Việc cập nhật kênh phát hành có thể ảnh hưởng đến ứng dụng của bạn. Điều này có thể xảy ra vì ứng dụng của bạn đang dựa vào các tính năng không được ghi nhận hay không được dùng nữa, hoặc do xảy ra lỗi mà chúng tôi đã giới thiệu.

Để tạm thời khắc phục, bạn có thể định cấu hình lại ứng dụng của mình để sử dụng phiên bản cũ hơn.

1. Mở bảng điều khiển trong công cụ cho nhà phát triển của trình duyệt và xem giá trị của google.maps.version.
2. Cập nhật thẻ tập lệnh tải API, và yêu cầu số phiên bản cũ hơn.
   Ví dụ: nếu google.maps.version là "3.58.2", hãy sử dụng v=3.57 trong thẻ tập lệnh của bạn.
   Giải pháp tạm thời này chỉ có hiệu quả trong một khoảng thời gian giới hạn.

Khi giải pháp tạm thời có sẵn, bạn sẽ có thời gian (thường từ 3 đến 6 tháng) để cập nhật ứng dụng của bạn để ứng dụng không còn sử dụng các tài khoản và tính năng không được ghi nhận hoặc không dùng nữa để phát hiện lỗi hoặc bản sửa lỗi.

Sau đó, bạn nên chuyển về thẻ tập lệnh gốc để tải API.

Bạn cũng có thể tạo yêu cầu hỗ trợ hoặc báo cáo sự cố.

Tin cập nhật hằng quý

Mỗi quý một lần, nhóm Maps JavaScript API phát hành một phiên bản mới. Việc này xảy ra vào giữa tháng 2, giữa tháng 5, giữa tháng 8 và giữa tháng 11. Lần cập nhật tiếp theo là vào giữa tháng 11. Kênh mới hằng tuần sẽ cung cấp phiên bản 3.59, Khi đó, các kênh khác sẽ được cập nhật.