新增图片上的刺点
功能介绍
用户选择生产资料列表中的像控点信息,并在图片中标记出来的过程叫做刺点。该接口用来在图片上新增刺点,刺点的具体信息包括:
像控点的经度、纬度、高度及精度信息。
刺点所在的图片ID,以及在图片中的像素点位置信息,包括横向和纵向像素值。
刺点所属的任务ID信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/real3d/spur
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
IAM Token信息,用于租户鉴权,该字段由租户请求IAM的Token接口获得。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
imageCode |
是 |
String |
图片ID。 |
taskId |
是 |
String |
刺点所属任务ID。 |
pointWidth |
是 |
String |
刺点在图片中的横向像素值,以分块左上角为原点,不能超过图片范围。 |
pointHeight |
是 |
String |
刺点在图片中的纵向像素值,以分块左上角为原点,不能超过图片范围。 |
longitude |
是 |
String |
像控点经度。范围:[-10000000, 10000000]。 |
latitude |
是 |
String |
像控点纬度。范围:[-10000000, 10000000]。 |
height |
是 |
String |
像控点高度。范围:[-10000000, 10000000]。 |
accuracy |
是 |
String |
像控点精度。范围:(0, 100)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
imageCode |
String |
图像ID。 |
id |
String |
刺点ID。 |
taskId |
String |
刺点所属任务ID。 |
pointWidth |
String |
刺点在图片中的横向像素值。 |
pointHeight |
String |
刺点在图片中的纵向像素值。 |
longitude |
String |
像控点经度。 |
latitude |
String |
像控点纬度。 |
height |
String |
像控点高度。 |
accuracy |
String |
像控点精度。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
请求示例
该请求在图片中新建一个刺点。
POST https://{Endpoint}/v1/real3d/spur { "imageCode" : "1674019035390013440", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" }
响应示例
状态码: 200
请求成功。
{ "imageCode" : "1674019035390013440", "id" : "1676151290921086976", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" }
状态码
状态码 |
描述 |
---|---|
200 |
请求成功。 |
400 |
非法请求。 |
500 |
服务内部错误。 |
错误码
请参见错误码。