设备变量用于自动填充具有常用 GIS 属性的 QuickCapture 字段。 并非所有变量都可应用于所有类型的字段。 例如，时间戳变量仅适用于日期类型的字段。
一些变量将自动分配给具有特定名称的按钮字段。 您可以在要素图层中手动创建这些指定字段，或者在 ArcGIS Online 中创建要素图层或在 ArcGIS Enterprise 中创建要素图层时选择捕获 GPS 接收器信息。
设备信息
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
工程名称 变量名称：projectName 用于捕获记录的工程名称。 | 文本 | 点、线、面 | - |
安装 UUID 变量名称：installUUID 安装时创建的移动应用程序的唯一标识符。 此变量可用于唯一标识设备。 | 文本 | 点、线、面 | - |
应用程序版本 变量名称：appVersion QuickCapture 版本。 | 字符串 | 点、线、面 | - |
操作系统 变量名称：operatingSystem 平台和操作系统版本。 | 字符串 | 点、线、面 | - |
会话 ID 变量名称：sessionId 每次打开位置共享时都会生成一个唯一 ID。 | 字符串 | 点、线、面 | - |
电源模式 变量名称：powerMode 电源模式类别。 可能结果包括未知 (0)、平衡 (1)、省电模式。 | 整型 | 整型 | - |
电源 变量名称：powerSource 电源类别。 可能结果包括未知 (0)、交流 (1)、USB (2)、无线 (3) 和电池 (4)。 | 整型 | 点 | - |
电池状态 变量名称：batteryState 电池状态类别。 可能结果包括未知 (0)、未插入 (1)、正在充电 (2)、已插入并已充满电 (3)、已插入但未充电 (4)。 | 整型 | 点 | - |
电池电量 变量名称：batteryLevel 电池电量百分比 (0-100)。 | 整型 | 点 | - |
磁偏角 变量名称：magneticDeclination 以十进制度表示的磁北和正北之间的角度。 | 双精度 | 点 | - |
方位角 (°) 变量名称：azimuth 捕获记录时设备的罗盘方位，北为 0，东为 90，南为 180，西为 270。 | 双精度 | 点 | esrisnsr_azimuth |
仰俯角 (°) 变量名称：pitch 捕获记录时设备的俯仰角，其中 0 表示设备正面朝上，90 表示设备垂直于地面倾斜。 | 双精度 | 点 | - |
转动 (°) 变量名称：roll 捕获记录时设备的滚动角，其中 0 表示设备面向上，90 表示设备向右滚动，-90 表示设备向左滚动，而 180表示设备面向下。 | 双精度 | 点 | - |
注：
手动编辑点后，将清除 magneticDeclination、azimuth、pitch 和 roll 变量。
用户信息
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
用户名 变量名称：username 当前登录用户名。 | 文本 | 点、线、面 | - |
全名 变量名称：fullName 当前登录的用户全名。 | 文本 | 点、线、面 | - |
名字 变量名称：firstName 当前登录的用户名字。 | 文本 | 点、线、面 | - |
姓氏 变量名称：lastName 当前登录的用户姓氏。 | 文本 | 点、线、面 | - |
变量名称：email 当前登录的用户电子邮件。 | 文本 | 点、线、面 | - |
位置
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
捕获时间(UTC) 变量名称：captureTime 以 UTC 表示的捕获时间。 | 日期 | 点 | esrignss_fixdatetime |
捕获时间（仅日期） 变量名称：captureTime_dateOnly 仅包含本地捕获日期。 | 仅日期 | 点 | - |
捕获时间（仅时间） 变量名称：captureTime_timeOnly 仅包含本地捕获时间。 | 仅时间 | 点 | - |
捕获时间（具有 UTC 偏移的日期时间） 变量名称：captureTime_timeStampOffset 具有 UTC 偏移的本地捕获时间。 | TimeStampOffset | 点 | - |
纬度(DD) 变量名称：latitude 以十进制度表示的纬度。 | 双精度 | 点 | esrignss_latitude |
经度(DD) 变量名称：longitude 以十进制度表示的经度。 | 双精度 | 点 | esrignss_longitude |
高度(m) 变量名称：altitude 以米为单位的海拔高度或大地高度。 | 双精度 | 点 | esrignss_altitude |
水平精度(m) 变量名称：horizontalAccuracy 以米为单位的 x,y 坐标水平精度。 | 双精度 | 点 | esrignss_h_rms |
垂直精度(m) 变量名称：verticalAccuracy 以米为单位的 z 坐标垂直精度。 | 双精度 | 点 | esrignss_v_rms |
位置 DMS 变量名称：DMS 以空格分隔的字符串形式的位置，以度、分、秒为单位。 | 文本 | 点 | - |
位置 DDM 变量名称：DDM 以空格分隔的字符串形式的位置，以度和十进制分为单位。 | 文本 | 点 | - |
位置 USNG 变量名称：USNG 以美国国家格网表示的位置。 | 文本 | 点 | - |
位置 MGRS 变量名称：MGRS 军事格网参考系中的位置。 | 文本 | 点 | - |
注：
手动编辑点后，将清除 altitude、horizontalAccuracy 和 verticalAccuracy 变量。
行驶
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
速度(m/s) 变量名称：speedMS 以米/秒为单位的地面速度。 | 双精度 | 点 | - |
速度(km/h) 变量名称：speedKPH 以千米/小时为单位的地面速度。 | 双精度 | 点 | esrignss_speed |
速度(mi/h) 变量名称：speedMPH 以英里/小时为单位的地面速度。 | 双精度 | 点 | - |
速度(节) 变量名称：speedKTS 以节为单位的地面速度。 | 双精度 | 点 | - |
verticalSpeedMS 以米/秒为单位的垂直速度。 | 双精度 | 点 | - |
变量名称：verticalSpeedKPH 以千米/小时为单位的垂直速度。 | 双精度 | 点 | - |
变量名称：verticalSpeedMPH 以英里/小时为单位的垂直速度。 | 双精度 | 点 | - |
变量名称：verticalSpeedKTS 以节为单位的垂直速度。 | 双精度 | 点 | - |
行驶方向(°) 变量名称：direction 以北为基准方向按顺时针进行测量的行驶方向（以十进制度表示）。 | 双精度 | 点 | - |
4 个主方向的行驶方向 变量名称：directionCardinal4 行驶方向概化为四个基本方向之一。 可能产生的结果为 N、E、S 和 W。 | 文本 | 点 | - |
8 个主方向的行驶方向 变量名称：directionCardinal8 行驶方向概化为八个基本方向之一。 可能产生的结果为 N、NE、E、SE、S、SW、W 和 NW。 | 文本 | 点 | - |
活动类型 变量名称：activityType 用户活动类型：Unknown (0)、Stationary (1)、Walking (2)、Running (3)、Cycling (4) 和 Automotive (5) | 文本 | 点 | - |
开始时间 变量名称：startTime 激活按钮的日期和时间。 | 日期 | 线、面 | - |
结束时间 变量名称：endTime 停用按钮的日期和时间。 | 日期 | 线、面 | - |
长度 (m) 变量名称：lengthM 以米为单位的大地测量长度。 | 双精度 | 线、面 | - |
长度 (km) 变量名称：lengthKM 以公里为单位的大地测量长度。 | 双精度 | 线、面 | - |
长度 (mi) 变量名称：lengthMI 以英里为单位的大地测量长度。 | 双精度 | 线、面 | - |
面积 (m2) 变量名称：areaM2 以平方米为单位的面积，仅适用于面图层。 | 双精度 | 面 | - |
面积 (km2) 变量名称：areaKM2 以平方千米为单位的面积，仅适用于面图层。 | 双精度 | 面 | - |
面积 (mi2) 变量名称：areaMI2 以平方英里为单位的面积，仅适用于面图层。 | 双精度 | 面 | - |
注：
垂直速度不能分配给 Web 设计器 GUI 中的按钮字段，但可以在编辑工程 JSON 时使用变量名称创建。
手动编辑点后，将清除 speedMS、speedKPH、speedMPH、speedKTS、verticalSpeedMS、verticalSpeedMPH、verticalSpeedKPH、verticalSpeedKTS、direction、directionCardinal4 和 directionCardinal8 变量。
照片
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
相机朝向 (°) 变量名称：camHeading 拍摄照片时设备后置摄像头的罗盘方位，北为 0，东为 90，南为 180，西为 270。 其也将保存至 EXIF 标签 GPSImgDirection。 请注意如果拍摄照片时 camRoll 值大于 ±10 度，则 camHeading 不可靠。 | 双精度 | 点 | - |
相机仰俯角 (°) 变量名称：camPitch 拍摄照片时设备后置摄像头的俯仰角，其中 0 表示摄像头朝地面向下看，而 90 表示设备垂直于地面向前看。 | 双精度 | 点 | - |
相机转动 (°) 变量名称：camRoll 拍摄照片时设备后置摄像头的滚动角，其中 0 表示不滚动，90 表示设备向右滚动，-90表示摄像头向左滚动。 滚动角超过 ±45 度将导致设备方向从纵向切换为横向，并且 camHeading、camPitch 和 camRoll 角度将相应调整。 | 双精度 | 点 | - |
水平视域 (°) 变量名称：hfov 相机镜头的水平视域，以度为单位。 根据照片 EXIF 标签 FocalLength35mmFilm 计算此变量。 如果缺少 EXIF 标签，则返回的值为空。 | 双精度 | 点 | - |
垂直视域 (°) 变量名称：vfov 相机镜头的垂直视域，以度为单位。 根据照片 EXIF 标签 FocalLength35mmFilm 计算此变量。 如果缺少 EXIF 标签，则返回的值为空。 | 双精度 | 点 | - |
照片纬度 (DD) 变量名称：photoLatitude 拍摄照片时的纬度（以十进制度为单位）。 其也将保存至 EXIF 标签 GPSLatitude。 | 双精度 | 点 | - |
照片经度 (DD) 变量名称：photoLongitude 拍摄照片时的经度（以十进制度为单位）。 其也将保存至 EXIF 标签 GPSLongitude。 | 双精度 | 点 | - |
注：
对于支持多张照片的按钮，不会计算相机设备变量。
GNSS
GNSS 变量通常仅在直接连接到外部 GNSS 接收器时可用，但是，在通过模拟位置提供程序连接外部接收器时，标有 * 的变量也可以用于 Android。
| 变量 | 兼容字段类型 | 兼容要素类型 | 字段变量将自动分配给 |
|---|---|---|---|
位置源类型* 变量名称：positionSourceType 位置源的类别。 可能产生的结果分为以下几种：Unknown (0)、User (1)、System Location (2)、External Device (3) 和 Network Device (4)。 | 整型 | 点、线、面 | esrignss_positionsourcetype |
修复类型* 变量名称：fixType 坐标的定位类型。 可能产生的结果分为以下几种：NoFix (0)、GPS (1)、DifferentialGPS (2)、PrecisePositioningService (3)、RTKFixed (4)、RTKFloat (5)、Estimated (6)、Manual (7)、Simulator (8) 和 SBAS (9)。 | 整型 | 点 | esrignss_fixtype |
设备地址 变量名称：deviceAddress 通常，此地址为设备的蓝牙 MAC 地址，例如 0C:00:0A:BB:28:FC。 但是，在 iOS 上，蓝牙 MAC 不可用，因此会返回唯一设备标识符，例如 3f89ecd0-bbe5-11ea-8b6e-0800200c9a66。 | 文本 | 点 | - |
位置传感器名称* 变量名称：sensorName 使用集成位置提供程序时，名称为 AppStudio-CoreLocation。 使用外部接收器时，它将为外部硬件报告的接收器名称。 | 文本 | 点 | esrignss_receiver |
位置传感器连接类型 变量名称：deviceType 外部设备的类型。 可能产生的结果为：Unknown (-1)、Bluetooth (0)、Serial Port (1) 和 Bluetooth LE (2)。 | 整型 | 点 | - |
网络名称 变量名称：networkName 这仅适用于网络位置提供商。 | 文本 | 点 | - |
网络地址 变量名称：networkAddress 这仅适用于网络位置提供商。 | 文本 | 点 | - |
网络端口 变量名称：networkPort 这仅适用于网络位置提供商。 | 整型 | 点 | - |
正高* 变量名称：geoidSeparationCustom 用户在应用程序设置中定义的 WGS84 地球椭圆体与平均海平面之间的差异。 这适用于所有位置提供商类型。 | 双精度 | 点 | - |
天线高度 变量名称：antennaHeight 从高度值中减去天线到地表的距离（以米为单位）。 | 双精度 | 点 | - |
高度类型* 变量名称：altitudeType 可能的结果为平均海平面 (0) 上方的高度和椭圆体 (1) 上方的高度。 | 整型 | 点 | - |
大地水准面分离* 变量名称：geoidSeparation 通过 GNSS 接收器报告的 WGS84 地球椭圆体与平均海平面之间的差异（以米为单位）。 它也被称为正高。 | 双精度 | 点 | - |
精度类型 (RMS v DOP)* 变量名称：accuracyType 由 horizontalAccuracy 和 verticalAccuracy 属性报告的精度类型。 可能产生的结果为 RMS (0) 和 DOP (1)。 RMS 为均方根精度。 该结果根据接收器提供的 GST 语句中报告的纬度、经度和高度误差的 68％ 置信区间计算得出。 如果接收器不支持 GST，请使用 DOP。 DOP 为基于精度的精度衰减因子。 它使用恒定的用户估算范围误差 (UERE) 值来估算水平和垂直精度。 | 整型 | 点 | - |
精度置信度* 变量名称：confidenceLevelType 可能产生的结果为 68% (0) 和 95% (1)。 | 整型 | 点 | - |
平均径向球面误差 变量名称：positionAccuracy 平均径向球面误差(以米为单位)。 其中包括水平和垂直误差。 | 双精度 | 点 | - |
GST 纬度 1-sigma 误差 变量名称：latitudeError 纬度 1-sigma 错误的值（以米为单位）。 仅当您的定位设备支持 NMEA 流中的 GST 语句时，才会填充此属性。 | 双精度 | 点 | - |
GST 经度 1-sigma 误差 变量名称：longitudeError 经度 1-sigma 错误的值（以米为单位）。 仅当您的定位设备支持 NMEA 流中的 GST 语句时，才会填充此属性。 | 双精度 | 点 | - |
GST 高度 1-sigma 误差 变量名称：altitudeError 高度 1-sigma 错误的值（以米为单位）。 仅当您的定位设备支持 NMEA 流中的 GST 语句时，才会填充此属性。 | 双精度 | 点 | - |
HDOP* 变量名称：hdop 位置数据的水平精度衰减因子。 | 双精度 | 点 | esrignss_hdop |
VDOP* 变量名称：vdop 位置数据的垂直精度衰减因子。 | 双精度 | 点 | esrignss_vdop |
PDOP* 变量名称：pdop 位置数据的位置精度衰减因子。 用于确定 PDOP 的公式为 PDOP^2 = HDOP^2 + VDOP^2。 | 双精度 | 点 | esrignss_pdop |
差分龄期* 变量名称：differentialAge 差分信号的期限和 GPS 接收器用于差分校正位置的校正（以秒为单位）。 | 双精度 | 点 | esrignss_correctionage |
参考站 ID* 变量名称：referenceStationId GPS 接收器使用的站的差分参考站 ID (DSID)。 | 整型 | 点 | esrignss_stationid |
可见卫星 变量名称：satellitesVisible 位置捕获时可见的定位卫星数。 | 整型 | 点 | - |
使用中卫星 变量名称：satellitesInUse 用于返回位置数据的定位卫星数。 | 整型 | 点 | esrignss_numsats |
注：
手动编辑点后，将清除所有外部 GNSS 变量。