返回顶部

使用 URL 参数

在本主题中

  1. 参数结构
  2. 常规参数
  3. 使用共享生成参数
  4. 创建自定义 URL 参数

在 ArcGIS Instant Apps 中，可在共享时将 URL 参数添加至应用程序的 URL 并配置自定义参数。 可以使用 URL 参数在打开应用程序链接时包含指令。 例如，可以将应用程序缩放至特定位置或比例级别，缩放至具有弹出窗口的要素等。

参数结构

参数会添加至 URL 的末尾并格式化为以等号 (=) 连接的键值对。 要追加参数，必须使用与号 (&) 将其连接到 URL。

包含参数的 Instant Apps URL 使用以下结构：

https://<domain>/apps/instant/<Template>/index.html?<AppID>&<param1=value>&<param2=value>&<param3=value>&...
注：

小于和大于符号 (<>) 在本主题中用作括号。 请勿将这些符号添加至 URL。

<Template> 是应用程序的 Instant Apps 模板。

<AppID> 是 Web 应用程序的唯一 ID。Instant Apps 模板（例如下面使用的 Basic 模板）将应用程序的 ID 以 URL 参数形式打开：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146

要追加多个参数，使用与号 (&) 分隔这些参数：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=en&center=-157.7118,20.7413&level=7

在本例中， locale、center 和 level 参数均已追加。

常规参数

下面的子部分介绍可能在应用程序中提供的参数。

注：

并非所有 Instant Apps 模板都支持以下参数。 一定要测试应用程序，确保参数受支持。

指定位置

定义在打开 URL 时应用程序将用作中心的位置。 使用 center=<x>,<y> 设置具有地理坐标 (x,y) 的中心。

以下为示例：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&center=-157.7118,20.7413

应用程序将打开并显示坐标 (-157.7118, 20.7413)。

指定比例级别

使用 level 参数定义特定比例级别。 追加 level=<zoom level value>。

以下为示例：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&level=2

应用程序将打开并显示低于应用程序默认设置的缩放级别。

指定范围

使用两个地理坐标 (x,y) 定义地图范围。 使用 extent=<MinX>,<MinY>,<MaxX>,<MaxY>。 第一组坐标 (MinX,MinY) 必须定义所需地图范围的西南角。 第二组坐标 (MaxX,MaxY) 必须定义所需地图范围的东北角。

以下为示例：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&extent=-73.28,42.08,-68.46,42.04

应用程序将打开并显示所需的地图范围。

查找要素位置

在打开应用程序时使用 find 参数查找位置或要素。 地图将缩放到最近的匹配项并将显示一个注释标记。 使用 find=<search string>。

以下为示例：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&find=michigan

地图将缩放至美国密歇根州作为返回的最佳搜索结果。

添加带弹出窗口的标记

在打开 URL 时，使用 marker 参数在具有自定义弹出窗口的标记上缩放。 该参数使用以下属性。 要跳过属性，使用双逗号 (,,)。

注：

必须对整个参数进行编码。 URL 编码使用百分号 (%) 后跟其十六进制等效项 (hex) 来替换字符。 有关详细信息，以及要对字符串进行编码，请参阅 URLEncoder.io。

必须按以下顺序设置标记属性结构：

marker=<x>,<y>,<WKID>,<title>,<symbol URL>,<label>
  • <x>,<y> - 标记的地理坐标。
  • <WKID> - 添加到地图的坐标的空间参考。 如果不包含 WKID，则使用 GCS 坐标。
  • <title> - 弹出窗口标题。 如果不包含标题，则该弹出窗口将为空。
  • <symbol URL> - 点的符号。 如果不包含符号，则将使用黑色圆形标记符号。
  • <label> - 要包含在弹出窗口说明中的文本。

参数将缩放到标记。 单击标记打开弹出窗口。

以下为示例：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&marker=-166.50,24.77,,Papah%C4%81naumoku%C4%81kea%20Marine%20National%20Monument,,One%20of%20the%20world%27s%20largest%20protected%20areas.%20This%20monument%20is%20home%20to%20native%20cultural%20significance%20and%20protects%20critical%20endemic%20species.

