部署地图

准备好用于外业的地图后,请向移动工作人员部署该地图。 请与移动工作人员共享该地图,使其可以在 ArcGIS Field Maps 中浏览该地图或点击您发送的自定义链接。 当移动工作人员需要离线工作时,他们可以下载您准备好的地图,或者可以将 MMPK 直接复制到其设备中。 通过为组织的数据采集工程自定义外业指南,或提供共享移动工作人员位置的说明,为移动工作人员提供有关使用该应用程序的帮助。 也可以使用移动设备管理 (MDM) 软件来部署和配置移动应用程序。

共享您的地图以在 Field Maps 中使用

可通过 Field Maps 访问由移动工作人员所有或与移动工作人员所属的 ArcGIS 组织或群组共享的地图。 可以选择创建群组,这样有助于您管理有权访问您的地图和数据的移动工作人员。 要使移动工作人员能够访问您的共享地图,他们必须为 ArcGIS 组织的成员。 如果您的共享地图启用了编辑功能,则这些移动工作人员还需要有权编辑要素。

  1. 如果移动工作人员还不是 ArcGIS 组织(ArcGIS OnlineArcGIS Enterprise 中)的成员,则您需要为他们创建账户。
  2. 与 ArcGIS 组织共享地图和图层或创建群组来管理对地图和数据的访问权限。

从链接打开地图

移动工作人员可在 Field Maps 中浏览您的地图,您也可以直接向其提供 URL。 可以通过电子邮件、短信、web 页面或另一个应用程序直接向移动工作人员共享地图链接,使其轻松打开正确的地图并开始工作。使用 Field Maps 的链接,点击此链接时,会将 Field Maps 打开到您希望移动工作人员使用的地图。 如果地图启用了编辑功能,移动工作人员可以在地图打开时开始捕获数据。 如果移动工作人员正在离线工作,链接仍然有效。

Field Maps 链接

Field Maps 链接具有以下格式:https://fieldmaps.arcgis.app?parameter=value&parameter=value,其中参数和值对将替换为您要用于打开地图的值。 例如,https://fieldmaps.arcgis.app?referenceContext=center&itemID=3ac4145c1ac44aea86e9ed42e00fbb0d&center=34.0547155,-117.1961714 将使用 itemID 参数和 3ac4145c1ac44aea86e9ed42e00fbb0d 值打开具有此 ID 的地图。 referenceContext 参数及其 center 值指定应在应用程序中执行的操作的类型 - 在本例中,地图将居中。 center 参数和 34.0547155,-117.1961714 值提供使地图居中的坐标。

参数

Field Maps 链接支持以下参数。 如果未传递任何参数,则点击该链接即可打开 Field Maps(或系统将提示您打开应用程序)。

参数备注

anonymousAccess

调用公开共享并且无需登录即可访问的地图或 MMPK 时使用,或者在登录允许匿名访问的 Field Maps 门户时使用

  • 调用公开共享地图时需要 itemID
  • 值为布尔型、truefalse
  • 默认为 false

bookmark

在地图中指定书签

  • 需要 itemIDreferenceContext=center
  • 通过在地图中指定书签,将地图打开至特定视点。 将空格编码为 +
  • 链接不能包含除 itemIDbookmark 之外的任何参数。

callback

捕获资产或观测点完成后将调用的 URL

  • 需要 itemIDreferenceContext=addFeaturereferenceContext=updateFeaturereferenceContext=shareLocationfeatureSourceURL
  • 或者,在调用 URL 之前,为用户提供一个使用 callbackprompt 参数指定的提示。
  • 如果在回调 URL 中传递参数,则每个参数的值必须进行 URL 编码,然后必须对整个回调 URL 进行编码(包括再次对值进行编码)。

callbackPrompt

在运行回调之前提示移动工作人员,并在提示中将此值显示为移动工作人员将被带到的位置。

  • 需要 itemIDreferenceContext=addFeaturereferenceContext=updateFeaturereferenceContext=shareLocationcallback
  • 值必须经过 URL 编码(空格可以编码为 +%20)。

center

一组用于将地图居中的纬度和经度 (y, x) 坐标

  • 需要 itemIDreferenceContext=center
  • 必须在 WGS84 (WKID: 4326) 中以逗号分隔的纬度/经度 (y, x) 对的形式提供中心。

featureAttributes

