Lập phiên bản

Nhóm Maps JavaScript API thường xuyên cập nhật API bằng các tính năng mới, bản sửa lỗi và cải tiến hiệu suất. Trang này mô tả các phiên bản API có sẵn để sử dụng trong ứng dụng của bạn.

Kênh phát hành và số phiên bản

Trong ứng dụng, bạn có thể chỉ định kênh phát hành hoặc số phiên bản:

• Kênh hằng tuần được chỉ định bằng v=weekly.
  Kênh này được cập nhật một lần mỗi tuần và là kênh mới nhất.
• Kênh hằng quý được chỉ định bằng v=quarterly.
  Kênh này được cập nhật một lần mỗi quý và là kênh có thể dự đoán được nhất.
• Kênh beta được chỉ định bằng v=beta.
  Kênh này dựa trên kênh weekly và được cập nhật một lần mỗi tuần. Bản phát hành này bao gồm các thay đổi bổ sung để kiểm thử và phản hồi sớm.
• Kênh alpha được chỉ định bằng v=alpha.
  Kênh này dựa trên kênh beta và được cập nhật một lần mỗi tuần. Báo cáo này bao gồm các thử nghiệm để khách hàng phản hồi về nguyên mẫu. API này chỉ dành cho mục đích phát triển và không được dùng trong môi trường sản xuất.
• Số phiên bản được chỉ định bằng v=n.nn.
  Bạn có thể chọn v=3.59, v=3.58, v=3.57 hoặc v=3.56.
  Số phiên bản được cập nhật một lần mỗi quý (xem phần Bản cập nhật hằng quý).

Nếu không chỉ định rõ ràng kênh hoặc phiên bản, theo mặc định, bạn sẽ nhận được kênh hằng tuần. Nếu đã di chuyển từ gói cao cấp và không chỉ định rõ ràng một kênh hoặc phiên bản, thì theo mặc định, bạn sẽ nhận được kênh hằng quý. Nếu chỉ định phiên bản không hợp lệ, bạn sẽ nhận được kênh mặc định.

  <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>
  

  <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>

  <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>

  <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>

  <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.58,
  });
  </script>

Thông tin cập nhật hằng tuần về kênh

Kênh hằng tuần hiện trỏ đến phiên bản 3.59.

Vào giữa tháng 2, kênh hằng tuần sẽ được cập nhật từ phiên bản 3.59 lên phiên bản 3.60. Tại thời điểm này, 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 tính năng không tương thích ngược. Bạn có thể cần kiểm thử những thay đổi này khi kênh được cập nhật.

Trong suốt quý này, phiên bản mới sẽ đượ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 tiến về hiệu suất. Việc này sẽ không xoá các tính năng không dùng nữa và sẽ không gây ra sự không tương thích ngược.

Thông tin cập nhật hằng quý về kênh

Kênh hằng quý hiện trỏ đến phiên bản 3.58.

Vào giữa tháng 2, kênh hằng quý sẽ được cập nhật từ phiên bản 3.58 lên phiên bản 3.59. Sau khi cập nhật, phiên bản này 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 tính năng không tương thích ngược từ ba tháng trước. Bạn có thể cần kiểm thử những thay đổi này khi kênh được cập nhật.

Trong quý này, phiên bản này sẽ không 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. Việc này sẽ không xoá các tính năng không dùng nữa và sẽ không gây ra sự không tương thích ngược.

Bản cập nhật phiên bản

Vào giữa tháng 2, số phiên bản sẽ được chuyển sang để phù hợp với việc phát hành phiên bản mới.

Phiên bản 3.60

Phiên bản 3.60 mới sẽ được phát hành vào giữa tháng 2. Sau khi phát hành, phiên bản này 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 tính năng không tương thích ngược so với phiên bản 3.59. Bạn nên kiểm thử ứng dụng khi thay đổi giữa các số phiên bản.

Trong quý này, phiên bản mới sẽ đượ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à cải tiến hiệu suất. Việc này sẽ không xoá các tính năng không dùng nữa và sẽ không gây ra sự không tương thích ngược.

Phiên bản 3.59

Phiên bản này 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 tính năng không tương thích ngược so với phiên bản 3.58. Bạn nên kiểm thử ứng dụng khi thay đổi giữa các số phiên bản.

Sau giữa tháng 2, phiên bản này sẽ không còn được cập nhật tính năng mới, bản sửa lỗi hoặc điểm cải thiện hiệu suất nữa. Việc này sẽ không xoá các tính năng không dùng nữa và sẽ không gây ra sự không tương thích ngược.

Phiên bản 3.58

Phiên bản này 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 tính năng không tương thích ngược so với phiên bản 3.57. Bạn nên kiểm thử ứng dụng khi thay đổi giữa các số phiên bản.

Phiên bản này sẽ không còn được cập nhật tính năng mới, bản sửa lỗi hoặc điểm cải thiện hiệu suất. Bản phát hành này sẽ không xoá các tính năng không dùng nữa sau phiên bản này và sẽ không gây ra sự không tương thích ngược mới.

Phiên bản 3.57

Phiên bản này 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 tính năng không tương thích ngược so với phiên bản 3.56. Bạn nên kiểm thử ứng dụng khi thay đổi giữa các số phiên bản.

Phiên bản này sẽ không còn được cập nhật tính năng mới, bản sửa lỗi hoặc điểm cải thiện hiệu suất. Bản phát hành này sẽ không xoá các tính năng không dùng nữa sau phiên bản này và sẽ không gây ra sự không tương thích ngược mới.

Phiên bản 3.56

Sau giữa tháng 2, phiên bản này sẽ bị xoá và không thể sử dụng được nữa. Mọi nỗ lực tải phiên bản này sẽ bị bỏ qua và bạn sẽ nhận được kênh mặc định.

Hỗ trợ phiên bản

Trong mỗi quý, bạn có thể sử dụng 4 phiên bản. Cả 4 phiên bản này đều được hỗ trợ.

Kiểm tra phiên bản

Để gỡ lỗi, hãy sử dụng thuộc tính google.maps.version để lấy phiên bản hiện tại của API JavaScript của Maps trong ứng dụng. Mã mẫu sau đây sẽ ghi phiên bản API vào bảng điều khiển của trình duyệt. (Để biết thêm thông tin về bảng điều khiển trình duyệt, hãy xem hướng dẫn kiểm tra lỗi trong trình duyệt.)

<!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"
    defer></script>
  </body>
</html>

Tài liệu về các phiên bản API

Hướng dẫn cho nhà phát triển luôn mô tả phiên bản hàng tuần.

Ngoài ra, mỗi phiên bản có một tài liệu tham khảo riêng được duy trì:

• Tài liệu tham khảo API phiên bản 3.59 (kênh hằng tuần)
• Tài liệu tham khảo API phiên bản 3.58 (kênh phát hành theo quý)
• Tài liệu tham khảo API Phiên bản 3.57
• Tài liệu tham khảo API Phiên bản 3.56
• Các phiên bản từ 3.0 đến 3.55 đã bị xoá.