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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ในช่วงกลางเดือนพฤศจิกายน ระบบจะอัปเดตเวอร์ชันรายไตรมาสเป็นเวอร์ชัน 3.54 เมื่อถึงเวลานั้น เวอร์ชันใหม่จะรวมฟีเจอร์ใหม่ นําฟีเจอร์ที่เลิกใช้งานแล้วออก และ/หรือเปิดตัวความไม่เข้ากันแบบย้อนหลังจาก 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.53
        &key=YOUR_API_KEY&callback=initMap">
</script>

ปัจจุบันระบุ v=3.54, v=3.53, v=3.52 หรือ v=3.51 ได้

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

หลังช่วงกลางเดือนพฤศจิกายน คุณจะระบุ v=3.55, v=3.54, v=3.53 หรือ v=3.52 ได้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 3.55

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

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

เวอร์ชัน 3.54

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

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

เวอร์ชัน 3.53

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

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

เวอร์ชัน 3.52

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

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

เวอร์ชัน 3.51

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

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

ในแต่ละไตรมาสจะมี 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

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

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