本文介绍双目立体视觉深度估计EstimateStereoImageDepth的语法及示例。

功能描述

双目立体视觉深度估计可以基于两张输入的双目彩色图像(左图和右图),估计并输出左图所对应的视差图。

应用场景

  • 辅助驾驶:双目立体视觉深度估计可比较精确地估计路上的物体距离,可以以较低成本的视觉方案,提供车距告警等辅助驾驶功能。
  • 服务或货运机器人:双目立体视觉深度估计作为SLAM(定位与地图构建)的测距方式,可以帮助机器人以较低成本的视觉方案实现自动行进。

特色优势

  • 较低的深度测算成本:相对于激光雷达,毫米波雷达,双目立体视觉深度估计可以以较低成本获得较高精度的深度数据,帮助低速的无人小车、机器人实现自动行驶。
  • 较高精度的深度信息:相对于单目深度估计,双目立体视觉深度估计可以获取到较高精度的深度信息。

前提条件

请确保您已开通3D视觉服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过3M。
  • 图像分辨率:小于960×960像素(宽×高)。如果图像不满足以上要求,系统会将图像按比例进行缩放。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String EstimateStereoImageDepth

系统规定参数。取值:EstimateStereoImageDepth

LeftImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/test/left.png

左图URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

RightImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/test/right.png

右图URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String 8B69644C-4815-476B-B087-340BAADE8E35

请求ID。

Data Object

返回的结果数据内容。

DisparityMapURL String http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/StereoDepthPrediction/972ebf03-bd8c-47f6-9281-383fef3fff09/disparity.npy

返回左图对应视差结果的URL。

DisparityVisURL String http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/StereoDepthPrediction/972ebf03-bd8c-47f6-9281-383fef3fff09/disparity.png

返回左图对应视差可视化结果的URL。

示例

请求示例

http(s)://[Endpoint]/?Action=EstimateStereoImageDepth
&LeftImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/test/left.png
&RightImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/test/right.png
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>8B69644C-4815-476B-B087-340BAADE8E35</RequestId>
<Data>
    <DisparityVisURL>http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/StereoDepthPrediction/972ebf03-bd8c-47f6-9281-383fef3fff09/disparity.png</DisparityVisURL>
    <DisparityMapURL>http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/StereoDepthPrediction/972ebf03-bd8c-47f6-9281-383fef3fff09/disparity.npy</DisparityMapURL>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "8B69644C-4815-476B-B087-340BAADE8E35",
  "Data" : {
    "DisparityVisURL" : "http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/StereoDepthPrediction/972ebf03-bd8c-47f6-9281-383fef3fff09/disparity.png",
    "DisparityMapURL" : "http://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/StereoDepthPrediction/972ebf03-bd8c-47f6-9281-383fef3fff09/disparity.npy"
  }
}

错误码

关于双目立体视觉深度估计的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。