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

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

สําหรับแอปพลิเคชันส่วนใหญ่ เราขอแนะนําให้ใช้ช่องทางรายสัปดาห์ ซึ่งเป็นเวอร์ชันล่าสุดและเป็นเวอร์ชันที่อัปเดตแล้ว รวมถึงมีการแก้ไขข้อบกพร่องและการปรับปรุงประสิทธิภาพล่าสุด คุณสามารถระบุแชแนลรายสัปดาห์ได้โดยโหลด 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.58 เวอร์ชันนี้ได้รับการอัปเดตทุกสัปดาห์ด้วยฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการเพิ่มประสิทธิภาพ

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

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

แอปพลิเคชันบางรายการอาจได้รับประโยชน์จากการอัปเดตน้อยลงแต่มีขนาดใหญ่ขึ้น เนื่องจากทำให้คาดการณ์ได้มากขึ้น แอปพลิเคชันเหล่านี้ควรใช้ช่องทางรายไตรมาส ใช้แนวทางนี้หากต้องการการแก้ไขข้อบกพร่องและการปรับปรุงประสิทธิภาพให้ตรงเวลา (ดูการอัปเดตรายไตรมาส) คุณสามารถระบุแชแนลรายไตรมาสได้โดยโหลด 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.57 ในระหว่างไตรมาสนี้ เวอร์ชันนี้จะไม่ได้รับการอัปเดตฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือปรับปรุงประสิทธิภาพ เราอาจเปิดตัวการแก้ไขข้อบกพร่องด้านความปลอดภัยในเวอร์ชันนี้เป็นครั้งคราว

ในช่วงกลางเดือนพฤศจิกายน เราจะอัปเดตช่องทางรายไตรมาสเป็นเวอร์ชัน 3.58 ในเวลาดังกล่าว เวอร์ชันใหม่จะมีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานออก และ/หรือเปิดตัวฟีเจอร์ที่ไม่เข้ากันได้กับเวอร์ชันเก่าจาก 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.57,
  });
  </script>

ปัจจุบันคุณสามารถระบุ v=3.58, v=3.57, v=3.56 หรือ v=3.55

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

หลังจากกลางเดือนพฤศจิกายน คุณจะระบุตัวเลือกได้ดังนี้ v=3.59 v=3.58 v=3.57 หรือ v=3.56

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

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

การอัปเดตส่งผลต่อใบสมัครของฉัน

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

คุณสามารถกำหนดค่าแอปพลิเคชันใหม่ให้ใช้เวอร์ชันเก่าเป็นการแก้ปัญหาชั่วคราวได้

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

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

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

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

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

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