文档首页> 云地图服务 KooMap> API参考> API> 空间导航> AR导航
更新时间：2023-11-17 GMT+08:00
查看PDF
分享

AR导航

功能介绍

AR导航是新型的地图导航方法，基于摄像头实时捕捉的实景画面，将地图导航信息通过数字内容的形态叠加在实景画面中，生成虚拟的3D导航指引。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/algo/navi

请求参数

表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

导航服务请求体。
表3 payload

参数

是否必选

参数类型

描述

from

是

from object

起始位置。

to

是

to object

终点位置。

utm

是

String

地区UTM编码。
表4 from

参数

是否必选

参数类型

描述

x

是

String

X坐标。

y

是

String

Y坐标。

z

是

String

Z坐标。
表5 to

参数

是否必选

参数类型

描述

x

是

String

X坐标。

y

是

String

Y坐标。

z

是

String

Z坐标。

响应参数

状态码： 200

表6 响应Header参数

参数

参数类型

描述

X-Trace-Id

String

跟踪请求ID。
表7 响应Body参数

参数

参数类型

描述

result

Integer

接口返回状态码。

  • 0：导航成功

  • 1：起始地点无效

  • 2：目标地点无效

  • 3：未连接

  • 6：栅格数据

  • 8：途径地点无效

path

Array of path objects

返回的路径信息。
表8 path

参数

参数类型

描述

linkID

String

路段ID。

x

Float

X坐标。

y

Float

Y坐标。

z

Float

Z坐标。

floor

String

楼层信息。

building

String

楼层的描述。

status

Integer

路段状态。

  • 0：未经计算

  • 1：直行

  • 2：左转

  • 3：左前方

  • 4：左后方

  • 5：右转

  • 6：右前方

  • 7：右后方

  • 8：直梯

  • 9：终止点

  • 10：扶梯

  • 11：楼梯

  • 12：途经点

请求示例

navi请求体示例。

POST https://{Endpoint}.com/v1/algo/navi

{
  "payload" : {
    "from" : {
      "x" : "xxx",
      "y" : "xxx",
      "z" : "xxx"
    },
    "to" : {
      "x" : "xxx",
      "y" : "xxx",
      "z" : "xxx"
    },
    "utm" : "51N"
  }
}

响应示例

无

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码。

父主题： 空间导航
分享：

    相关文档

    相关产品