search - kqmicrogo

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法search

collectionName

string

影像集名称

必需

collectionId

string

可选

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

rect

object

必需

使用这个给定矩形范围，xmin,xmax,ymin,ymax对应地理范围的最大最小值，假定几何位于影像服务的空间参考中。

xmin

number

最小X

必需

xmax

number

最大X

必需

ymin

number

最小Y

必需

ymax

number

最大Y

必需

geoSRS

string

必需

rect参数空间参考。

returnIdsOnly

boolean

可选

如果为true，则响应仅包含栅格 ID 数组。否则，响应为栅格集。默认值为false。

虽然栅格集响应中包含的栅格数量存在限制，但 ID 数组响应中返回的栅格 ID 的数量没有限制。客户端可以通过指定returnIdsOnly=true并随后为栅格 ID 的子集请求栅格集来利用这一点来获取所有符合查询的栅格 ID。

rasterIds

array[string]

可选

示例：geometryPrecision=[3]要查询的栅格的对象 ID。指定此参数时，将忽略任何其他过滤器参数。
指定该参数时，returnIdsOnly设置为true无效。

pixelSize

object (pixelSize参数)

可选

查询给定像素大小的可见栅格。

x

number

必需

x表示x方向(横向)像素分辨率

y

number

必需

y表示y方向(纵向)像素分辨率

time

object

可选

要查询的时刻或时间范围。

示例

{
	"request":"search",
    "collectionName":"420281大冶市",
    "rect":{
        "xmin":38589551.9435897395,
        "xmax":38595999.5351170525,
        "ymin":3325611.7702327026,
        "ymax":3332651.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/search' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
	"request":"search",
    "collectionName":"420281大冶市",
    "rect":{
        "xmin":38589551.9435897395,
        "xmax":38595999.5351170525,
        "ymin":3325611.7702327026,
        "ymax":3332651.4875125242
    },
    "geoSRS":"EPSG:2362"
}'

返回响应

🟢200成功

application/json

Body

result

object

必需

rasternames

array[string]

必需

resultcode

string

必需

示例

{
    "result": {
        "RasterName": [
            {
                "name": "4202812017GF2+BJ2+WV2+KS3DOM.img"
            }
        ]
    },
    "resultcode": "success"
}