identify - kqmicrogo

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法identify

collectionName

string

影像集名称

必需

collectionId

string

可选

资源ID ，和collectionName功能相同，用于确定影像集。二选一。

point

object

必需

点坐标，格式为{"x": 23.00,"y":34.00}，或点对象数组[{"x": 23.00,"y":34.00}]

geoSRS

string

必需

geometry参数空间参考，默认情况下，假定几何位于影像服务的空间参考中。

renderRule

object

可选

暂不支持。JSON对象，指定如何渲染请求的图像的渲染规则。

renderRules

object

可选

暂不支持。指定渲染规则数组。使用此参数可在一个请求中从不同的栅格函数获取多个处理后的值。句法renderingRules=[{renderingRule1},{renderingRule2},{renderingRule3},{renderingRule4}]

pixelSize

object

可选

暂不支持。正在使用的像素级别（或正在查看的分辨率）如果未指定像素大小，pixelSize将默认为数据集的基本分辨率。镶嵌数据集中指定像素大小的栅格将用于识别。暂不支持

time

string

可选

导出图像的时间瞬间或时间范围。

rasterIds

array[string]

可选

String返回影像集合中指定ID的影像的瓦片资源，该参数支持输入多个ID值，需使用“,”逗号分隔。

returnPixelValues

boolean

可选

是否返回所请求几何图形下所有子影像的像素值。如果为false，则请求的几何图形只需要镶嵌输出的像素值。此参数的默认值为true。（代码尚未实现）

returnDetail

boolean

可选

是否返回详细的点和结果的映射关系，默认为false，仅在point 参数为数组是有效

示例

1、兼容原单点坐标
{
   "request":"identify",
    "collectionName":"420281大冶市",
    "point":{
        "x":38589551.9435897395,
        "y":3332651.4875125242
    },
    "geoSRS":"EPSG:2362"
}

2、多点查询识别
{
    "request": "identify",
    "collectionName": "420281大冶市",
    "point": [
        {
            "x": 38589551.9435897395,
            "y": 3332651.4875125242
        },
        {
            "x": 38589651.9435897395,
            "y": 3332551.4875125242
        }
    ],
    "geoSRS": "EPSG:2362"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://172.16.1.44:9800/rest/services//image/identify' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '1、兼容原单点坐标
{
   "request":"identify",
    "collectionName":"420281大冶市",
    "point":{
        "x":38589551.9435897395,
        "y":3332651.4875125242
    },
    "geoSRS":"EPSG:2362"
}

2、多点查询识别
{
    "request": "identify",
    "collectionName": "420281大冶市",
    "point": [
        {
            "x": 38589551.9435897395,
            "y": 3332651.4875125242
        },
        {
            "x": 38589651.9435897395,
            "y": 3332551.4875125242
        }
    ],
    "geoSRS": "EPSG:2362"
}'

返回响应

🟢200成功

application/json

Body

result

object

必需

RasterNameValue

array [object {2}]

必需

resultcode

string

必需

示例

单点识别多点识别响应 returnDetail 为false 时，和单点返回结果格式相同，是将所有查询结果合并到同一个RasterNameValue中，没有和查询点详细的对应关系多点识别响应 returnDetail 为true 时，有点和结果详细的对应关系

{
    "result": {
        "RasterNameValue": [
            {
                "name": "4202812017GF2+BJ2+WV2+KS3DOM.img",
                "value": "32,68,47"
            }
        ]
    },
    "resultcode": "success"
}

🟢200多点

🟢200多点详细