Google Maps Platform 即将推出全新地图样式。此次地图样式更新包括全新默认调色板,以及地图体验和易用性方面的改进。所有地图样式将于 2025 年 3 月自动更新。如需详细了解适用范围以及如何提前选择启用,请参阅
全新 Google Maps Platform 地图样式 。
发送反馈
开始使用
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
请按照以下步骤设置高级标记。
获取 API 密钥并启用 Maps JavaScript API
在使用高级标记之前,您需要一个拥有结算账号并启用了 Maps JavaScript API 的 Cloud 项目。如需了解详情,请参阅设置您的 Google Cloud 项目 一文。
获取 API 密钥
创建地图 ID
如要创建新的地图 ID ,请按照云端地图样式设置 一文中的步骤操作。将地图类型设置为 JavaScript ,然后选择矢量 或光栅 选项。
重要提示: 测试时,您可以在应用代码中使用 mapId: 'DEMO_MAP_ID'
。这样可以跳过创建和配置地图 ID 的步骤。
更新地图初始化代码
此步骤需要用到您刚刚创建的地图 ID。您可以在地图管理 页面上找到该 ID。
加载 Maps JavaScript API 。
根据需要在 async
函数中加载高级标记库:
const { AdvancedMarkerElement } = await google . maps . importLibrary ( "marker" ) as google . maps . MarkerLibrary ;
在实例化地图时,通过使用 mapId
属性来提供地图 ID。此地图 ID 可以是您提供的地图 ID,也可以是 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'
});
注意: 高级标记的示例地图使用的地图 ID 与缩减版地图注点地图样式相关联。如果您重复使用示例代码,建议您将这些地图 ID 替换为 DEMO_MAP_ID
或您自己的地图 ID。
检查地图功能(可选)
高级标记需要地图 ID。如果缺少地图 ID,则无法加载高级标记。为便于排查问题,您可以添加一个 mapcapabilities_changed
监听器来订阅地图功能更改。使用地图功能是可选操作,建议仅将其用于测试、问题排查或运行时回退。
// 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.
}
});
后续步骤
创建默认的高级标记
发送反馈
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-20。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
需要向我们提供更多信息?
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-20\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-20。"]]