概述 最后更新时间: 2026年11月04日
嵌入地图通过 iframe 将高德地图的单个地点、路线、公交/地铁线路、搜索结果或指定地图视野嵌入到第三方网页中。嵌入页是一个独立的、可交互的地图页面,访客可以在其中拖动、缩放地图并查看详情,无需申请 Key,也无需引入 JSAPI 脚本。
嵌入页交互能力
嵌入到网页中的地图是一个独立、可交互的地图页面,访客可以:
- 拖动地图、切换标准图 / 卫星图底图;缩放需按住 Cmd(Mac)/ Ctrl(Windows)滚动鼠标滚轮,未按住时地图中央会显示操作提示;
- 地点模式:点击左上角信息卡,查看详情或规划路线;
- 路线模式:点击左上角路线卡,在新窗口打开对应路线规划;
- 公交/地铁线路模式:点击站点标记,查看该站点地址与分类信息,并可跳转地点详情或路线规划;
- 搜索模式:点击结果 marker 查看单个 POI 详情;周边搜索展示范围圈与半径标签;
- 视野模式:左上角提供「打开高德」,跳转至高德地图 PC 端;
适用终端
移动端和PC端。嵌入页以 iframe 形式加载:
- 链接中带 platform=pc 参数时:在手机浏览器中打开也按 PC 嵌入页样式展示,不会跳转到移动版站点,适合 iframe 嵌入场景;
- 链接中不带 platform=pc 参数时:在手机浏览器中直接打开,会跳转到高德地图移动版(m.amap.com)的对应页面(地点、路线、搜索结果、公交线路分别跳转到移动端原生页面;纯视野模式无移动端对应页面,保持原样展示)。
如何使用嵌入代码
在网页任意位置粘贴以下形式的 iframe 代码即可:
<iframe
src="http://www.amap.com/ssr/embed/place?id=B0K3C7EM0G&name=高德地图总部&lng=116.489729&lat=40.002539&zoom=16&platform=pc"
width="600"
height="450"
style="border:0"
loading="lazy"
allowfullscreen
referrerpolicy="strict-origin-when-cross-origin"
></iframe>
- width / height 可自定义,粘贴后亦可通过 CSS 实现手机、平板、PC 自适应。
- loading="lazy" 为可选属性,延迟加载可提升宿主页面性能。
效果展示
常见问题
嵌入地图支持在手机上显示吗? 可以。嵌入地图页面支持在手机浏览器中打开:链接中带 platform=pc 参数时,按 PC 嵌入页样式展示,不会跳转到移动版站点;不带该参数时,会跳转到高德地图移动版的对应页面。您可以通过自定义 iframe 尺寸或 CSS 让嵌入地图在手机、平板、PC 上自适应显示。
为什么我的网页中无法显示嵌入地图? 请确认您的网页使用 HTTPS(部分浏览器限制非安全页面嵌入内容),并且没有被内容安全策略(CSP)阻止外部 iframe 加载。如果仍有问题,请检查复制的嵌入代码是否完整。
嵌入地图支持显示实时路况吗? 当前嵌入地图暂不支持显示实时路况,主要展示地点、路线、公交/地铁线路、搜索结果或指定地图视野。
为什么鼠标滚轮不能直接缩放嵌入地图? 为避免在网页中滚动页面时误触地图缩放,嵌入地图采用与 Google 地图一致的交互:按住 Cmd(Mac)/ Ctrl(Windows)并滚动鼠标滚轮才能缩放;未按住时会在地图中央显示操作提示。
服务条款
使用嵌入地图功能前,请仔细阅读《高德地图嵌入服务条款》。嵌入地图仅供合法、非恶意的展示用途,不得用于误导用户、侵犯他人权益或违反法律法规的场景。
开放平台