开发 URI API 开发指南 嵌入地图 概述

概述 最后更新时间: 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" 为可选属性,延迟加载可提升宿主页面性能。
  • 不想手写代码时,可在高德地图PC端「分享 > 嵌入地图」面板中选择尺寸并一键复制代码。

效果展示

常见问题

嵌入地图支持在手机上显示吗? 可以。嵌入地图页面支持在手机浏览器中打开:链接中带 platform=pc 参数时,按 PC 嵌入页样式展示,不会跳转到移动版站点;不带该参数时,会跳转到高德地图移动版的对应页面。您可以通过自定义 iframe 尺寸或 CSS 让嵌入地图在手机、平板、PC 上自适应显示。

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

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

为什么鼠标滚轮不能直接缩放嵌入地图? 为避免在网页中滚动页面时误触地图缩放,嵌入地图采用与 Google 地图一致的交互:按住 Cmd(Mac)/ Ctrl(Windows)并滚动鼠标滚轮才能缩放;未按住时会在地图中央显示操作提示。

服务条款

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

返回顶部 示例中心 常见问题 智能客服 公众号 高德开放平台公众号二维码 开放平台 扫码关注官方公众号