URL 将在指定坐标处创建标记和弹出窗口。 弹出窗口的标题为 Papahānaumokuākea Marine National Monument 文本。

切换应用程序语言

将 URL 配置为打开应用程序并显示特定语言。 使用 locale 参数和双字母 ISO 639-1 语言代码。 Instant Apps 支持 ArcGIS Online 支持的所有相同语言。 追加 locale=<language code>。

以下为示例：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=vi

现在，应用程序的用户界面在打开时设置为越南语。

使用共享生成参数

可以使用“共享”功能通过生成的参数创建应用程序的 URL。 所生成的 URL 可以保留当前地图视图并打开弹出窗口。

注：

某些模板不支持“共享”工具。 有关如何重启 IBM Cognos 服务的详细信息，应用程序工具矩阵 (PDF)查看哪些模板支持“共享”。

可以使用“共享”功能自动生成以下参数：

  • locale=<language code>
  • center=<x>,<y>
  • level=<LOD>
  • selectedFeature=<feature>

selectedFeature 参数将打开要素的弹出窗口。

要使用“共享”功能通过生成的参数创建 URL，请完成以下步骤：

  1. 在侧面板中，禁用精简模式，当显示确认提示时，单击继续。
  2. 在侧面板中，单击交互性打开窗格。
  3. 单击共享打开共享菜单。
  4. 启用共享选项。 这将在应用程序中启用共享工具。
  5. 在 Web 地图中，配置要让 URL 打开并显示的地图视图。

    此外，还可以选择要素，前提是您希望 URL 打开并显示选定要素及其弹出窗口。

  6. 单击共享工具。
  7. 单击复制链接将应用程序的 URL 复制到剪贴板。

    此 URL 将包括追加的参数，用于打开应用程序并显示视图和选定要素弹出窗口（如果配置）。 此外，还会使用对此 URL 进行编码。

创建自定义 URL 参数

可以在 Instant Apps 应用程序中创建自定义 URL 参数，以在打开应用程序中缩放至要素并显示弹出窗口。 可以将自定义 URL 参数与其他 URL 参数相结合，3D Viewer、Basic、Interactive Legend、Reporter 和 Sidebar 中均支持这些参数。 Basic 和 Sidebar 还支持应用于多个图层的自定义 URL 参数。

要创建自定义 URL 参数，请完成以下步骤：

  1. 在侧面板中，禁用精简模式，当显示确认提示时，单击继续。
  2. 单击搜索设置，然后搜索 URL 参数名称。

    随即显示 URL 参数设置。

  3. 在 URL 参数名称部分中，输入自定义参数的名称。

    这将是要追加到应用程序 URL 的自定义参数。

  4. 在 URL 参数搜索图层中，选择应用程序中希望自定义参数搜索的要素图层。
  5. 在所选的要素图层旁，单击字段打开字段下拉菜单。

    选择搜索图层中希望自定义参数搜索的字段。

  6. 单击完成。
  7. 单击发布部署自定义参数配置。

您的自定义 URL 参数即已配置。 可以使用 <assigned name>=<field value> 结构将具有要素标识值的自定义参数追加到应用程序 URL。 这将在打开应用程序时缩放并显示指定要素的弹出窗口。

例如，如果自定义参数名为 "site" 并且应当搜索地点名称，则将 site=<site name> 追加到 Web 应用程序 URL 的末尾，让应用程序缩放到该指定要素。 在此 NOAA 海洋保护区示例应用程序中，以下参数将缩放至蒙特利湾国家海洋保护区地点并打开要素弹出窗口：site=Monterey Bay National Marine Sanctuary。

以下 URL 对此进行了演示：

https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&site=Monterey%20Bay%20National%20Marine%20Sanctuary

有关此主题的反馈?

在本主题中
  1. 参数结构
  2. 常规参数
  3. 使用共享生成参数
  4. 创建自定义 URL 参数