云地图服务 KOOMAP-视觉定位:请求参数
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Trace-Id |
否 |
String |
参数解释: 追踪请求ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
App-Id |
否 |
String |
参数解释: 可选项,场景模板分配的app_id。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
Uuid |
是 |
String |
参数解释: 设备或者用户唯一标识。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
X-Auth-Token |
否 |
String |
参数解释: IAM Token,和Authorization二选一必传。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
Authorization |
否 |
String |
参数解释: AK/SK签名结果,和X-Auth-Token二选一必传。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
payload |
是 |
payload object |
参数解释: 客户端发送给服务器的数据,包含用户相关信息、相机内参、IMU(惯性测量单元)内参、GPS定位相关信息、SLAM(Simultaneous Localization and Mapping,即同时定位与地图构建)的相关信息。 约束限制: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
user |
是 |
user object |
参数解释: 用户相关信息。 约束限制: 不涉及。 |
camera |
是 |
camera object |
参数解释: 相机内参,在计算机视觉和图像处理中,描述相机如何将三维世界映射到二维图像平面的一组参数。 约束限制: 不涉及。 |
imu |
是 |
Array of imu objects |
参数解释: IMU内参。用于测量和报告一个物体的特定力、角速度以及在某些情况下,磁场周围物体的方向的设备。 约束限制: 不涉及。 |
gps |
是 |
Array of gps objects |
参数解释: GPS相关信息,用户确定其地理位置的经纬度。 约束限制: 不涉及。 |
slam |
是 |
Array of slam objects |
参数解释: SLAM即同时定位与建图,是一种让机器人在未知环境中进行自主导航和建图的技术。在SLAM中,机器人使用传感器数据来确定自己在环境中的位置,并同时构建环境的地图。 约束限制: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
vpsMode |
否 |
String |
参数解释: VPS的运行模式 。 约束限制: 选取特定参数 。 取值范围:
默认取值: 不涉及。 |
vpsType |
否 |
String |
参数解释: VPS的定位方法,目前支持GVPS。 约束限制: 字符串类型选,取特定参数。 取值范围:
默认取值: 不涉及。 |
requestType |
否 |
Integer |
参数解释: 请求的设备类型 。 约束限制: 选取特定参数 。 取值范围:
默认取值: 0。 |
image |
是 |
String |
参数解释: base64编码的图片信息 。 约束限制: 不涉及。 取值范围: 不涉及 。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
fx |
是 |
Float |
参数解释: 相机内参,沿着x轴的焦距fx,单位为像素。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
fy |
是 |
Float |
参数解释: 相机内参,沿着y轴的焦距fy,单位为像素。 约束限制: 不涉及 。 取值范围: 不涉及。 默认取值: 不涉及。 |
cx |
是 |
Integer |
参数解释: 相机内参,相机光心沿x轴的坐标,单位为像素。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
cy |
是 |
Integer |
参数解释: 相机内参,相机光心沿y轴的坐标,单位为像素。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
accuracy |
是 |
Double |
参数解释: 表示IMU测量的误差值,数值越小表示测量结果越准确。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
azimuth |
是 |
Double |
参数解释: 方位角,表示物体绕垂直轴的旋转角度。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
roll |
是 |
Double |
参数解释: 横滚角,表示物体绕前进轴的旋转角度。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
pitch |
是 |
Double |
参数解释: 俯仰角,表示物体绕水平轴的旋转角度。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qx |
是 |
Double |
参数解释: 四元数的x轴方向的虚部分量。它与旋转轴在x轴方向上的投影有关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qy |
是 |
Double |
参数解释: 四元数的y轴方向的虚部分量。它与旋转轴在y轴方向上的投影有关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qz |
是 |
Double |
参数解释: 四元数的z轴方向的虚部分量。它与旋转轴在z轴方向上的投影有关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qw |
是 |
Double |
参数解释: 四元数的实部qw通常与旋转的余弦值相关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
longitude |
是 |
Double |
参数解释: 经度,正值表示东经,负值表示西经。 约束限制: 不涉及。 取值范围: -180° ~ 180°。 默认取值: 不涉及。 |
latitude |
是 |
Double |
参数解释: 纬度,正值表示北纬,负值表示南纬。 约束限制: 不涉及。 取值范围: -90° ~ 90°。 默认取值: 不涉及。 |
accuracy |
是 |
Float |
参数解释: 误差值,表示位置数据的不确定性半径。数值越小表示GPS测量的精度越高。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
x |
是 |
Double |
参数解释: 位置坐标参数,在三维空间中的前后位置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
y |
是 |
Double |
参数解释: 位置坐标参数,在三维空间中的上下位置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
z |
是 |
Double |
参数解释: 位置坐标参数,在三维空间中的左右位置。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qx |
是 |
Double |
参数解释: 四元数的x轴方向的虚部分量。它与旋转轴在x轴方向上的投影有关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qy |
是 |
Double |
参数解释: 四元数的y轴方向的虚部分量。它与旋转轴在y轴方向上的投影有关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qz |
是 |
Double |
参数解释: 四元数的z轴方向的虚部分量。它与旋转轴在z轴方向上的投影有关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
qw |
是 |
Double |
参数解释: 四元数的实部qw通常与旋转的余弦值相关。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |