การกำหนดเวอร์ชัน

ทีม Maps JavaScript API จะอัปเดต API เป็นประจำด้วยฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการเพิ่มประสิทธิภาพ หน้านี้อธิบายเวอร์ชันของ API ที่พร้อมให้ใช้งานในแอปพลิเคชัน

ช่องทางการเผยแพร่และหมายเลขเวอร์ชัน

คุณสามารถระบุช่องทางการเผยแพร่หรือหมายเลขเวอร์ชันได้ในใบสมัคร

• ช่องรายสัปดาห์จะระบุด้วย v=weekly
  เวอร์ชันนี้จะอัปเดตสัปดาห์ละ 1 ครั้งและเป็นเวอร์ชันล่าสุด
• ช่องรายไตรมาสจะระบุด้วย v=quarterly
  เวอร์ชันนี้จะอัปเดต 1 ครั้งต่อไตรมาส และเป็นเวอร์ชันที่คาดการณ์ได้มากที่สุด
• แชแนลเบต้าจะระบุด้วย v=beta
  แชแนลนี้อิงตามแชแนล weekly และอัปเดตสัปดาห์ละครั้ง ซึ่งรวมถึงการเปลี่ยนแปลงเพิ่มเติมสำหรับการทดสอบและความคิดเห็นในช่วงต้น
• ช่องอัลฟ่าจะระบุด้วย v=alpha
  แชแนลนี้อิงตามแชแนล beta และอัปเดตสัปดาห์ละครั้ง ซึ่งรวมถึงการทดสอบเพื่อรับความคิดเห็นของลูกค้าเกี่ยวกับต้นแบบ เครื่องมือนี้มีไว้เพื่อการพัฒนาซอฟต์แวร์เท่านั้นและไม่ควรใช้ในเวอร์ชันที่ใช้งานจริง
• ระบุหมายเลขเวอร์ชันด้วย v=n.nn
  โดยเลือกได้ระหว่าง v=3.59, v=3.58, v=3.57 หรือ v=3.56
  หมายเลขเวอร์ชันจะอัปเดตไตรมาสละครั้ง (ดูการอัปเดตรายไตรมาส)

หากคุณไม่ได้ระบุช่องหรือเวอร์ชันอย่างชัดเจน คุณจะได้รับช่องรายสัปดาห์โดยค่าเริ่มต้น หากคุณย้ายข้อมูลจากแพ็กเกจพรีเมียมและไม่ได้ระบุแชแนลหรือเวอร์ชันอย่างชัดเจน คุณจะได้รับแชแนลรายไตรมาสโดยค่าเริ่มต้น หากระบุเวอร์ชันที่ไม่ถูกต้อง คุณจะได้รับช่องเริ่มต้น

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

อัปเดตช่องรายสัปดาห์

ขณะนี้ช่องรายสัปดาห์ชี้ไปที่เวอร์ชัน 3.59

ในช่วงกลางเดือนกุมภาพันธ์ ช่องรายสัปดาห์จะอัปเดตจากเวอร์ชัน 3.59 เป็นเวอร์ชัน 3.60 เมื่อถึงจุดนี้ เวอร์ชันใหม่จะมีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานออก และ/หรือเปิดตัวฟีเจอร์ที่ไม่เข้ากันได้กับเวอร์ชันเก่า คุณอาจต้องทดสอบการเปลี่ยนแปลงเหล่านี้เมื่ออัปเดตช่อง

ตลอดทั้งไตรมาส เวอร์ชันใหม่จะได้รับการอัปเดตทุกสัปดาห์ด้วยฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการเพิ่มประสิทธิภาพ การดำเนินการนี้จะไม่นำฟีเจอร์ที่เลิกใช้งานออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้กับเวอร์ชันเก่า

การอัปเดตช่องรายไตรมาส

ปัจจุบันช่องรายไตรมาสชี้ไปที่เวอร์ชัน 3.58

ในช่วงกลางเดือนกุมภาพันธ์ เราจะอัปเดตช่องทางรายไตรมาสจากเวอร์ชัน 3.58 เป็นเวอร์ชัน 3.59 เมื่ออัปเดตแล้ว เวอร์ชันนี้จะรวมฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือเปิดตัวฟีเจอร์ที่เข้ากันไม่ได้กับเวอร์ชันเก่าในช่วง 3 เดือนที่ผ่านมา คุณอาจต้องทดสอบการเปลี่ยนแปลงเหล่านี้เมื่ออัปเดตช่อง

ตลอดทั้งไตรมาส เวอร์ชันนี้จะไม่มีฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือปรับปรุงประสิทธิภาพ การดำเนินการนี้จะไม่นำฟีเจอร์ที่เลิกใช้งานออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้กับเวอร์ชันเก่า

การอัปเดตเวอร์ชัน

