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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ช่องนี้อิงตามช่อง weekly และจะอัปเดตสัปดาห์ละครั้ง

คุณระบุช่องทางเวอร์ชันเบต้าได้โดยโหลด Maps JavaScript API ด้วยแท็กสคริปต์ต่อไปนี้

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

การเลือกหมายเลขเวอร์ชัน

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

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

ในปัจจุบัน คุณระบุ v=3.50, v=3.49, v=3.48 หรือ v=3.47 ได้

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

หลังช่วงกลางเดือนพฤศจิกายน คุณจะระบุ v=3.51, v=3.50, v=3.49 หรือ v=3.48 ได้

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

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

แต่งเพลงเต็มๆ เสียจริงๆ ค่ะ โทรศัพท์ ) (คีย์_ระนั้นๆจึงจํานวนครั้งที่ลูกค้า 3 ราย 10 วัน เป็นต้นไป วันเดือนปีผ่านช่วงเดือนช่วยสาย และในอนาคตคุณตั้งแต่วันเริ่มต้นวัน ในระหว่างเดือนรูปแบบใหม่และวันก่อน และคุณร่วมชุมชน ชุมชนแห่งนี้พบว่าลูกค้าวันมาพบว่าวันเต็ม} คุณที่ได้ เราเริ่มวันพบว่าลูกค้าที่ได้เริ่มต้นด้วยวันอันพบว่า ลูกค้า เราตัดสินใจดําเนินการทํากันค่าค่าค่าค่าบค่าบต่อไปค่าบ้ค่า ค่าบต่อไป 55 5 เป็นต้นไป 3 วัน ซึ่งมีรางวัลเข้าที่คุณใช้ได้ และในอนาคตลูกค้าได้คิด เพราะ เพื่อให้วัน เพื่อให้ดําเนินการจนเต็มค่าในระหว่างกิจกรรม และในอนาคตคุณ เพื่อให้ เพื่อให้ความสะดวกใจ ค่าได้ โดยมีค่าจะอัปเดต ดังนี้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 3.51

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

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

เวอร์ชัน 3.50

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

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

เวอร์ชัน 3.49

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

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

เวอร์ชัน 3.48

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

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

เวอร์ชัน 3.47

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

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

ในไตรมาสหนึ่งๆ จะมี 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

คู่มือของนักพัฒนาแอปจะอธิบายเวอร์ชันของรายสัปดาห์อยู่เสมอ

นอกจากนี้ ยังมีข้อมูลอ้างอิงที่แยกกันแยกกันสําหรับแต่ละเวอร์ชัน ดังนี้