直接启动到要素或路径

适用于 ArcGIS Indoors Maps 扩展模块。

您可以将 Indoor Viewer 配置为直接启动到要素或两个要素之间的路径(智能启动)。 可通过应用程序 URL 中的参数启用智能启动功能。

启动到要素

您可以将 Viewer 应用程序配置为直接启动到特定要素。 使用共享按钮会自动生成用于启动到要素的 URL,如下所示:

  1. Viewer 应用程序中选择一个要素。

    随即出现信息面板,其中包含有关所选要素的详细信息。

  2. 单击信息面板顶部的共享按钮 共享,然后单击复制到剪贴板

    URL 将被复制到剪贴板。

  3. 打开一个浏览器窗口,然后将该 URL 粘贴到该处。

    生成的 URL 将 Viewer 应用程序启动到指定要素。

URL 参数

使用共享按钮生成的 URL 使用标识要素位置的参数将应用程序启动到要素。 您可以使用这些参数来构建将 Viewer 应用程序启动到指定路径的 URL。

参数描述

itemUniqueIdField

SourceKey 图层中的属性,其中包含要素的唯一标识符。

注:

此参数仅包含在室内数据集中存在的要素中。 其他要使用(例如已放置的图钉)不包含唯一标识符。

itemSourceKey

Web 地图中包含要素的图层的名称,例如 Units。

itemUniqueId

要素的 itemUniqueIdField 字段值。

注:

对于室内数据集中不存在的要素(例如已放置的图钉),将随机生成此值。

x

点标识符的 x 坐标。

y

点标识符的 y 坐标。

l

点标识符的垂直顺序。 这是 ArcGIS Indoors 信息模型要素类中包含的基础 0 级排序值。

visibleLayers

此参数包含在共享 web 地图时打开的每个图层的业务图层标识符。

URL 使用这些参数来通过以下结构将 Viewer 应用程序启动到要素:

https://<yourserver.yourdomain.com>/portal/apps/indoors?appid=<appid>&itemUniqueIdField=<uniqueidfield>&itemSourceKey=<itemsourcekey>&itemUniqueId=<itemuniqueid>

注:

室内数据集中不存在的位置的 URL(例如已放置的图钉)不包含 itemUniqueField 参数。 itemSourceKey 值设置为独立,itemUniqueId 值随机生成。

启动到路径

您可以通过在 Viewer 应用程序的 URL 中定义路径的起点和终点,将该应用程序配置为直接启动到路径。 如果同时提供了起点和终点,则该应用程序会在方向面板中自动解析路径。 支持两个路径停靠点:路径起点和路径终点。

路径必须包含路径起点和路径终点。 您可以使用与通过共享按钮生成的 URL 类似的结构来配置这些要素。 为了区分 URL 中的路径起点和路径终点,字母 rs 和字母 re 将被分别置于每个路径起点参数名称和每个路径终点参数名称之前。

可以指定唯一的标识符、字段和 ID,或者 x、y 和 l 值来标识要素。

构建智能启动以路由 URL

您可以在 Viewer 中使用共享按钮来生成路径 URL 参数和值。

  1. Viewer 应用程序中选择一个要素。

    随即出现信息面板,其中包含所选要素的详细信息。

  2. 单击信息面板顶部的共享按钮 共享,然后单击复制到剪贴板以将 URL 复制到剪贴板。
  3. 将 URL 粘贴到文本编辑器(例如 Notepad++)中,并标识允许应用程序直接启动到要素的关键参数
  4. 对于路径的另一端重复步骤 1 到 3。
  5. 按照以下操作构造 URL 以将 Viewer 应用程序自动启动到路径:
    1. 将字母 rs 和字母 re 分别置于路径起点要素的参数名称和路径终点要素的 参数名称之前。
    2. 将紧跟着新前缀的字母大写。 例如,路径起点的参数 itemUniqueIdField 将变为 rsItemUniqueIdField,路径终点的相同参数变为 reItemUniqueIdField
    3. 使用以下基本结构来构建智能启动 URL:

      https://<yourserver.yourdomain.com>/portal/apps/indoors?appid=<appid>&rsItemUniqueIdField=<routestartitemuniqueidfield>&rsItemSourceKey=<routestartitemsourcekey>&rsItemUniqueId=<routestartitemuniqueid>&reItemUniqueIdField=<routeenditemuniqueidfield>&reItemSourceKey=<routeenditemsourcekey>&reItemUniqueId=<routeenditemuniqueid>

      注:

      对于室内数据集中不存在的位置(例如已放置的图钉),必须包含点标识符的 x、y 和 l 值。 在这种情况下,将 itemSourceKey 设置为 standalone,然后使用 URL 中在第 2 步中生成的唯一项目 ID 值。 itemUniqueIdField 值不是必需项。

示例 URL

以下示例代表可以与智能启动配合使用的各种 URL。

启动到要素 URL

  • 已共享的办公室位置:

    https://myserver.mydomain.com/portal/apps/indoors?appid=ca4618a41f074de8964eb3a04821eb9e&itemUniqueIdField=unit_id&itemSourceKey=Units&itemUniqueId=ESRI.RED.MAIN.O3w220

  • 已共享的已放置图钉位置:

    https://myserver.mydomain.com/portal/apps/indoors?appid=1a348887cb6c44ddb748cd0c65fce9db&x=-117.19555207109245&y=34.05733200897579&l=0&itemSourceKey=standalone&itemUniqueId=9fc8e6855b22471f801af991935f8d40

启动到路径 URL

  • 单元到已放置图钉:

    https://myserver.mydomain.com/portal/apps/indoors/?appid=ca4618a41f074de8964eb3a04821eb9e&rsItemUniqueIdField=UNIT_ID&rsItemSourceKey=Units&rsItemUniqueId=ESRI.RED.MAIN.M1mc365&reX=-117.19672775506533&reY=34.05792177746473&reL=0&reItemSourceKey=standalone&reItemUniqueId=d9a1d2eac66d47808b23a0695fb0c565#

  • 单元到单元:

    https://myserver.mydomain.com/portal/apps/indoors/?appid=ca4618a41f074de8964eb3a04821eb9e&rsItemUniqueIdField=UNIT_ID&rsItemSourceKey=Units&rsItemUniqueId=ESRI.RED.MAIN.O3w220&reItemUniqueIdField=unit_id&reItemSourceKey=Units&reItemUniqueId=ESRI.RED.MAIN.L2e505#