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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

การเลือกรุ่นเบต้า

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

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

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

หลังช่วงกลางเดือนพฤษภาคม คุณจะระบุ v=3.53, v=3.52, v=3.51 หรือ v=3.50 ได้

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

หากคุณใช้ v=3.50 หรือ v=3.49 เราขอแนะนําให้อัปเกรดเป็น v=3.52 หรือ v=3.51 ก่อนกลางเดือนพฤษภาคม เมื่อเปลี่ยนเวอร์ชัน โปรดทราบว่าเวอร์ชันใหม่อาจนําฟีเจอร์ที่เลิกใช้งานแล้วออกและ/หรือเปิดตัวความไม่เข้ากันแบบย้อนหลัง

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

)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 3.53

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

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

เวอร์ชัน 3.52

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

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

เวอร์ชัน 3.51

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

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

เวอร์ชัน 3.50

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

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

เวอร์ชัน 3.49

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

การสนับสนุนเวอร์ชัน

ในไตรมาสหนึ่งจะมี 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.52 (ช่องรายสัปดาห์)
• เอกสารอ้างอิง API เวอร์ชัน 3.51 (แชแนลรายไตรมาส)
• เอกสารอ้างอิง API เวอร์ชัน 3.50
• เอกสารอ้างอิง API เวอร์ชัน 3.49
• มีการลบเวอร์ชัน 3.0 ถึง 3.48