新增图片上的刺点
功能介绍
用户选择生产资料列表中的像控点信息，并在图片中标记出来的过程叫做刺点。该接口用来在图片上新增刺点，刺点的具体信息包括：
像控点的经度、纬度、高度及精度信息。
刺点所在的图片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 |
请求状态码。 最小长度：3 最大长度：36 |
error_msg |
String |
错误描述。 最小长度：2 最大长度：512 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
请求状态码。 最小长度：3 最大长度：36 |
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 |
服务内部错误。 |
错误码
请参见错误码。
