嵌入地图

高德地图 PC 端支持将地图内容以 iframe 形式嵌入到第三方网页。您无需编写代码,只需在页面上点击「分享」并切换到「嵌入地图」Tab,即可复制一段 HTML 代码,把地点、路线、公交/地铁线路、搜索结果或当前地图视野展示在您的网页中。

提示:嵌入地图为高德地图 PC 新版功能,旧版暂不支持。如果您当前使用的是旧版,请先点击页面右上角工具栏的「体验新版」切换到新版,再使用嵌入地图。

功能入口在哪里

高德地图 PC 端提供以下三种分享入口,均可生成嵌入地图。打开分享弹窗后,切换到「嵌入地图」Tab 即可获取嵌入代码。

入口一:页面内分享按钮

  • POI 详情页:查看某个地点(如公司地址:北京市朝阳区望京东园四区4号楼)的详细信息时,点击底部操作栏的「分享」按钮,可生成该地点的嵌入地图。
  • 路线规划页:输入起点和终点,获得驾车、公交、步行或骑行路线后,点击路线结果面板的「分享」按钮,可生成路线地图。

入口二:地图右键菜单

在地图任意位置右键,菜单末尾会出现「分享」项,文案会根据当前页面上下文动态变化:

  • 路线规划页 →「分享路线」
  • 公交/地铁线路 →「分享公交/地铁线路」
  • 周边搜索页 →「分享周边」
  • 关键字搜索页 →「分享搜索结果」
  • POI 详情页 →「分享地点」
  • 无任何上下文(纯地图)→「分享当前位置」:以右键点击的位置为对象,自动识别该位置的名称与地址,生成地点模式的嵌入地图。

入口三:右上角工具栏

点击页面右上角工具栏的「分享」按钮,同样按当前上下文分发:

  • 有地点、路线、公交/地铁线路或搜索结果上下文时,打开对应内容的分享弹窗;
  • 无任何上下文时,直接打开「嵌入地图」弹窗,生成当前地图中心点与缩放级别的纯地图视野。

有哪些嵌入场景

根据您当前所在页面,嵌入地图会自动生成以下五种场景之一:

地点模式

在地图上标注单个 POI 位置,并展示名称、地址等基本信息。适合在文章里介绍某个具体地点。

路线模式

展示驾车、公交、步行或骑行路线,帮助读者直观了解从 A 地到 B 地的走法。支持普通两点路线以及驾车途经点路线。

公交/地铁线路模式

展示完整的公交线路或地铁线路,包括沿途所有站点和线路走向。点击站点可查看该站点的真实地址与分类信息,适合在交通指南、出行攻略等内容中嵌入。

搜索模式

包含关键字搜索与周边搜索两种子场景:关键字搜索在指定城市/视野内展示「加油站」「便利店」等关键词的结果 marker 分布;周边搜索以选定的 POI 为中心,按指定半径(如 1km)画圆,展示范围内的结果 marker、中心点和半径指示线。

视野模式

只展示指定中心点和缩放级别的地图视野,无额外 POI 或路线标注,适合作为文章配图或区域概览。

嵌入页里有什么

嵌入到您网页中的地图是一个独立、可交互的地图页面,访客可以:

  • 拖动地图、切换标准图 / 卫星图底图;缩放地图时,需按住 Cmd(Mac)/ Ctrl(Windows)并滚动鼠标滚轮,未按住时会显示操作提示;
  • 点击地点模式中的信息卡,查看详情或规划路线;
  • 点击路线模式中的路线卡,在新窗口打开对应路线规划;
  • 点击公交/地铁线路模式中的站点标记,查看该站点的真实地址与分类信息,并可跳转地点详情或路线规划;
  • 点击搜索模式中的结果 marker,查看单个 POI 详情;
  • 周边搜索模式下会显示以中心点为圆心的搜索范围圈、半径指示线及距离标签,即使该范围内没有结果也会显示中心点和范围圈;
  • 在视野模式左上角点击「打开高德」,跳转至高德地图 PC 端;
  • 页面底部展示高德版权、审图号与服务条款链接。

如何使用嵌入代码

  1. 在高德地图 PC 端进入上述任一页面,点击「分享」按钮。
  2. 在弹出的分享弹窗中,默认展示「发送链接」Tab,点击切换到「嵌入地图」Tab。
  3. 在嵌入地图面板中选择尺寸:小(400×300)、中(600×450,默认)、大(800×600),也可以自定义宽高。
  4. 点击「复制 HTML」,将生成的 iframe 代码粘贴到支持 iframe 的网页编辑器中。
  5. 发布页面后,访客即可在您的网页中直接查看和操作嵌入的高德地图。

效果示例

下面是一个真实的地点模式嵌入示例,展示的是高德地图总部位置:

常见问题

嵌入地图支持在手机上显示吗?

可以。嵌入地图页面支持在手机浏览器中打开,且不会跳转到移动版站点。您可以通过自定义 iframe 尺寸或设置 CSS 让嵌入地图在手机、平板、PC 上自适应显示。

我可以调整嵌入地图的大小吗?

可以。在生成嵌入代码时,您可以选择系统预设的几种尺寸(如 400×300、600×450、800×600),也可以自定义宽高。将代码粘贴到网页后,还可以通过 CSS 或修改 iframe 的 width / height 属性实现手机、平板、PC 的自适应显示。

为什么我的网页中无法显示嵌入地图?

请确认您的网页使用 HTTPS(部分浏览器限制非安全页面嵌入内容),并且没有被内容安全策略(CSP)阻止外部 iframe 加载。如果仍有问题,请检查复制的嵌入代码是否完整。

嵌入地图支持显示实时路况吗?

当前嵌入地图暂不支持显示实时路况,主要展示地点、路线、公交/地铁线路、搜索结果或指定地图视野。

为什么鼠标滚轮不能直接缩放嵌入地图?

为避免在网页中滚动页面时误触地图缩放,嵌入地图采用与 Google 地图一致的交互:按住 Cmd(Mac)/ Ctrl(Windows)并滚动鼠标滚轮才能缩放;未按住时会在地图中央显示操作提示,告诉您需要按住修饰键。

服务条款

使用嵌入地图功能前,请仔细阅读《高德地图嵌入服务条款》。嵌入地图仅供合法、非恶意的展示用途,不得用于误导用户、侵犯他人权益或违反法律法规的场景。

最后更新:2026-07-30