2.0
OAS3
大疆智图 API 重建是将飞行器对范围内拍摄的图片通过算法生成地图瓦片。大疆智图 API 的所有接口调用都鉴权,在使用前需要先申请开发者网站权限。
1. 文件
文件类型可以为飞行器拍摄的图像文件,也可以为点云文件。
2. 资源
一组文件组成一个资源,一个资源内的文件可以批量下载与批量删除。一般一次飞行作业输出的图片内容应该归属到一个资源中。
3. 作业(job)
一次重建任务成为一次作业。一次作业需要一个输入资源作为数据源,与之对应在作业完成后有出一个输出资源,作为作业的结果。
1 & 2. 申请 Token,上传文件
申请上传文件到云存储的 Token,非中国大陆使用 AWS S3,中国大陆使用阿里云 OSS,区分调用对应的SDK进行上传。返回 STS Token 有时效性,请关注返回的 expireTime 字段,及时回调以及重新获取 STS Token。
使用接口/v2/store/obtain_token
3. 创建资源
文件上传完成后,调用接口创建资源,返回一个 resource_uuid。
使用接口/v2/resources
4. 资源关联文件
资源创建完成后,调用 uploadCallback 接口将上传的文件关联到资源中,通过第三步中得到的 resource_uuid 来指定资源。
使用接口/v2/store/upload_callback
5. 创建重建 job
调用 createJob 接口创建一个 job,会返回 job_uuid。
使用接口/v2/jobs
6 & 7. 启动 job,轮询状态
调用 startJob 接口启动指定 job_uuid 的 job,需要传入 resource_uuid 作为本次 job 的源数据。job 运行后,根据 job_uuid 查询 job 状态。job 结束后其处理结果存储在一个输出资源中,该资源中的文件即为重建结果。
使用接口/v2/jobs/:uuid/start
、/v2/jobs/:uuid
8. 获取 job 输出结果,下载模型到本地