新捕获要素的表单条目的 JSON 字典

  • 需要 itemIDreferenceContext=addFeaturereferenceContext=updateFeaturefeatureSourceURL
  • 指定条目会覆盖一切现有值。
  • 如果某一条目未存在于可编辑表单中,或者提供的值类型不正确,则系统将忽略该条目。
  • 日期应以数值表示(自新纪元时间以来的毫秒数)。
  • 具有关联编码值属性域的条目将使用属性域代码(而不是属性域描述)。
  • 将条目传递到 Field Maps 之前,必须对其进行 URL 编码。

featureID

唯一标识图层内要更新的要素。 必须是 GlobalID 字段。

  • 需要 referenceContext=updateFeature
  • 包含要素的图层必须支持要素更新。

featureSourceURL

采用实例化捕获的图层的 URL

  • 需要 itemIDreferenceContext=addFeaturereferenceContext=updateFeature
  • 可选择使用 featureAttributes 参数提供表单的条目。

foreignKeyField

在子表中用于定义关系并从父要素接收键的字段

  • 需要 referenceContext=addRelatedFeatureitemIDfeatureSourceURLfeatureID

geometry

定义新捕获要素的位置

  • 需要 itemIDreferenceContext=addFeaturereferenceContext=updateFeaturefeatureSourceURL
  • 值是包含 x、y 和 z 的坐标,或几何(点、线或面)的 JSON 表达
  • JSON 值必须经过 URL 编码。

itemID

要打开的地图的 itemID

  • 需要 referenceContext
  • 项目 ID 位于地图项目页面的 URL 中。 例如,如果您地图的项目页面 URL 为 https://www.arcgis.com/home/item.html?id=0c900ae2a1084d27b608233921ef1a84,则地图的项目 ID 为 0c900ae2a1084d27b608233921ef1a84
  • 支持的地图类型包括 Web 地图、MMPK 和离线区域。

locationSharingDuration

指定位置共享的持续时间(以小时为单位)

  • 需要 referenceContext=shareLocationlocationSharingON=true
  • 单位为小时,并且支持小数。

locationSharingON

指定是打开还是关闭位置共享

  • 需要 referenceContext=shareLocation
  • 值为布尔型、truefalse

locationSharingShareLKLOnly

指定位置共享历史记录的存储方式

  • 需要 referenceContext=shareLocationlocationSharingON=true
  • 值为布尔型、truefalse
  • 如果 locationSharingLKLOnlytrue,则不存储位置共享追踪点历史记录。

locationSharingUploadLKLFrequency

指定最近已知位置上传频率

  • 需要 referenceContext=shareLocationlocationSharingON=true
  • 覆盖默认设置 60 秒。
  • 单位为秒,且值必须大于 5。 没有最大限制。
  • 在用户注销前,此设置将在会话之间持续存在。
  • 值类型为整型。

portalURL

您组织的门户 URL

  • 如果已指定 URL 且移动工作人员已登出或连接到其他门户(其中包括 ArcGIS Online),则系统将提示其登出,然后直接进入您组织的登录页面并提示其登录。
  • 提供您在访问门户时在浏览器中输入的 URL,例如,https://myportal.mycompany.com/arcgis

referenceContext

打开应用程序且用户已登录后,应用程序应处理哪些事项(如果有)

支持以下值:

  • addFeature
  • addRelatedFeature
  • center
  • open
  • search
  • shareLocation
  • updateFeature
注:

如果想要在单个 URL 中使用多个 ReferenceContext 值(例如 opensearch),则请仅指定一个值(主要使用 ReferenceContext 参数)。 例如,指定 search 意味着地图为 open。 请参阅下面的 Field Maps 链接示例

scale

应对地图进行渲染的比例(以地图单位为单位)

  • 需要 itemIDcenter

search

要搜索的地址、地点、坐标或要素

  • 需要 itemID
  • 将空格编码为 +
  • 要素将使用在地图中搜索该要素时所使用的相同术语来确定。

useAntennaHeight

指定是否从位置每个折点的 z 值中减去当前接收器的天线高度

  • 需要 itemIDreferenceContext=addFeaturegeometryfeatureSourceURL
  • 值为布尔型、truefalse
  • 默认为 false
注:

Android 即将提供此项支持。

useLocationProfile

指定是否使用当前位置配置文件来转换位置

  • 需要 itemIDreferenceContext=addFeaturegeometryfeatureSourceURL
  • 值为布尔型、truefalse
  • 默认为 false
