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 cố gắng sử dụng mô-đun "Maps" trong google.load, bạn sẽ gặp lỗi (mô-đun "maps" không được hỗ trợ) và không có bản đồ nào tải được. Để tránh nguy cơ bị hỏng, 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 Google cho các mục 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 một cách mới để tải API JavaScript của Maps (chọn một trong các tuỳ chọn sau):

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

Ví dụ sau đây cho thấy cách Trình tải Google hiện được dùng để tải API Maps JavaScript (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 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 cùng dòng, trước tiên, hãy thay thế thẻ <script> tải www.google.com/jsapi ("trước") 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, hãy xoá lệnh gọi hàm google.load vì lệnh gọi này 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ể đợ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ư 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