การย้ายข้อมูล: โมดูล Maps ใน google.load

ในวันที่ 13 ตุลาคม 2021 เราจะปิดบริการที่มีโมดูล "Maps" สำหรับ google.load ซึ่งหมายความว่าหลังจากวันที่ 13 ตุลาคม 2021 เป็นต้นไป หากคุณพยายามใช้โมดูล "Maps" ใน google.load คุณจะได้รับข้อผิดพลาด (ไม่รองรับโมดูล "Maps") และจะไม่มีแผนที่โหลดขึ้น คุณต้องเปลี่ยนไปใช้ทางเลือกอื่นเพื่อช่วยหลีกเลี่ยงความเสียหายที่อาจเกิดขึ้น

สิ่งที่ต้องทำ

ก่อนอื่น ให้นำแท็ก <script> ที่โหลดตัวโหลด google.load ออก แล้วนำการเรียกไปยัง google.load ออก หากคุณใช้ตัวโหลดของ Google สำหรับสิ่งอื่นๆ คุณสามารถคงแท็ก <script> ของตัวโหลดไว้ที่เดิมได้

ถัดไป ใช้วิธีการใหม่ในการโหลด Maps JavaScript API (เลือกข้อใดข้อหนึ่งต่อไปนี้)

• การโหลดแบบในหน้าโดยใช้แท็ก <script>
• การโหลดแบบไดนามิกจากไฟล์ JavaScript อื่น

ตัวอย่างปัจจุบันที่ใช้ตัวโหลดของ Google

ตัวอย่างต่อไปนี้แสดงวิธีการใช้เครื่องมือโหลดของ Google ในปัจจุบันเพื่อโหลด Maps JavaScript API (มีบล็อก <script> อยู่ 2 บล็อก)

ก่อน

<script type='text/javascript' src='https://www.google.com/jsapi'></script>
<script type='text/javascript'>
google.load("maps", "3.exp", {
    "callback": initMap,
    "key": "YOUR_KEY",
    "libraries": "places,visualization"
});
function initMap() {
  // Google Maps JS API is loaded and available
}
</script>

การโหลดแบบอินไลน์โดยใช้แท็ก <script> (แนะนำ)

เมื่อใช้วิธีนี้ Maps JavaScript API จะโหลดในเวลาเดียวกับการโหลดหน้าเว็บ ในการใช้การโหลดแบบอินไลน์ ก่อนอื่นให้แทนที่แท็ก <script> ที่โหลด www.google.com/jsapi ("ก่อน") ด้วยแท็ก <script> ที่แสดงในตัวอย่างต่อไปนี้

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

จากนั้นในโค้ด JavaScript ให้นำการเรียกใช้ฟังก์ชัน google.load ออก เนื่องจากไม่จำเป็นต้องใช้อีกต่อไป ตัวอย่างต่อไปนี้แสดงฟังก์ชัน initMap() ที่ว่างเปล่า ซึ่งจะเรียกใช้เมื่อโหลดไลบรารี Maps สำเร็จ

<script type='text/javascript'>
function initMap() {
  // Google Maps JS API is loaded and available
}
</script>

ดูเอกสารประกอบ

การโหลดแบบไดนามิกจากไฟล์ JavaScript อื่น

การโหลดแบบไดนามิกช่วยให้คุณควบคุมได้ว่า Maps JavaScript API จะโหลดเมื่อใด เช่น คุณอาจรอให้โหลด Maps JavaScript API เสร็จจนกว่าผู้ใช้จะคลิกปุ่มหรือดำเนินการอย่างอื่น ในการใช้การโหลดแบบไดนามิก ให้แทนที่แท็ก <script> ที่โหลด www.google.com/jsapi ("before") ด้วยโค้ดเพื่อเพิ่มแท็ก <script> แบบเป็นโปรแกรมดังที่แสดงในตัวอย่างต่อไปนี้

var script = document.createElement('script');
script.src =
'https://maps.googleapis.com/maps/api/js?libraries=places,visualization&key=YOUR_API_KEY&v=weekly&callback=initMap';
script.async=true;

จากนั้นแนบฟังก์ชันเรียกกลับกับออบเจ็กต์หน้าต่าง ดังนี้

window.initMap = function() {
  // Google Maps JS API is loaded and available
};

สุดท้าย เพิ่มแท็ก <script> ในส่วนหัวของหน้าเว็บ ดังนี้

document.head.appendChild(script);

ดูเอกสารประกอบ