注:

Android 即将提供此项支持。

wkid

在其他空间参考中指定中心坐标

  • 需要 itemIDcenterscale
  • 如果未指定参数,则默认为 WKID: 4326 (WGS84)。

继续阅读有关使用这些参数以通过 Field Maps 链接实现特定行为的示例。

打开地图

使用下列参数打开地图:

  • referenceContext=open
  • itemID
  • portalURL(可选)

支持的地图类型包括 Web 地图、MMPK 和离线区域。

以下为示例:

在不登录的情况下访问公共地图

使用下列参数访问公共地图:

  • referenceContext=open
  • itemID
  • anonymousAccess=true
  • portalURL(可选)

以下为示例:

  • https://fieldmaps.arcgis.app/?referenceContext=open&itemID=5dce807aeb5c4b33bce767d278df9c3d&anonymousAccess=true

登录允许匿名访问的门户

使用以下参数访问允许匿名访问的门户:

  • anonymousAccess=true
  • portalURL

以下为示例:

  • https://fieldmaps.arcgis.app/?portalURL=https://myportal.mycompany.com/gis&anonymousAccess=true

居中并缩放地图

使用以下参数指定特定地图的中心和比例,而非使用打开地图时的默认地图中心和比例设置:

  • referenceContext=center
  • itemID
  • center
  • scale(可选)
  • wkid(可选)
  • bookmark(可选)

默认坐标系为 WGS84,但是可以使用 wkid 参数对其进行更改。

以下为示例:

在地图中搜索

使用以下参数打开地图并搜索地址、地点、坐标或要素(资产或观测点):

  • referenceContext=search
  • itemID
  • search

以下为示例:

查看书签

使用以下参数在地图上查看由书签指定的位置:

  • referenceContext=center
  • itemID
  • bookmark

以下示例链接可将地图打开至名为 Centennial Park 的书签:

https://fieldmaps.arcgis.app/?referenceContext=center&itemID=0c900ae2a1084d27b608233921ef1a84&bookmark=Centennial+Park

开始捕获要素

打开地图并使用以下参数开始捕获要素。 可选择提供应用于新资产或观测点的表单条目。

  • itemID
  • referenceContext=addFeature
  • featureSourceURL
  • geometry(可选)- 如果提供,则定义要素的形状。 如果未提供,移动工作人员的 GPS 位置将被用作线或面的点或第一个折点。
  • useAntennaHeight(可选)
  • useLocationProfile(可选)
  • featureAttributes(可选)
  • callback(可选)
  • callbackPrompt(可选)
注:

Android 即将支持链接中的 useAntennaHeightuseLocationProfile

以下为示例:

开始更新要素

打开地图并使用以下参数开始更新现有要素。 可选择提供要应用于已更新资产或观测点的表单条目。

  • itemID
  • referenceContext=updateFeature
  • featureSourceURL
  • featureID
  • featureAttributes(可选)
  • geometry(可选)
  • callback(可选)
  • callbackPrompt(可选)
注:

这不适用于表行。

以下为示例:

添加相关要素

打开地图并使用以下参数添加新的相关要素:

  • itemID
  • referenceContext=addRelatedFeature
  • featureSourceURL
  • featureID
  • foreignKeyField

可以使用以下示例链接打开地图并根据与新要素关联的外键字段名称添加相关要素:

https://fieldmaps.arcgis.app/?referenceContext=addRelatedFeature&itemID=0c900ae2a1084d27b608233921ef1a84& featureSourceURL=https://services9.arcgis.com/QjGvjfQhsHAmqfjP/arcgis/rest/ services/DamageAssessment_Apr2018_631d0895e7d3404bb78e8e04e92d896e/FeatureServer/ 1&featureID=bb0a0c92-9f53-4367-a6a1-bc6edc605be0&foreignKeyField=FacilityID

启动位置共享

使用以下参数启用位置共享并设置持续时间:

  • referenceContext=shareLocation
  • locationSharingON=true
  • locationSharingDuration

以下示例链接可启用位置共享 120 小时:

https://fieldmaps.arcgis.app/?referenceContext=shareLocation&locationSharingOn=true&locationSharingDuration=120​

注:

您也可以使用链接来关闭位置共享,例如:

https://fieldmaps.arcgis.app/?referenceContext=shareLocation&locationSharingOn=false

