设备变量用于自动填充具有常用 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 军事格网参考系中的位置。 | 文本 | 点 | - |
层级 ID 变量名称:levelId 楼层感知型地图中层级要素的唯一 ID。 仅当为工程配置了楼层感知型地图,打开了该地图并且选择了建筑物和楼层时,此变量才可用。 否则,存储的默认值为空。 | 文本 | 点、线、面 | - |
注:
手动编辑点后,将清除 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 变量。