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

Vào ngày 13 tháng 10 năm 2021, chúng tôi sẽ tắt dịch vụ cung cấp mô-đun "Bản đồ" cho google.load. Điều này có nghĩa là sau ngày 13 tháng 10 năm 2021, nếu cố gắng sử dụng mô-đun "Maps" trong google.load, bạn sẽ nhận được lỗi (mô-đun "maps" không được hỗ trợ) và không có bản đồ nào tải. Để tránh trường hợp có thể xảy ra lỗi, bạn phải chuyển sang một trong các lựa chọn 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 bạn đang sử dụng Google Loader cho những việc khác, thì bạn có thể giữ nguyên thẻ <script> của trình tải.

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

Ví dụ hiện tại sử dụng Google Loader

Ví dụ sau đây cho thấy cách Trình tải Google hiện được dùng để tải Maps JavaScript API (có 2 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, Maps JavaScript API sẽ tải cùng lúc vớ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 ("trước") bằng thẻ <script> xuất hiện 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, hãy xoá lệnh gọi hàm google.load vì bạn không cần dùng đến hàm này nữa. Ví dụ sau đây cho thấy một hàm initMap() trống. Hàm này đượ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ể đợi tải Maps JavaScript API cho đến khi người dùng nhấp vào một nút hoặc thực hiện một thao tác 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ư minh hoạ 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 đó, hãy đính kèm hàm gọi lại 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