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 "Maps" cho google.load. Điều này có nghĩa là sau ngày 13 tháng 10 năm 2021, nếu bạn cố gắng sử dụng mô-đun "Maps" trong google.load, bạn sẽ nhận được một lỗi (module "maps" is not supported) và không có bản đồ nào tải. Để tránh các sự cố tiềm ẩn, 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 bạn đang sử dụng Trình tải của Google 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 API JavaScript của Maps (chọn một trong các lựa chọn sau):

Ví dụ hiện tại sử dụng Trình tải của Google

Ví dụ sau đây cho thấy cách Trình tải của Google hiện được dùng để tải API JavaScript của Maps (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 bạn sử dụng phương pháp này, API JavaScript của Maps 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> 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ữ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 API JavaScript của Maps 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 ("trước") 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 đó, hãy đí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