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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

การเลือกเวอร์ชันเบต้า

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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

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

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

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </script>
  

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.52
        &key=YOUR_API_KEY&callback=initMap">
</script>

ปัจจุบันระบุ v=3.53, v=3.52, v=3.51 หรือ v=3.50 ได้

• เวอร์ชัน 3.53 ได้รับการอัปเดตรายสัปดาห์พร้อมฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ
• เวอร์ชัน 3.52 ไม่ได้รับการอัปเดตรายสัปดาห์
• เวอร์ชัน 3.51 ไม่ได้รับข้อมูลอัปเดตรายสัปดาห์
• เวอร์ชัน 3.50 ไม่ได้รับการอัปเดตรายสัปดาห์
• เราอาจแนะนําการแก้ไขข้อบกพร่องด้านความปลอดภัยในเวอร์ชันต่างๆ เป็นครั้งคราว
• เราอาจสร้างการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเดิมเมื่อสร้างเวอร์ชันใหม่

หลังกลางเดือนกรกฎาคม คุณจะระบุ v=3.54, v=3.53, v=3.52 หรือ v=3.51 ได้

• เวอร์ชัน 3.54 จะได้รับการอัปเดตรายสัปดาห์พร้อมด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ
• เวอร์ชัน 3.53 จะไม่ได้รับการอัปเดตรายสัปดาห์อีกต่อไป
• เวอร์ชัน 3.52 จะไม่ได้รับการอัปเดตรายสัปดาห์อีกต่อไป
• เวอร์ชัน 3.51 จะไม่ได้รับการอัปเดตรายสัปดาห์อีกต่อไป
• เราอาจแนะนําการแก้ไขข้อบกพร่องด้านความปลอดภัยในเวอร์ชันต่างๆ เป็นครั้งคราว
• เวอร์ชัน 3.50 จะใช้ไม่ได้อีกต่อไป ระบบจะไม่สนใจความพยายามโหลดเวอร์ชันนี้ และคุณจะได้รับช่องเริ่มต้นแทน

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

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

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

วิธีแก้ปัญหาชั่วคราวคือคุณสามารถกําหนดค่าแอปพลิเคชันของคุณใหม่เพื่อใช้เวอร์ชันเก่า

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

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

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

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

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

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