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

การเลือกช่องรายสัปดาห์

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

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

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

ในช่วงกลางเดือนพฤศจิกายน เราจะอัปเดตช่องรายสัปดาห์เป็นเวอร์ชัน 3.63 ในเวลานั้น เวอร์ชันใหม่อาจ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือทำให้เกิดการใช้งานร่วมกันไม่ได้

การเลือกช่องรายไตรมาส

แอปพลิเคชันบางอย่างอาจได้รับประโยชน์จากการอัปเดตที่น้อยลงแต่มีขนาดใหญ่ขึ้น เนื่องจากจะช่วยให้คาดการณ์ได้แม่นยำมากขึ้น แอปพลิเคชันเหล่านี้ควรใช้แชแนลรายไตรมาส ใช้วิธีนี้ หากต้องการให้การแก้ไขข้อบกพร่องและการปรับปรุงประสิทธิภาพมาถึงตามเวลาที่คาดไว้ (ดูการอัปเดตรายไตรมาส) คุณระบุแชแนลรายไตรมาสได้โดยการโหลด Maps JavaScript API ด้วยแท็กสคริปต์ต่อไปนี้

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

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

ในช่วงกลางเดือนพฤศจิกายน เราจะอัปเดตช่องรายไตรมาสเป็นเวอร์ชัน 3.62 เมื่อถึงเวลานั้น เวอร์ชันใหม่จะมีฟีเจอร์ใหม่ๆ นำฟีเจอร์ที่เลิกใช้งานออก และ/หรืออาจทำให้เกิดความไม่เข้ากันแบบย้อนหลังในช่วง 3 เดือนที่ผ่านมา

การเลือกช่องเบต้า

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

เวอร์ชันนี้อิงตามเวอร์ชัน weekly และจะอัปเดตสัปดาห์ละครั้ง

คุณระบุแชแนลเบต้าได้โดยการโหลด Maps JavaScript API ด้วยแท็กสคริปต์ต่อไปนี้

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

การเลือกช่องอัลฟ่า

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

เวอร์ชันนี้อิงตามเวอร์ชัน beta และจะอัปเดตสัปดาห์ละครั้ง

คุณระบุช่องทางอัลฟ่าได้โดยการโหลด Maps JavaScript API ด้วยแท็กสคริปต์ต่อไปนี้

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

การเลือกหมายเลขเวอร์ชัน

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

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

ปัจจุบันคุณระบุ v=3.62 v=3.61 v=3.60 หรือ v=3.59 ได้

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

หลังจากกลางเดือนพฤศจิกายน คุณจะระบุ v=3.63 v=3.62 v=3.61 หรือ v=3.60 ได้

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

แผนภาพด้านล่างแสดงเวอร์ชันที่จะพร้อมใช้งานในแต่ละแชแนล ในช่วงปีหน้า

การอัปเดตส่งผลต่อแอปพลิเคชันของฉัน

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

ตอนนี้ให้กำหนดค่าแอปพลิเคชันใหม่เพื่อใช้เวอร์ชันเก่าเป็นการแก้ปัญหาชั่วคราวไปก่อน

1. เปิดคอนโซลในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ แล้วดูค่าของ google.maps.version
2. อัปเดตแท็กสคริปต์ที่โหลด API และ ขอหมายเลขเวอร์ชันเก่า
   เช่น หาก google.maps.version คือ "3.62.2" ให้ใช้ v=3.61 ในแท็กสคริปต์
   วิธีแก้ปัญหาชั่วคราวนี้จะใช้ได้ในเวลาจำกัดเท่านั้น

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

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

คุณยังสร้างเคสขอรับความช่วยเหลือหรือรายงานปัญหาได้ด้วย

ข้อมูลอัปเดตรายไตรมาส

ทีม Maps JavaScript API จะเผยแพร่เวอร์ชันใหม่ทุกไตรมาส โดยจะเกิดขึ้นในช่วงกลางเดือนกุมภาพันธ์ กลางเดือนพฤษภาคม กลางเดือนสิงหาคม และกลางเดือนพฤศจิกายน การอัปเดตครั้งถัดไปจะมีขึ้นในช่วงกลางเดือนพฤศจิกายน ช่องรายสัปดาห์ใหม่จะให้บริการเวอร์ชัน 3.63 และในขณะนั้นช่องอื่นๆ จะได้รับการอัปเดต