提供采集数据的指南

尽管本文档提供了有关使用 Field Maps 的信息,但在外业采集数据的移动工作人员通常需要更轻量的资料,这些资料可以打印并随身携带(尤其在离线工作时)。 可为移动工作人员提供基础的单页外业指南,帮助其完成常见任务并解决一些问题,从而使您能够更方便地为移动工作人员提供支持。 提供了一个侧重于常见数据采集任务和专为移动工作人员编写的外业指南模板。 使用该模板开始自行为移动工作人员创建参考。

  1. 下载外业指南模板。
  2. 自定义指南(添加您的徽标,特定于您的组织的疑难解答提示等)。 确保移除包含自定义步骤的第一部分。
  3. 为移动工作人员提供指南。

    移动工作人员可将该指南放到口袋中,并使用此指南解决他们在外业中遇到的问题。

提供共享位置说明

如果您的组织需要使用位置共享功能,则向移动工作人员提供有关如何开始在 Field Maps 中共享其位置的说明非常有帮助。 下面提供了位置共享说明的模板:

  1. 下载位置共享说明模板。
  2. 按照文档中的说明自定义模板并将其与移动工作人员共享。

移动设备管理

移动设备管理 (MDM) 是指用于组织中移动设备管理的软件。 MDM 用于增强数据和网络安全性以及设置和执行移动设备策略。 此外,使用 MDM 可以提高移动设备的应用程序部署和管理的效率,其中包括控制应用程序的更新方式和时间。 有关 Esri 如何应对 MDM 的详细信息,请参阅 ArcGIS Trust Center 中的 ArcGIS 安全移动实施模式

如果准备通过 MDM 将 Field Maps 部署到组织的移动设备,则可能需要配置一些应用程序和配置文件设置。 其中包括门户 URL 和每个应用程序 VPN 设置。

Field Maps 应用程序配置

应用程序配置(也称为 AppConfig)是指用于提供应用程序设置(例如门户 URL 等)的格式。 可以使用 MDM 自动指定并应用应用程序配置,而不必在每次安装移动应用程序时手动配置这些设置。 这些设置在 XML 文件中定义为键值对字典。 创建字典的方式取决于您所使用的 MDM。 有关应用程序配置的详细信息,请访问 AppConfig 社区

Field Maps 具有以下设置,可以在 MDM 中通过应用程序配置来实施这些设置:

备注

anonymousAccess

指定是匿名登录还是需要凭据

  • 在以下情况下,将忽略 anonymousAccess 参数值:
    • 未指定 portalURL
    • portalURL 中指定的门户不支持匿名访问。
  • 如果 anonymousAccesstrue 并且已指定 portalURL,则在打开 Field Maps 后,您将匿名登录门户,无需指定凭据。
  • 值为布尔型、truefalse
注:

匿名连接到门户后,专题群组中的公共地图将在地图列表中显示。 移动工作人员可以在门户中搜索任何公开共享的地图。

isAutoSyncEnabled

指定是否启用自动同步

  • 值为布尔型、truefalse
  • 默认为 true
  • 如果 isAutoSyncEnabledfalse,则将从移动设备的配置文件设置和同步面板中隐藏自动同步切换按钮。

locationProfiles

定义一个或多个位置配置文件的参数

  • 以下为必需参数:
    • name - 位置配置文件的名称。
    • mapCoordinateSystem - 地图坐标系的 WKID 代码。
    • gnssCoordinateSystem - GNSS 接收器坐标系的 WKID 代码。
    • horizontalDatumTransformationName - 水平基准面变换的名称。
  • 如果 locationProfiles 包含多组值,则列表中的第一个位置配置文件将被设置为默认配置文件。
  • 例如,[ { "name":"RTK", "mapCoordinateSystem":3857, "gnssCoordinateSystem": 6318, "horizontalDatumTransformationName": "~WGS_1984_(ITRF08)_To_NAD_1983_2011" }]
  • 值类型为字符串。

offsetProvider

指定偏移提供程序。

  • 支持以下值:
    • Bad Elf Flex
    • Eos Tools Pro
    • Spike
      注:

      Spike 仅在 iOS 中受支持。

  • 值类型为字符串。

portalURL

您组织的门户 URL

  • 打开 Field Maps 后,它将直接跳转至您组织门户的登录屏幕。
  • 例如,https://myportal.mycompany.com/gis
  • 值类型为字符串。

