ทีม 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 เดือนที่ผ่านมาออก
การเลือกรุ่นเบต้า
ใช้เวอร์ชันเบต้าเพื่อลองใช้ฟีเจอร์และการเปลี่ยนแปลงใหม่ๆ เวอร์ชันเบต้า ฟีเจอร์ของรุ่นเบต้า เสร็จสมบูรณ์ แต่อาจมีปัญหาที่เหลือ (โปรดใช้เครื่องมือติดตามปัญหาเพื่อรายงานปัญหาและแสดงความคิดเห็น) เวอร์ชันเบต้าไม่ครอบคลุมโดย 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 จะใช้งานไม่ได้อีกต่อไป การพยายามโหลดเวอร์ชันนี้จะถูกละเว้นและคุณจะได้รับช่องเริ่มต้นแทน
แผนภาพด้านล่างแสดงเวอร์ชันที่พร้อมใช้งานในแต่ละช่องทางในปีหน้า
)การอัปเดตส่งผลกระทบต่อแอปพลิเคชันของฉัน
การอัปเดตเวอร์ชันการเผยแพร่อาจส่งผลต่อแอปพลิเคชันของคุณ ข้อผิดพลาดนี้อาจเกิดขึ้นเนื่องจากแอปพลิเคชันของคุณต้องใช้ฟีเจอร์ที่ไม่ได้บันทึกไว้หรือเลิกใช้งานไปแล้ว หรือเพราะข้อบกพร่องหรือข้อบกพร่องที่เราเปิดตัวไป
ในการแก้ปัญหาชั่วคราว คุณสามารถกําหนดค่าแอปพลิเคชันใหม่เพื่อใช้เวอร์ชันเก่าได้
- เปิดคอนโซลในเครื่องมือสําหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ และดูที่ค่าของ
google.maps.version
- อัปเดตแท็กสคริปต์ที่โหลด API และขอหมายเลขเวอร์ชันที่เก่ากว่า
เช่น หากgoogle.maps.version
คือ "3.52.2" ให้ใช้v=3.51
ในแท็กสคริปต์
วิธีแก้ปัญหาชั่วคราวนี้จะใช้ได้เฉพาะกับช่วงเวลาจํากัดเท่านั้น
เมื่อมีวิธีแก้ปัญหาชั่วคราว คุณจะมีเวลา (โดยปกติคือ 3 ถึง 6 เดือน) ในการอัปเดตแอปพลิเคชัน เพื่อไม่ให้ใช้ฟีเจอร์ที่ไม่ได้บันทึกไว้หรือเลิกใช้งานแล้ว รวมถึงแก้ไขข้อบกพร่องหรือแก้ไขข้อบกพร่องแล้ว
จากนั้นคุณควรเปลี่ยนกลับเป็นแท็กสคริปต์ต้นฉบับเพื่อโหลด API
นอกจากนี้ คุณยังสร้างเคสขอรับความช่วยเหลือหรือรายงานปัญหาได้ด้วย
การอัปเดตรายไตรมาส
ทีม Maps JavaScript API จะเปิดตัวเวอร์ชันใหม่ต่อไตรมาส เหตุการณ์นี้จะเกิดขึ้นในช่วงกลางเดือนกุมภาพันธ์ กลางเดือนพฤษภาคม กลางเดือนสิงหาคม และพฤศจิกายน การอัปเดตครั้งถัดไปจะเป็นช่วงกลางเดือนพฤษภาคม ช่องทางใหม่รายสัปดาห์จะแสดงเวอร์ชัน 3.53 และจะอัปเดตช่องอื่นๆ เมื่อถึงเวลานั้น
การอัปเดตช่องรายสัปดาห์
ขณะนี้ช่องรายสัปดาห์เป็นเวอร์ชัน 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