ทีม Maps JavaScript API คอยอัปเดต API ให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และปรับปรุงประสิทธิภาพเป็นประจำ หน้านี้อธิบายเวอร์ชันของ API ที่พร้อมใช้งานในแอปพลิเคชัน
เวอร์ชันการเผยแพร่และหมายเลขเวอร์ชัน
คุณสามารถระบุเวอร์ชันการเผยแพร่หรือหมายเลขเวอร์ชันในแอปพลิเคชันของคุณได้ ดังนี้
- ช่องรายสัปดาห์จะระบุด้วย
v=weekly
ช่องนี้ได้รับการอัปเดตสัปดาห์ละครั้งและเป็นข้อมูลล่าสุด - แชแนลรายไตรมาสจะระบุด้วย
v=quarterly
ช่องนี้ได้รับการอัปเดต 1 ครั้งต่อไตรมาสและคาดการณ์ได้มากที่สุด - มีการระบุเวอร์ชันเบต้าด้วย
v=beta
ช่องนี้อิงตามช่องweekly
และอัปเดตสัปดาห์ละครั้ง ซึ่งจะรวมถึงการเปลี่ยนแปลงเพิ่มเติมสำหรับการทดสอบในระยะแรกและความคิดเห็น - ช่องทางอัลฟ่าจะระบุด้วย
v=alpha
ช่องนี้อิงตามช่องbeta
และอัปเดตสัปดาห์ละครั้ง มีการทดสอบเพื่อรับความคิดเห็นของลูกค้าเกี่ยวกับต้นแบบ มีไว้เพื่อการพัฒนาเท่านั้น และไม่ควรใช้ในเวอร์ชันที่ใช้งานจริง - หมายเลขเวอร์ชันจะระบุด้วย
v=n.nn
คุณจะเลือกv=3.57
,v=3.56
,v=3.55
หรือv=3.54
ก็ได้
หมายเลขเวอร์ชันจะอัปเดตไตรมาสละ 1 ครั้ง (ดูการอัปเดตรายไตรมาส)
หากคุณไม่ได้ระบุเวอร์ชันหรือเวอร์ชันอย่างชัดเจน คุณจะได้รับช่องรายสัปดาห์โดยค่าเริ่มต้น หากย้ายข้อมูลจากแพ็กเกจพรีเมียมและไม่ได้ระบุเวอร์ชันหรือเวอร์ชันอย่างชัดเจน คุณจะได้รับช่องทางรายไตรมาสโดยค่าเริ่มต้น หากระบุเวอร์ชันไม่ถูกต้อง คุณจะได้รับช่องเริ่มต้น
เลือกแชแนลรายสัปดาห์
สำหรับการสมัครส่วนใหญ่ เราจะแนะนำช่องรายสัปดาห์ เวอร์ชันนี้เป็นเวอร์ชันล่าสุดและเป็นปัจจุบัน มีการแก้ไขข้อบกพร่องล่าสุดและปรับปรุงประสิทธิภาพ คุณระบุช่องรายสัปดาห์ได้โดยการโหลด Maps JavaScript API ด้วยแท็กสคริปต์ต่อไปนี้
<script async
src="https://maps.googleapis.com/maps/api/js?v=weekly
&key=YOUR_API_KEY&callback=initMap">
</script>
ขณะนี้ช่องรายสัปดาห์คือเวอร์ชัน 3.57 เวอร์ชันนี้ได้รับการอัปเดตทุกสัปดาห์พร้อมด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ
ในช่วงกลางเดือนสิงหาคม ช่องรายสัปดาห์จะได้รับการอัปเดตเป็นเวอร์ชัน 3.58 ซึ่งเมื่อถึงตอนนั้น เวอร์ชันใหม่อาจนำฟีเจอร์ที่เลิกใช้งานแล้วออกและ/หรือทำให้เกิดความไม่เข้ากันแบบย้อนหลัง
การเลือกช่องทางรายไตรมาส
แอปพลิเคชันบางรายการอาจได้ประโยชน์จากการอัปเดตที่น้อยลงแต่มีขนาดใหญ่ขึ้น เนื่องจากให้ความสามารถในการคาดการณ์ได้มากกว่า แอปพลิเคชันเหล่านี้ควรใช้เวอร์ชันรายไตรมาส ใช้วิธีการนี้หากต้องการให้การแก้ไขข้อบกพร่องและการปรับปรุงประสิทธิภาพมาถึงในเวลาที่คาดไว้ (ดูการอัปเดตรายไตรมาส) คุณระบุช่องทางรายไตรมาสได้โดยโหลด Maps JavaScript API ด้วยแท็กสคริปต์ต่อไปนี้
<script async
src="https://maps.googleapis.com/maps/api/js?v=quarterly
&key=YOUR_API_KEY&callback=initMap">
</script>
ขณะนี้เวอร์ชันรายไตรมาสเป็นเวอร์ชัน 3.56 ในระหว่างไตรมาส เวอร์ชันนี้จะไม่ได้รับฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือการปรับปรุงประสิทธิภาพ เราอาจแนะนำการแก้ไขข้อบกพร่องด้านความปลอดภัยในเวอร์ชันนี้เป็นครั้งคราว
ในช่วงกลางเดือนสิงหาคม เราจะอัปเดตช่องรายไตรมาสเป็นเวอร์ชัน 3.57 ซึ่งเมื่อถึงเวลานั้น เวอร์ชันใหม่จะมีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความไม่เข้ากันแบบย้อนหลังจากช่วง 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.56
&key=YOUR_API_KEY&callback=initMap">
</script>
ปัจจุบันคุณระบุ v=3.57
, v=3.56
, v=3.55
หรือ v=3.54
ได้
- เวอร์ชัน 3.57 จะได้รับการอัปเดตรายสัปดาห์พร้อมฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ
- เวอร์ชัน 3.56 ไม่ได้รับการอัปเดตรายสัปดาห์
- เวอร์ชัน 3.55 ไม่ได้รับการอัปเดตรายสัปดาห์
- เวอร์ชัน 3.54 ไม่ได้รับการอัปเดตรายสัปดาห์
- บางครั้งเราอาจทำการแก้ไขข้อบกพร่องด้านความปลอดภัยในเวอร์ชันต่างๆ ได้
- เราอาจแสดงการเปลี่ยนแปลงที่ไม่สามารถใช้ร่วมกันได้แบบย้อนหลังเมื่อสร้างเวอร์ชันใหม่
หลังจากช่วงกลางเดือนสิงหาคมแล้ว คุณจะระบุ v=3.58
, v=3.57
, v=3.56
หรือ v=3.55
ได้
- เวอร์ชัน 3.58 จะได้รับการอัปเดตรายสัปดาห์พร้อมฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ
- เวอร์ชัน 3.57 จะไม่ได้รับการอัปเดตรายสัปดาห์อีกต่อไป
- เวอร์ชัน 3.56 จะไม่ได้รับการอัปเดตรายสัปดาห์อีกต่อไป
- เวอร์ชัน 3.55 จะไม่ได้รับการอัปเดตรายสัปดาห์อีกต่อไป
- บางครั้งเราอาจทำการแก้ไขข้อบกพร่องด้านความปลอดภัยในเวอร์ชันต่างๆ ได้
- เวอร์ชัน 3.54 จะไม่มีให้ใช้งานอีกต่อไป ระบบจะไม่พิจารณาการพยายามโหลดเวอร์ชันนี้ และคุณจะได้รับช่องเริ่มต้นแทน
แผนภาพด้านล่างแสดงเวอร์ชันที่จะพร้อมให้รับชมในแต่ละช่องทางในปีถัดไป
การอัปเดตส่งผลต่อแอปพลิเคชันของฉัน
การอัปเดตเวอร์ชันการเผยแพร่อาจส่งผลต่อแอปพลิเคชันของคุณ ปัญหานี้อาจเกิดขึ้นเนื่องจากแอปพลิเคชันของคุณอาศัยฟีเจอร์ที่ไม่มีเอกสารประกอบหรือเลิกใช้งาน หรือเนื่องจากข้อบกพร่องหรือการแก้ไขข้อบกพร่องที่เราได้แนะนําไป
เพื่อเป็นการแก้ปัญหาชั่วคราว คุณสามารถกำหนดค่าแอปพลิเคชันของคุณใหม่ให้ใช้เวอร์ชันเก่าได้
- เปิดคอนโซลในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ และดูค่าของ
google.maps.version
- อัปเดตแท็กสคริปต์ที่โหลด API และขอหมายเลขเวอร์ชันเก่า
เช่น หากgoogle.maps.version
คือ "3.57.2" ให้ใช้v=3.56
ในแท็กสคริปต์
วิธีแก้ปัญหาชั่วคราวนี้จะใช้งานได้ในระยะเวลาจำกัดเท่านั้น
เมื่อมีวิธีแก้ปัญหาชั่วคราวแล้ว คุณจะมีเวลา (โดยปกติ 3-6 เดือน) ในการอัปเดตแอปพลิเคชัน เพื่อไม่ให้ใช้ฟีเจอร์ที่ไม่มีเอกสารประกอบหรือเลิกใช้งาน และบัญชีสำหรับข้อบกพร่องหรือการแก้ไขข้อบกพร่องอีกต่อไป
จากนั้นคุณควรเปลี่ยนกลับไปใช้แท็กสคริปต์เดิมเพื่อโหลด API
คุณสามารถสร้างเคสขอรับความช่วยเหลือหรือรายงานปัญหาได้ด้วย
ข้อมูลอัปเดตรายไตรมาส
ทีม Maps JavaScript API จะเผยแพร่เวอร์ชันใหม่ประมาณไตรมาสละครั้ง การดำเนินการนี้จะเกิดขึ้นในช่วงกลางเดือนกุมภาพันธ์ กลางเดือนพฤษภาคม กลางเดือนสิงหาคม และกลางเดือนพฤศจิกายน การอัปเดตครั้งถัดไปจะเป็นช่วงกลางเดือนสิงหาคม ช่องรายสัปดาห์ใหม่จะมีเวอร์ชัน 3.58 และเมื่อถึงเวลานั้นช่องอื่นๆ จะได้รับการอัปเดต
อัปเดตรายสัปดาห์ของช่อง
ขณะนี้ช่องรายสัปดาห์ชี้ไปที่เวอร์ชัน 3.57
ในช่วงกลางเดือนสิงหาคม ช่องรายสัปดาห์จะได้รับการอัปเดตจากเวอร์ชัน 3.57 เป็นเวอร์ชัน 3.58 ณ จุดนี้ เวอร์ชันใหม่จะมีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความไม่เข้ากันแบบย้อนหลัง คุณอาจต้องทดสอบการเปลี่ยนแปลงเหล่านี้เมื่ออัปเดตช่องแล้ว
ตลอดไตรมาสนี้ เวอร์ชันใหม่จะได้รับการอัปเดตทุกสัปดาห์เพื่อเพิ่มฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ แต่จะไม่นำฟีเจอร์ที่เลิกใช้งานแล้วออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้แบบย้อนหลัง
ข้อมูลอัปเดตเกี่ยวกับช่องรายไตรมาส
ปัจจุบันช่องรายไตรมาสจะชี้ไปที่เวอร์ชัน 3.56
ในช่วงกลางเดือนสิงหาคม เราจะอัปเดตช่องรายไตรมาสจากเวอร์ชัน 3.56 เป็นเวอร์ชัน 3.57 เวอร์ชันอัปเดตนี้จะมีฟีเจอร์ใหม่ๆ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความเข้ากันไม่ได้แบบย้อนหลังจากช่วง 3 เดือนที่ผ่านมา คุณอาจต้องทดสอบการเปลี่ยนแปลงเหล่านี้เมื่ออัปเดตช่องแล้ว
ตลอดไตรมาส เวอร์ชันนี้จะไม่มีฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง หรือการปรับปรุงประสิทธิภาพ แต่จะไม่นำฟีเจอร์ที่เลิกใช้งานแล้วออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้แบบย้อนหลัง
การอัปเดตเวอร์ชัน
ในช่วงกลางเดือนสิงหาคม เราจะรวมหมายเลขเวอร์ชันเพื่อรองรับการเปิดตัวเวอร์ชันใหม่
เวอร์ชัน 3.58
เวอร์ชัน 3.58 ใหม่จะเปิดตัวในช่วงกลางเดือนสิงหาคม เมื่อเปิดตัว เวอร์ชันนี้จะมีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความเข้ากันไม่ได้แบบย้อนหลังเมื่อเทียบกับเวอร์ชัน 3.57 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน
ในระหว่างไตรมาส เราจะอัปเดตเวอร์ชันใหม่ทุกสัปดาห์พร้อมด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ แต่จะไม่นำฟีเจอร์ที่เลิกใช้งานแล้วออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้แบบย้อนหลัง
เวอร์ชัน 3.57
เวอร์ชันนี้ประกอบด้วยฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความเข้ากันไม่ได้แบบย้อนหลังเมื่อเทียบกับเวอร์ชัน 3.56 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน
หลังจากกลางเดือนสิงหาคมไปแล้ว เราจะไม่อัปเดตเวอร์ชันนี้ให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง หรือการปรับปรุงประสิทธิภาพอีกต่อไป แต่จะไม่นำฟีเจอร์ที่เลิกใช้งานแล้วออกและจะไม่ทำให้เกิดความเข้ากันไม่ได้แบบย้อนหลัง
เวอร์ชัน 3.56
เวอร์ชันนี้มีฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความเข้ากันไม่ได้แบบย้อนหลังเมื่อเทียบกับเวอร์ชัน 3.55 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน
เวอร์ชันนี้จะไม่อัปเดตให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง หรือการปรับปรุงประสิทธิภาพอีกต่อไป การดำเนินการนี้จะไม่นำฟีเจอร์ที่เลิกใช้งานหลังจากเวอร์ชันนี้ออก และจะไม่เพิ่มความไม่เข้ากันแบบย้อนหลังใหม่
เวอร์ชัน 3.55
เวอร์ชันนี้ประกอบด้วยฟีเจอร์ใหม่ นำฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือนำเสนอความเข้ากันไม่ได้แบบย้อนหลังเมื่อเทียบกับเวอร์ชัน 3.54 คุณควรทดสอบแอปพลิเคชันเมื่อเปลี่ยนหมายเลขเวอร์ชัน
เวอร์ชันนี้จะไม่อัปเดตให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง หรือการปรับปรุงประสิทธิภาพอีกต่อไป การดำเนินการนี้จะไม่นำฟีเจอร์ที่เลิกใช้งานหลังจากเวอร์ชันนี้ออก และจะไม่เพิ่มความไม่เข้ากันแบบย้อนหลังใหม่
เวอร์ชัน 3.54
หลังจากช่วงกลางเดือนสิงหาคม ระบบจะลบเวอร์ชันนี้และจะใช้ไม่ได้อีกต่อไป ระบบจะไม่พิจารณาการพยายามโหลดเวอร์ชันนี้ และคุณจะได้รับช่องเริ่มต้นแทน
การรองรับเวอร์ชัน
ในแต่ละไตรมาสจะมีให้เลือก 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.57 (ช่องทางรายสัปดาห์)
- เอกสารอ้างอิง API เวอร์ชัน 3.56 (ช่องทางรายไตรมาส)
- ข้อมูลอ้างอิง API เวอร์ชัน 3.55
- ข้อมูลอ้างอิง API เวอร์ชัน 3.54
- มีการลบเวอร์ชัน 3.0 ถึง 3.53