云地图服务 KOOMAP-视觉定位:请求参数

时间:2024-11-05 10:17:14

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

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二选一必传。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

payload

payload object

参数解释:

客户端发送给服务器的数据,包含用户相关信息、相机内参、IMU(惯性测量单元)内参、GPS定位相关信息、SLAM(Simultaneous Localization and Mapping,即同时定位与地图构建)的相关信息。

约束限制:

不涉及。

表3 payload

参数

是否必选

参数类型

描述

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中,机器人使用传感器数据来确定自己在环境中的位置,并同时构建环境的地图。

约束限制:

不涉及。

表4 user

参数

是否必选

参数类型

描述

vpsMode

String

参数解释:

VPS的运行模式 。

约束限制:

选取特定参数 。

取值范围:

  • Offline:离线模式。

  • LocalMode:本地模式。

  • FullMode:全功能模式。

  • TrackingMode:跟踪模式。

默认取值:

不涉及。

vpsType

String

参数解释:

VPS的定位方法,目前支持GVPS。

约束限制:

字符串类型选,取特定参数。

取值范围:

  • GVPS:通用

  • DVPS:数字视频

  • LODVPS:卫星。

默认取值:

不涉及。

requestType

Integer

参数解释:

请求的设备类型 。

约束限制:

选取特定参数 。

取值范围:

  • 0:安卓手机。

  • 1:IOS手机。

  • 2:安卓web端。

  • 3:IOS web端。

  • 4:AR眼镜 。

默认取值:

0。

image

String

参数解释:

base64编码的图片信息 。

约束限制:

不涉及。

取值范围:

不涉及 。

默认取值:

不涉及。

表5 camera

参数

是否必选

参数类型

描述

fx

Float

参数解释:

相机内参,沿着x轴的焦距fx,单位为像素。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

fy

Float

参数解释:

相机内参,沿着y轴的焦距fy,单位为像素。

约束限制:

不涉及 。

取值范围:

不涉及。

默认取值:

不涉及。

cx

Integer

参数解释:

相机内参,相机光心沿x轴的坐标,单位为像素。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cy

Integer

参数解释:

相机内参,相机光心沿y轴的坐标,单位为像素。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表6 imu

参数

是否必选

参数类型

描述

accuracy

Double

参数解释:

表示IMU测量的误差值,数值越小表示测量结果越准确。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

azimuth

Double

参数解释:

方位角,表示物体绕垂直轴的旋转角度。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

roll

Double

参数解释:

横滚角,表示物体绕前进轴的旋转角度。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

pitch

Double

参数解释:

俯仰角,表示物体绕水平轴的旋转角度。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qx

Double

参数解释:

四元数的x轴方向的虚部分量。它与旋转轴在x轴方向上的投影有关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qy

Double

参数解释:

四元数的y轴方向的虚部分量。它与旋转轴在y轴方向上的投影有关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qz

Double

参数解释:

四元数的z轴方向的虚部分量。它与旋转轴在z轴方向上的投影有关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qw

Double

参数解释:

四元数的实部qw通常与旋转的余弦值相关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表7 gps

参数

是否必选

参数类型

描述

longitude

Double

参数解释:

经度,正值表示东经,负值表示西经。

约束限制:

不涉及。

取值范围:

-180° ~ 180°。

默认取值:

不涉及。

latitude

Double

参数解释:

纬度,正值表示北纬,负值表示南纬。

约束限制:

不涉及。

取值范围:

-90° ~ 90°。

默认取值:

不涉及。

accuracy

Float

参数解释:

误差值,表示位置数据的不确定性半径。数值越小表示GPS测量的精度越高。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表8 slam

参数

是否必选

参数类型

描述

x

Double

参数解释:

位置坐标参数,在三维空间中的前后位置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

y

Double

参数解释:

位置坐标参数,在三维空间中的上下位置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

z

Double

参数解释:

位置坐标参数,在三维空间中的左右位置。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qx

Double

参数解释:

四元数的x轴方向的虚部分量。它与旋转轴在x轴方向上的投影有关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qy

Double

参数解释:

四元数的y轴方向的虚部分量。它与旋转轴在y轴方向上的投影有关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qz

Double

参数解释:

四元数的z轴方向的虚部分量。它与旋转轴在z轴方向上的投影有关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

qw

Double

参数解释:

四元数的实部qw通常与旋转的余弦值相关。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

support.huaweicloud.com/api-koomap/StartVps.html