在你的网站上嵌入地图 · Measure Map Online 帮助

在你自己网站的页面中显示项目的地图，选择它的外观，限制允许显示它的网站，并了解地图中每条消息的含义。

嵌入地图会把项目放进你自己网站的页面中：包括它的形状、它们的测量结果，以及（如果已计价）它的报价。访客直接在那里查看，无需账户，如果想要更大的空间，也可以在 Measure Map Online 中打开它。

哪些项目可以嵌入#

你的嵌入可以显示你自己的项目，也可以显示其他账户（例如你客户）的项目，这取决于它们的访问级别：

只有在所有者的套餐有效期间（对于组织的项目，则是组织的套餐有效期间），项目才会显示。回收站中的项目和模板不会显示。当项目无法显示时，地图会说明原因：参见地图显示消息时。

在仪表盘中，点击开发者，然后点击嵌入地图。嵌入始终使用你的正式密钥：用沙盒密钥创建的项目，你网站的访客无法打开（参见正式与沙盒）。
在 获取你的 API 密钥 下，如果页面上还没有密钥，请点击生成新密钥，并在打开的对话框中创建一个。参见创建密钥。
在 设置项目 ID 下，在 选择项目 中输入项目名称的一部分，并从列表中选择它。列表会说明每个项目的分享方式，并且不包含模板和回收站中的项目。如果你选择的是私有项目，页面会警告你的访客将看到提示它是私有的消息，并提供设为仅查看。
在 嵌入代码 下，选择地图的外观：
- 主题：自动跟随每位访客自己的浅色或深色设置；或始终使用浅色或深色。
- 单位：自动（访客所在国家/地区） 对美国的访客显示英制单位，对其他所有人显示公制；或始终使用英制或公制。
- 地图类型：卫星、地图、混合或地形。
- 地图在你页面上的宽度和高度，以像素为单位（200 到 2000）。
检查 实时预览。
点击 嵌入代码 旁边的，把代码粘贴到你页面 HTML 中地图应该出现的位置。

要嵌入别人的项目（例如客户的项目），你需要它的项目 ID。其所有者可以在项目概览的末尾找到它，旁边有复制按钮；在嵌入地图中，点击项目名称即可复制它。把它填入嵌入地址的 pid。

代码中包含你的 API 密钥，因此在你更换密钥之前，地图会在该密钥所允许的网站上持续工作。更换之后，旧密钥仍会被接受 24 小时，所以请在这段时间内把新代码粘贴到你的页面中。在密钥有访问设置之前创建的密钥，则保留给你的原有日期。只有此页面上的 实时预览 使用短期令牌。

要让密钥完全不出现在你的页面中，可以让你网站的服务器在每次显示页面时请求一个令牌。参见密钥还是令牌，其中还列出了嵌入地址接受的所有设置。

默认情况下，嵌入可以在任何网站上使用。要阻止其他网站显示你的地图，请点击开发者 > API 密钥，并在 网站限制 下添加你自己的网站，例如 example.com。列表中的网站也涵盖其子域名。列表中至少有一个网站之后，嵌入在其他任何地方的地图都无法打开。参见将密钥限制在你的网站上。

在嵌入地图中，访客可以：

在 Open Guest 项目中，他们还可以绘制和测量，并点击 申请报价 向你发送他们的信息。

其他所有嵌入地图中的编辑功能都是关闭的，即使对项目成员也是如此。要用你自己的代码构建嵌入，或在其中使用短期令牌而不是你的密钥，请参见 iFrame API。

当项目无法显示时，地图会在原位说明原因，以及可以怎么做。

地图显示	原因	怎么做
此项目为私有	项目为私有，且其所有者没有授权你。	其所有者点击地图中带有你名称的授权并在其账户中确认，或点击打开项目并将其分享为仅查看或公开。参见你的项目显示在其他公司的地图中。对于你自己的私有项目，只提供第二种方式。
此项目暂时不可用	拥有该项目的账户的套餐已结束；对于组织的项目，则是组织的套餐已结束。	套餐一续订，它就会重新显示。在此之前只有其所有者能打开它。
此项目不可用	项目已被删除或在回收站中，或者代码中的项目 ID 有误。	检查代码中的 `pid`。
此地图无法在此网站上显示	页面所在的网站不在你密钥的网站限制列表中。	在网站限制下添加该网站。
此地图的密钥无效	代码中的密钥已过期、已被替换或已被撤销。	把新的嵌入代码复制到你的页面中。
此地图暂时不可用	该密钥所属的账户目前无法显示地图：其套餐已结束，或其 API 访问被暂停。	检查你的套餐，以及 API 密钥中的徽标。
无法打开地图	地图无法连接到 Measure Map Online。	访客检查网络连接并点击重试。
此项目无法在此处显示	项目无法显示，且地图无法判断原因。	检查项目是否存在以及它的分享方式。

各情况的技术细节，请参见地图不显示时。