Di chuyển: Mô-đun Maps trong google.load

Từ ngày 13 tháng 10 năm 2021, chúng tôi sẽ ngừng dịch vụ cung cấp mô-đun "Maps" cho google.load. Điều này có nghĩa là sau ngày 13 tháng 10 năm 2021, nếu cố sử dụng mô-đun "Maps" trong google.load, bạn sẽ nhận được thông báo lỗi (mô-đun "bản đồ" không được hỗ trợ) và sẽ không có bản đồ nào được tải. Để tránh nguy cơ gặp sự cố, bạn phải chuyển sang một trong các giải pháp thay thế.

Việc bạn cần làm

Trước tiên, hãy xoá thẻ <script> tải trình tải google.load, sau đó xoá các lệnh gọi đến google.load. Nếu đang sử dụng Google Loader cho những mục đích khác, bạn có thể giữ nguyên thẻ <script> của trình tải.

Tiếp theo, hãy triển khai cách mới để tải Maps JavaScript API (chọn một trong các tuỳ chọn sau):

Ví dụ hiện tại về việc sử dụng Google Loader

Ví dụ sau đây cho thấy cách Google Loader hiện đang được dùng để tải Maps JavaScript API (có hai khối <script>):

Trước

<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>

Khi phương pháp này được sử dụng, API JavaScript của Maps sẽ tải cùng lúc với thời điểm tải trang. Để triển khai tính năng tải nội tuyến, trước tiên, hãy thay thế thẻ <script> tải www.google.com/jsapi ("before") bằng thẻ <script> như trong ví dụ sau:

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

Sau đó, trong mã javascript của bạn, hãy xoá lệnh gọi hàm google.load vì nó không còn cần thiết nữa. Ví dụ sau đây cho thấy một hàm initMap() trống, được gọi khi thư viện Maps đã tải thành công:

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

Xem tài liệu

Tải động từ một tệp JavaScript khác

Tính năng tải động cho phép bạn kiểm soát thời điểm tải API JavaScript của Maps. Ví dụ: bạn có thể chờ tải API JavaScript Maps cho đến khi người dùng nhấp vào nút hoặc thực hiện một hành động khác. Để triển khai tính năng tải động, trước tiên, hãy thay thế thẻ <script> tải www.google.com/jsapi ("before") bằng mã để thêm thẻ <script> theo phương thức lập trình, như trong ví dụ sau:

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;

Sau đó, đính kèm hàm callback vào đối tượng cửa sổ như sau:

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

Cuối cùng, hãy thêm thẻ <script> vào tiêu đề của trang như sau:

document.head.appendChild(script);

Xem tài liệu