ทีม 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 จะไม่มีให้บริการอีกต่อไป ความพยายามโหลดเวอร์ชันนี้ จะถูกละเว้น และคุณจะได้รับช่องเริ่มต้นของคุณแทน
แผนภาพด้านล่างแสดงเวอร์ชันที่พร้อมใช้งานในแต่ละช่อง ในช่วงปีหน้า
การอัปเดตส่งผลกระทบต่อแอปพลิเคชันของฉัน
การอัปเดตเวอร์ชันการเผยแพร่อาจส่งผลต่อแอปพลิเคชันของคุณ ปัญหานี้อาจเกิดขึ้นเนื่องจาก แอปพลิเคชันของคุณกำลังใช้ฟีเจอร์ที่ไม่ได้ระบุไว้หรือเลิกใช้งานแล้ว หรือเนื่องจากมีข้อบกพร่องหรือข้อบกพร่อง ที่เราได้แนะนำไปแล้ว
เพื่อเป็นการแก้ไขปัญหาชั่วคราว คุณสามารถกำหนดค่าแอปพลิเคชันของคุณใหม่ให้ใช้เวอร์ชันเก่าได้
- เปิดคอนโซลในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ แล้วดูค่าของ
google.maps.version
- อัปเดตแท็กสคริปต์ที่โหลด 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
คู่มือสำหรับนักพัฒนาซอฟต์แวร์ จะอธิบายเวอร์ชันรายสัปดาห์เสมอ
นอกจากนี้ ยังมีการอ้างอิงที่เก็บรักษาไว้แยกกันสำหรับแต่ละเวอร์ชัน:
- เอกสารอ้างอิง API เวอร์ชัน 3.58 (เวอร์ชันรายสัปดาห์)
- เอกสารอ้างอิง API เวอร์ชัน 3.57 (เวอร์ชันรายไตรมาส)
- เอกสารอ้างอิง API เวอร์ชัน 3.56
- เอกสารอ้างอิง API เวอร์ชัน 3.55
- เวอร์ชัน 3.0 ถึง 3.54 ถูกลบแล้ว