locationSharingMode

指定在记录轨迹时是否优化电池寿命

  • 当将 locationSharingMode 设置为 optimized 时,将根据设备活动确定录制轨迹的时间。
  • 当将 locationSharingMode 设置为 unoptimized 时,无论设备活动如何,都会记录轨迹。
  • 有关详细信息,请参阅优化电池寿命
  • 值类型为字符串。

locationSharingUploadLKLFrequency

指定最近已知位置上传频率

  • 覆盖默认设置 60 秒。
  • 单位为秒,且值必须大于 5。 没有最大限制。
  • 在用户注销前,此设置将在会话之间持续存在。
  • 值类型为整型。

locationSharingShareLKLOnly

指定位置共享历史记录的存储方式

  • 值为布尔型、truefalse
  • 如果 locationSharingLKLOnlytrue,则不存储位置共享追踪点历史记录。

locationSharingUploadTracksFrequency

指定轨迹上传频率

  • 覆盖应用程序中的默认设置。
  • 单位为秒,且值必须大于 30。
  • 值类型为整型。

maxRefreshTokenExpiration

指定令牌有效期

  • 使用永久刷新令牌覆盖默认设置。
  • 单位为分钟。
  • 值类型为整型。
  • 可以使用任意整数(2 分钟起)。
  • 0 值遵循 maxTokenExpirationMinutes 门户设置的最大值 90 天。 如果指定的值大于此设置,则该令牌将使用可以为该令牌类型创建的最大值。
  • -1 为默认值,表示永久刷新令牌。
注:

有关令牌有效期的详细信息,请参阅指定最长令牌有效期

useInAppAuth

指定是否使用 webview 在 Field Maps 中进行登录和身份验证

  • 值为布尔型、truefalse
  • 默认为 false
  • 如果 useInAppAuthfalse,将使用进程外流程启动登录页面。
  • 如果 useInAppAuthtrue,登录页面将使用应用程序内 webview。
警告:

如果需要 VPN 才能访问内部资源,并且您的组织限制了对托管设备上的浏览器的 VPN 访问权限,则可能需要将 useInAppAuth 设置为 true,才能成功登录门户。

注:

如果 Field Maps 通过 Field Maps 链接打开,该链接参数值将优先于应用程序配置设置。

每个应用程序虚拟专用网路

通过在 MDM 中配置每个应用程序虚拟专用网络(每个应用程序 VPN),可以将对内部资源的访问权限限制为特定托管应用程序。 Field Maps 可通过此配置进行部署。 要设置每个应用程序 VPN 以与 Field Maps 配合使用,请参阅您所使用的 MDM 的软件文档。

警告:

如果您使用 iOS,则 Safari 可用于在 Field Maps 中显示门户登录页面。 在已启用应用程序级 VPN 的情况下,要使此功能正确运行,必须在您所使用的应用程序级 VPN 配置文件中的 Safari 域设置中指定您的门户域(例如,mycompany.com)。 如果 Safari 域设置错误,则分配的移动设备无法访问 Field Maps 门户登录屏幕。 替代选择是将 useInAppAuth 设置为 true,这将强制登录进程在应用程序内 webview 中进行,与在 Safari 中的相反。

如上所述,当您在每个应用程序 VPN 配置文件中设置 Safari 域时,Safari 浏览器应用程序也可以访问您在 Safari 域设置中指定的门户域。 如果要阻止此访问,请配置 iOS 限制(如果在 MDM 中可用)以在所需设备上阻止 Safari 浏览器应用程序

如果您当前使用的是 Android,则将使用 Chrome 自定义选项卡(或首选浏览器)在 Field Maps 中显示门户登录屏幕。 浏览器必须具有对此的 VPN 访问权限才能在启用每个应用程序 VPN 的情况下正常运行。 请考虑将 useInAppAuth 设置为 true 以避免此要求并强制登录进程在应用程序内 webview 中进行。

在 MDM 中为 Field Maps 配置每个应用程序 VPN 设置后,当在托管移动设备上打开该应用程序时,它将自动连接到指定的每个应用程序 VPN。 Field Maps 在后台运行时,每个应用程序 VPN 仍处于连接状态,但仅连接到 Field Maps。 关闭 Field Maps 后,移动设备将自动从每个应用程序 VPN 断开连接。