ในช่วงกลางเดือนกุมภาพันธ์ หมายเลขเวอร์ชันจะเปลี่ยนไปเพื่อรองรับการเปิดตัวเวอร์ชันใหม่

เวอร์ชัน 3.60

เวอร์ชันใหม่ 3.60 จะเปิดตัวในช่วงกลางเดือนกุมภาพันธ์ เมื่อเผยแพร่แล้ว เวอร์ชันนี้จะรวมฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานออก และ/หรือเปิดตัวฟีเจอร์ที่เข้ากันไม่ได้กับเวอร์ชันเก่าเมื่อเทียบกับเวอร์ชัน 3.59 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน

ในช่วงไตรมาสนี้ เวอร์ชันใหม่จะได้รับการอัปเดตทุกสัปดาห์ด้วยฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ การดำเนินการนี้จะไม่นำฟีเจอร์ที่เลิกใช้งานออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้กับเวอร์ชันเก่า

เวอร์ชัน 3.59

เวอร์ชันนี้มีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือเปิดตัวฟีเจอร์ที่ไม่เข้ากันได้กับเวอร์ชันเก่าเมื่อเทียบกับเวอร์ชัน 3.58 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน

หลังจากกลางเดือนกุมภาพันธ์ เวอร์ชันนี้จะไม่ได้รับการอัปเดตฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือการเพิ่มประสิทธิภาพอีกต่อไป การดำเนินการนี้จะไม่นำฟีเจอร์ที่เลิกใช้งานออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้กับเวอร์ชันเก่า

เวอร์ชัน 3.58

เวอร์ชันนี้มีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือเปิดตัวฟีเจอร์ที่ไม่เข้ากันได้กับเวอร์ชันเก่าเมื่อเทียบกับเวอร์ชัน 3.57 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน

เวอร์ชันนี้จะไม่ได้รับการอัปเดตฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือปรับปรุงประสิทธิภาพอีกต่อไป แต่จะไม่มีการนําฟีเจอร์ที่เลิกใช้งานแล้วหลังจากเวอร์ชันนี้ออก และไม่เพิ่มฟีเจอร์ใหม่ที่ไม่เข้ากันได้กับเวอร์ชันเก่า

เวอร์ชัน 3.57

เวอร์ชันนี้มีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือเปิดตัวฟีเจอร์ที่ไม่เข้ากันได้กับเวอร์ชันเก่าเมื่อเทียบกับเวอร์ชัน 3.56 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน

เวอร์ชันนี้จะไม่ได้รับการอัปเดตฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือปรับปรุงประสิทธิภาพอีกต่อไป แต่จะไม่มีการนําฟีเจอร์ที่เลิกใช้งานแล้วหลังจากเวอร์ชันนี้ออก และไม่เพิ่มฟีเจอร์ใหม่ที่ไม่เข้ากันได้กับเวอร์ชันเก่า

เวอร์ชัน 3.56

หลังจากกลางเดือนกุมภาพันธ์ ระบบจะลบเวอร์ชันนี้และคุณจะใช้งานไม่ได้อีกต่อไป ระบบจะไม่สนใจความพยายามที่จะโหลดเวอร์ชันนี้ และคุณจะได้รับช่องเริ่มต้นแทน

การรองรับเวอร์ชัน

ในแต่ละไตรมาสจะมี 4 เวอร์ชัน รองรับทั้ง 4 เวอร์ชัน

การตรวจสอบเวอร์ชัน

สำหรับการแก้ไขข้อบกพร่อง ให้ใช้พร็อพเพอร์ตี้ google.maps.version เพื่อรับ Maps JavaScript API เวอร์ชันปัจจุบันในแอปพลิเคชัน ตัวอย่างโค้ดต่อไปนี้จะเขียนเวอร์ชัน API ลงในคอนโซลเบราว์เซอร์ (ดูข้อมูลเพิ่มเติมเกี่ยวกับคอนโซลเบราว์เซอร์ได้ในคู่มือ การตรวจสอบข้อผิดพลาดในเบราว์เซอร์)

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

เอกสารประกอบสำหรับเวอร์ชัน API

คู่มือนักพัฒนาแอปจะอธิบายเวอร์ชันรายสัปดาห์เสมอ

นอกจากนี้ ยังมีข้อมูลอ้างอิงสำหรับแต่ละเวอร์ชันที่ดูแลรักษาแยกกัน ดังนี้

• การอ้างอิง API เวอร์ชัน 3.59 (แชแนลรายสัปดาห์)
• การอ้างอิง API เวอร์ชัน 3.58 (ช่องทางรายไตรมาส)
• การอ้างอิง API เวอร์ชัน 3.57
• การอ้างอิง API เวอร์ชัน 3.56
• เวอร์ชัน 3.0 ถึง 3.55 ถูกลบไปแล้ว