Bắt đầu

Chọn nền tảng: Android iOS JavaScript

Hãy làm theo các bước sau để thiết lập điểm đánh dấu nâng cao.

Lấy khoá API và bật Maps JavaScript API

Trước khi sử dụng các điểm đánh dấu nâng cao, bạn cần có một dự án trên Đám mây có tài khoản thanh toán và đã bật Maps JavaScript API. Để tìm hiểu thêm, hãy xem bài viết Thiết lập dự án của bạn trên Google Cloud.

Lấy khoá API

Tạo mã bản đồ

Để tạo một mã bản đồ mới, hãy làm theo các bước trong phần Tuỳ chỉnh trên đám mây. Đặt Loại bản đồ thành JavaScript, rồi chọn Vector (Véc tơ) hoặc Raster (Raster).

Lưu ý quan trọng: Để kiểm thử, bạn có thể bỏ qua bước tạo và định cấu hình mã bản đồ bằng cách sử dụng mapId: 'DEMO_MAP_ID' trong mã ứng dụng.

Cập nhật mã khởi chạy bản đồ

Bạn cần có mã bản đồ mà bạn vừa tạo. Bạn có thể tìm thấy thông tin này trên trang Quản lý Maps.

1. Tải Maps JavaScript API.

2. Tải thư viện điểm đánh dấu nâng cao từ bên trong một hàm async khi cần:

   const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

3. Cung cấp mã bản đồ khi bạn tạo bản đồ bằng cách sử dụng thuộc tính mapId. Đây có thể là mã bản đồ mà bạn cung cấp hoặc DEMO_MAP_ID.

   const map = new
   google.maps.Map(document.getElementById('map'), {
     center: {lat: -34.397, lng: 150.644},
     zoom: 8,
     mapId: 'YOUR_MAP_ID'
   });

Thận trọng: Các bản đồ mẫu cho điểm đánh dấu nâng cao sử dụng mã bản đồ được liên kết với kiểu bản đồ có số lượng địa điểm yêu thích (POI) ít hơn. Nếu dùng lại mã mẫu, bạn nên thay thế các mã bản đồ này bằng DEMO_MAP_ID hoặc bằng mã bản đồ của riêng bạn.

Kiểm tra các chức năng của bản đồ (không bắt buộc)

Điểm đánh dấu nâng cao cần có mã bản đồ. Nếu thiếu mã bản đồ, điểm đánh dấu nâng cao sẽ không tải được. Để khắc phục sự cố, bạn có thể thêm trình nghe mapcapabilities_changed để đăng ký nhận thông báo về các thay đổi đối với chức năng bản đồ. Bạn không bắt buộc phải sử dụng Các chức năng của bản đồ và chỉ nên sử dụng cho mục đích kiểm thử và khắc phục sự cố hoặc cho mục đích dự phòng trong thời gian chạy.

// Optional: subscribe to map capability changes.
map.addListener('mapcapabilities_changed', () => {
  const mapCapabilities = map.getMapCapabilities();

  if (!mapCapabilities.isAdvancedMarkersAvailable) {
    // Advanced markers are *not* available, add a fallback.
  }
});

Các bước tiếp theo

Tạo một điểm đánh dấu nâng cao mặc định