设备变量

设备变量用于自动填充具有常用 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表示设备面向下。

双精度

-

注:

手动编辑点后,将清除 magneticDeclinationazimuthpitchroll 变量。

用户信息

变量兼容字段类型兼容要素类型字段变量将自动分配给

用户名

变量名称:username

当前登录用户名。

文本

点、线、面

-

全名

变量名称:fullName

当前登录的用户全名。

文本

点、线、面

-

名字

变量名称:firstName

当前登录的用户名字。

文本

点、线、面

-

姓氏

变量名称:lastName

当前登录的用户姓氏。

文本

点、线、面

-

Email

变量名称: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。 仅当为工程配置了楼层感知型地图,打开了该地图并且选择了建筑物和楼层时,此变量才可用。 否则,存储的默认值为空。

文本

点、线、面

-

注:

手动编辑点后,将清除 altitudehorizontalAccuracyverticalAccuracy 变量。

行驶

变量兼容字段类型兼容要素类型字段变量将自动分配给

速度(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 时使用变量名称创建。

手动编辑点后,将清除 speedMSspeedKPHspeedMPHspeedKTSverticalSpeedMSverticalSpeedMPHverticalSpeedKPHverticalSpeedKTSdirectiondirectionCardinal4directionCardinal8 变量。

照片

变量兼容字段类型兼容要素类型字段变量将自动分配给

相机朝向 (°)

变量名称:camHeading

拍摄照片时设备后置摄像头的罗盘方位,北为 0,东为 90,南为 180,西为 270。 其也将保存至 EXIF 标签 GPSImgDirection。 请注意如果拍摄照片时 camRoll 值大于 ±10 度,则 camHeading 不可靠。

双精度

-

相机仰俯角 (°)

变量名称:camPitch

拍摄照片时设备后置摄像头的俯仰角,其中 0 表示摄像头朝地面向下看,而 90 表示设备垂直于地面向前看。

双精度

-

相机转动 (°)

变量名称:camRoll

拍摄照片时设备后置摄像头的滚动角,其中 0 表示不滚动,90 表示设备向右滚动,-90表示摄像头向左滚动。 滚动角超过 ±45 度将导致设备方向从纵向切换为横向,并且 camHeadingcamPitchcamRoll 角度将相应调整。

双精度

-

水平视域 (°)

变量名称: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

horizontalAccuracyverticalAccuracy 属性报告的精度类型。 可能产生的结果为 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 变量。