FAQ
- 大疆智图 API 是不是私有化部署?
- 大疆智图 API 的二三维重建解算服务是在用户本地服务器完成,还是大疆云端服务器完成?
- 相同数据,大疆智图 API 的重建,与大疆智图在本地电脑重建,时间和效果有什么不同?
- 当前大疆智图 API 是否拥有大疆智图的所有功能接口?
- 大疆智图 API 的开发难度怎么样,预计开发周期多久?
- 大疆智图 API 的接入可用什么开发语言进行开发?
- 大疆智图 API 如何获取技术支持?
- 大疆智图 API 如何收费?
- 我的资源文件过大或过小会怎么样,有没有限制?
- 接口调用报错怎么办?
- AK/SK 是什么?怎么获取 AK/SK?
- 请求不通过?
- 调用接口请求报错 HMAC signature does not match?
- BoundingBox 属性在哪里?
- 拼图应该使用广角照片还是变焦照片?
- 获取文件 URL 无法下载?
大疆智图 API 是不是私有化部署?
大疆智图 API 需要使用云端算力,完成二三维重建。用户需要将图片 / 点云数据上传至互联网才能解算,与用户常说的内网私有化部署不同。
大疆智图 API 的二三维重建解算服务是在用户本地服务器完成,还是大疆云端服务器完成?
大疆智图 API 二三维重建解算,需要使用大疆智图重建引擎,在大疆的云端服务器完成运算。
相同数据,大疆智图 API 的重建,与大疆智图在本地电脑重建,时间和效果有什么不同?
在不考虑数据上传,成果文件同步等步骤时,大疆智图 API 云端重建时间与大疆智图单机版在本地电脑运算时间接近。
大疆智图 API 重建引擎算法版本与大疆智图重建引擎算法版本,不会完全一致,且运行环境不同,针对相同数据可能存在细小差异。
当前大疆智图 API 是否拥有大疆智图的所有功能接口?
当前大疆智图上能实现,但是大疆智图 API 不能实现的功能模块包括:实时二三维重建、控制点、农业应用、集群运算等;大疆智图 API 将根据用户需求不断更新增加功能。
大疆智图 API 的开发难度怎么样,预计开发周期多久?
2-3 天即可完成大疆智图 API 接入实现二三维重建,更多业务功能开发取决于实际功能需求。
大疆智图 API 的接入可用什么开发语言进行开发?
使用 Java,Python,Go,C,C++,PHP,Android,iOS,.NET 等主流开发语言都可以。
大疆智图 API 如何获取技术支持?
技术支持途径:
- 邮件咨询 dev@dji.com
- 官网开发者论坛
大疆智图 API 如何收费?
公测 1 年,公测期间免费。后续收费将通过大疆官网等渠道对外公布。
我的资源文件过大或过小会怎么样,有没有限制?
为保证重建作业成功,重建素材要求:
- 2D/3D:要求十张以上影像,重叠率 70% 以上,3D 作业单次最多不超过 20000 张,2D 作业单次最多不超过 4000 张
- LiDAR:L1 或 L2 采集的超过 2 分钟的数据,数据文件夹里包含有 IMU、RTK、RTB、RTL、RTS、LDR、CLC、CLI 等文件,如需成果带颜色信息,还需要附带采集时图片,总大小不能超过 48 G
接口调用报错怎么办?
当调用接口发生错误时,请先对照错误码章节进行排查。如果无法排查出结果,请收集以下信息提单给技术支持:
- 完整请求体
- 完整的请求头
- 返回的响应状态
- 返回的响应信息
AK/SK 是什么?怎么获取 AK/SK?
AK/SK 认证是一种通过 AK/SK 对请求进行数字签名的方法。在发送请求时,这种签名会被添加到消息头部,用以完成身份验证。
- AK(App Key,访问密钥 ID):这是一个与私有访问密钥相关联的独特标识符。它与私有访问密钥一起用于对请求信息进行加密签名。
- SK(Secret Key,私有访问密钥):这是一个用于加密签名的密钥,与访问密钥 ID 一起使用,用于认证请求者的身份,并确保请求内容在传输过程中未被篡改。
AK/SK 信息需要在开发者网站 中开通大疆智图 API 后进行获取。
图 . 大疆智图 API AK/SK 信息

请求不通过?
- 检查域名:
- 中国大陆:https://openapi-cn.dji.com
- 非中国大陆:https://openapi-us.dji.com
- 检查签名
调用接口请求报错 HMAC signature does not match?
该错误是调用接口时加签错误导致的,开发者需要遵循文档规范进行加签处理,加签逻辑可以查看 API 文档:网关加签规范
BoundingBox 属性在哪里?
tif 的 BoundingBox 属性在 tig 同目录下的 .tfw 文件以及 report 文件夹里的 map_report.json 中。
拼图应该使用广角照片还是变焦照片?
广角照片
获取文件 URL 无法下载?
通过以下命令获取 URL:
- 如果直接打印到 shell 上会被自动 unicode-escape 编码。
/terra-rescon-be/v2/files/$uuid
- 如果不打印直接下载或者进行解码。
# 获取到的 url 直接下载
curl -X ${HTTP_METHOD} ${url} \
-H "Date: ${x_date}" \
-H "Digest: SHA-256=${digest}" \
-H "Authorization: hmac username=\"${DJI_APP_KEY}\", algorithm=\"hmac-sha256\", headers=\"date @request-target digest\", signature=\"${request_signature}\"" \
-H 'Content-Type: application/json;charset=UTF-8' | jq -r '.data.url' | xargs wget -O a.png
# 进行解码再输出
curl -X ${HTTP_METHOD} ${url} \
-H "Date: ${x_date}" \
-H "Digest: SHA-256=${digest}" \
-H "Authorization: hmac username=\"${DJI_APP_KEY}\", algorithm=\"hmac-sha256\", headers=\"date @request-target digest\", signature=\"${request_signature}\"" \
-H 'Content-Type: application/json;charset=UTF-8' | jq -r '.data.url' | python -c 'import sys; print(sys.stdin.buffer.read().decode("unicode-escape"))'