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

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

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

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

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

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

เลือกแชแนลรายสัปดาห์

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

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

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

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

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

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

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

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

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

เราขอแนะนำให้คุณทดสอบแอปพลิเคชันโดยใช้ v=3.56 ในช่วงต้นเดือนพฤษภาคม

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

ใช้เวอร์ชันเบต้าเพื่อลองใช้ฟีเจอร์และการเปลี่ยนแปลงเบต้าใหม่ๆ ฟีเจอร์เบต้า เป็นฟีเจอร์ที่สมบูรณ์แต่อาจมีปัญหาบางประการ (โปรดใช้ เครื่องมือติดตามปัญหา เพื่อรายงานปัญหาและแสดงความคิดเห็น) เวอร์ชันเบต้าจะไม่อยู่ภายใต้ 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.55
        &key=YOUR_API_KEY&callback=initMap">
</script>

ปัจจุบันคุณระบุ v=3.56, v=3.55, v=3.54 หรือ v=3.53 ได้

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

หลังช่วงกลางเดือนพฤษภาคม คุณจะระบุ v=3.57, v=3.56, v=3.55 หรือ v=3.54 ได้

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

หากคุณใช้ v=3.54 หรือ v=3.53 เราขอแนะนำให้อัปเกรดเป็น v=3.56 หรือ v=3.55 ก่อนกลางเดือนพฤษภาคม เมื่อเปลี่ยนเวอร์ชัน โปรดทราบว่าเวอร์ชันใหม่ๆ อาจนำฟีเจอร์ที่เลิกใช้งานแล้วออกและ/หรือทำให้เกิดความไม่เข้ากันแบบย้อนหลัง

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

<br-ph01 <br - {0}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ข้อมูลอัปเดตเกี่ยวกับช่องรายไตรมาส

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

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

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

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

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

เวอร์ชัน 3.57

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

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

เวอร์ชัน 3.56

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

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

เวอร์ชัน 3.55

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

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

เวอร์ชัน 3.54

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

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

เวอร์ชัน 3.53

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

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

ในแต่ละไตรมาสจะมีให้เลือก 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.56 (ช่องทางรายสัปดาห์)
• เอกสารอ้างอิง API เวอร์ชัน 3.55 (ช่องทางรายไตรมาส)
• ข้อมูลอ้างอิง API เวอร์ชัน 3.54
• ข้อมูลอ้างอิง API เวอร์ชัน 3.53
• มีการลบเวอร์ชัน 3.0 ถึง 3.52