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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.57
        &key=YOUR_API_KEY&callback=initMap">
</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 จะไม่มีให้บริการอีกต่อไป ความพยายามโหลดเวอร์ชันนี้ จะถูกละเว้น และคุณจะได้รับช่องเริ่มต้นของคุณแทน

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

v=weekly v=รายไตรมาส v=3.nn v=3.nn-1 ส.ค. 2024 พ.ย. 2024 ก.พ. 2025 พฤษภาคม 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ขณะนี้ช่องทางรายไตรมาสเปลี่ยนไปใช้เวอร์ชัน 3.57

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

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

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

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

เวอร์ชัน 3.59

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

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

เวอร์ชัน 3.58

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

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

เวอร์ชัน 3.57

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

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

เวอร์ชัน 3.56

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

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

เวอร์ชัน 3.55

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

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

โดยในแต่ละไตรมาสจะมีให้เลือก 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

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

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