Lập phiên bản

Chọn kênh phát hành hằng tuần

Đối với hầu hết các ứng dụng, bạn nên sử dụng kênh hằng tuần. Đây là phiên bản mới nhất và cập nhật nhất, đồng thời có các bản sửa lỗi và cải thiệ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 bằng thẻ tập lệnh sau:

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>
  

Hiện tại, kênh hằng tuần là phiên bản 3.62. Phiên bản này được 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à điểm cải thiện hiệu suất.

Vào giữa tháng 11, kênh phát hành hằng tuần sẽ được cập nhật lên phiên bản 3.63. Khi đó, phiên bản mới có thể xoá các tính năng không dùng nữa và/hoặc giới thiệu các điểm 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ừ việc có ít bản cập nhật nhưng quy mô lớn hơn, vì điều này giúp tăng khả năng dự đoán. Các ứng dụng này nên sử dụng kênh hằng quý. Hãy 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 xuất hiện vào thời gian dự kiến (xem bản cập nhật hằng quý). Bạn có thể chỉ định kênh hằng quý bằng cách tải API JavaScript của Maps bằng thẻ tập lệnh sau:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

Hiện tại, kênh hằng quý là phiên bản 3.61. Trong quý này, phiên bản này sẽ không nhận được các tính năng mới, bản sửa lỗi hoặc điểm cải thiện về hiệu suất. Đôi khi, chúng tôi có thể đưa các bản sửa lỗi bảo mật vào phiên bản này.

Vào giữa tháng 11, kênh hằng quý sẽ được cập nhật lên phiên bản 3.62. Tại 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 giới thiệu các điểm không tương thích ngược trong 3 tháng trước đó.

Chọn kênh beta

Sử dụng kênh thử nghiệm để dùng thử các tính năng và thay đổi mới trong phiên bản thử nghiệm. Các tính năng beta đã hoàn thiện nhưng có thể vẫn còn một số vấn đề chưa được giải quyết (vui lòng sử dụng Công cụ theo dõi lỗi để báo cáo vấn đề và cung cấp ý kiến phản hồi). Kênh thử nghiệm không thuộc phạm vi của bất kỳ SLA hoặc chính sách ngừng cung cấp nào 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 beta bằng cách tải API JavaScript của Maps bằng thẻ tập lệnh sau:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </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 của bất kỳ SLA hoặc chính sách ngừng cung cấp nào 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 chỉ dành cho mục đích phát triển và không nên dùng trong phiên bản phát hành công khai.

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 thử nghiệm alpha bằng cách tải API JavaScript của Maps bằng thẻ tập lệnh sau:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </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 thử và cập nhật ứng dụng của mình. Lý do là các phiên bản có số sẽ bị xoá khi các 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 API JavaScript của Maps bằng thẻ tập lệnh sau:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.61,
  });
  </script>

Hiện tại, bạn có thể chỉ định v=3.62, v=3.61, v=3.60 hoặc v=3.59.

• Phiên bản 3.62 sẽ nhận được cá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à điểm cải thiện hiệu suất.
• Phiên bản 3.61 không nhận được thông tin cập nhật hằng tuần.
• Phiên bản 3.60 không nhận được bản cập nhật hằng tuần.
• Phiên bản 3.59 không nhận được bản cập nhật hằng tuần.
• Đôi khi, chúng tôi có thể đưa 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ể giới thiệu các thay đổi không tương thích ngược khi tạo phiên bản mới.

Sau giữa tháng 11, bạn sẽ có thể chỉ định v=3.63, v=3.62, v=3.61 hoặc v=3.60.

• Phiên bản 3.63 sẽ nhận được các bản 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 thiện về hiệu suất.
• Phiên bản 3.62 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.61 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.60 sẽ không còn nhận được bản cập nhật hằng tuần nữa.
• Đôi khi, chúng tôi có thể đưa 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.59 sẽ không còn dùng được nữa. Mọi nỗ lực tải phiên bản này đều sẽ bị bỏ qua và bạn sẽ nhận được kênh mặc định.

Biểu đồ dưới đây cho biết những phiên bản sẽ có trong từng kênh trong năm tới.

Một thay đổi đã ảnh hưởng đến ứng dụng của tôi

Khi chúng tôi cập nhật các kênh phát hành, điều này 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ó trong tài liệu hoặc không được dùng nữa, hoặc do một lỗi hoặc bản sửa lỗi mà chúng tôi đã giới thiệu.

Trong thời gian chờ đợi, giải pháp tạm thời là bạn có thể định cấu hình lại ứng dụng để sử dụng một phiên bản cũ hơn.

1. Mở bảng điều khiển trong công cụ dành cho nhà phát triển của trình duyệt, rồi 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.62.2", hãy sử dụng v=3.61 trong thẻ tập lệnh.
   Giải pháp tạm thời này sẽ chỉ hoạt động trong một khoảng thời gian giới hạn.

Sau khi giải pháp tạm thời được triển khai, bạn sẽ có thời gian (thường là từ 3 đến 6 tháng) để cập nhật ứng dụng của mình, sao cho ứng dụng không còn sử dụng các tính năng không có trong tài liệu hoặc các tính năng không được dùng nữa, đồng thời tính đến các lỗi hoặc bản sửa lỗi.

Sau đó, bạn nên quay lại thẻ tập lệnh ban đầu để tải API.

Bạn cũng có thể tạo yêu cầu hỗ trợ hoặc báo cáo vấn đề.

Thông tin cập nhật hằng quý

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