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.
Để 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).
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.
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',()=>{constmapCapabilities=map.getMapCapabilities();if(!mapCapabilities.isAdvancedMarkersAvailable){// Advanced markers are *not* available, add a fallback.}});
[null,null,["Cập nhật lần gần đây nhất: 2025-08-17 UTC."],[[["\u003cp\u003eGet started with advanced markers by obtaining an API key, enabling the Maps JavaScript API, and creating a map ID.\u003c/p\u003e\n"],["\u003cp\u003eUpdate your map initialization code to include loading the advanced markers library and providing a map ID when instantiating the map.\u003c/p\u003e\n"],["\u003cp\u003eFor testing purposes, use \u003ccode\u003eDEMO_MAP_ID\u003c/code\u003e as the map ID or utilize the provided example code, but replace the example map IDs for production.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, check map capabilities to ensure advanced markers are available or to implement a fallback if they are not supported.\u003c/p\u003e\n"]]],["To use advanced markers, you need a Cloud project with a billing account and the Maps JavaScript API enabled. First, obtain an API key and create a map ID, selecting JavaScript as the map type with either Vector or Raster options, or using `DEMO_MAP_ID` for testing. Update your map initialization code by loading the Maps JavaScript API and the advanced markers library. Instantiate the map with the created or demo map ID. Optionally, use a listener to check map capabilities.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/advanced-markers/start \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/advanced-markers/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/advanced-markers/start \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nFollow these steps to get set up with advanced markers.\n\nGet an API key and enable the Maps JavaScript API\n\nBefore using advanced markers, you need a Cloud\nproject with a billing account, and the Maps JavaScript API\nenabled. To learn more, see [Set up your Google Cloud project](/maps/documentation/javascript/cloud-setup).\n\n[Get an API key](/maps/documentation/javascript/get-api-key)\n\nCreate a map ID\n\nTo create a new [map ID](/maps/documentation/get-map-id), follow the steps in\n[Cloud customization](/maps/documentation/javascript/maps-customization-overview).\nSet the Map type to **JavaScript** , and select either the **Vector** or\n**Raster** option.\n| **Important:** For testing, you can skip the step of creating and configuring a map ID, by using `mapId: 'DEMO_MAP_ID'` in your app code.\n\nUpdate your map initialization code\n\nThis requires the map ID you just created. It can be found on your [Maps\nManagement](https://console.cloud.google.com/google/maps-apis/studio/maps) page.\n\n1. [Load the Maps JavaScript API](/maps/documentation/javascript/load-maps-js-api).\n\n2. Load the advanced markers library from within an `async`\n function when needed:\n\n ```javascript\n const { AdvancedMarkerElement } = await google.maps.importLibrary(\"marker\") as google.maps.MarkerLibrary;\n ```\n3. Provide a map ID when you instantiate the map using the `mapId` property.\n This can be a map ID that you provide, or `DEMO_MAP_ID`.\n\n ```javascript\n const map = new\n google.maps.Map(document.getElementById('map'), {\n center: {lat: -34.397, lng: 150.644},\n zoom: 8,\n mapId: 'YOUR_MAP_ID'\n });\n ```\n\n| **Caution:** The example maps for advanced markers use map IDs that are linked to a reduced-POI map style. If you re-use example code, we recommend replacing these map IDs with `DEMO_MAP_ID`, or with your own map ID.\n\nCheck map capabilities (optional)\n\nAdvanced markers requires a map ID. If the map ID is missing,\nadvanced markers cannot load. As a troubleshooting step,\nyou can add a `mapcapabilities_changed` listener to subscribe to map capability\nchanges. Using Map Capabilities is optional, and recommended only for testing\nand troubleshooting purposes, or for runtime fallback purposes. \n\n```javascript\n// Optional: subscribe to map capability changes.\nmap.addListener('mapcapabilities_changed', () =\u003e {\n const mapCapabilities = map.getMapCapabilities();\n\n if (!mapCapabilities.isAdvancedMarkersAvailable) {\n // Advanced markers are *not* available, add a fallback.\n }\n});\n```\n\nNext steps\n\n[Create a default advanced marker](/maps/documentation/javascript/advanced-markers/add-marker)"]]
