image

已测完

http://172.16.1.44:9800

POST

/rest/services/{servicename}/image/image

用于获取一幅图片。定制要获取的图片，包括用户显示视窗的大小、地图显示区域的范围、地图的中心点、动态投影的目标投影等，返回一幅地图图片。默认返回的地图图片的格式是 PNG。

支持的表述格式：PNG、BMP、GIF、JPG、WebP。

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法 image

layerName

string

必需

影像集名称，对应CollectionName

center

array[number]

必需

指定地图显示的中心点。[x,y] ，配合scale使用，与viewExtent功能相同，优先级低

scale

number

必需

指定地图显示的比例尺。配合center使用,与viewExtent功能相同，优先级低

imageSize

object ( imageSize参数)

必需

指定用户显示视窗的宽高，即产生图片的宽高

width

integer

必需

height

string

必需

transparent

string

可选

地图图片是否透明。默认false，背景不透明

viewExtent

array[number]

必需

地图窗口显示区域的地理范围，是一个矩形框。如果对地图设置了动态投影，则此参数表示原 viewExtent 在目标投影下所转换成的多边形的外接矩形。[xmin,ymin,xmax,ymax],与scale、center功能相同，优先级高

srs

string

可选

请求的地图的坐标空间参考参数。如未设置，默认采用地图空间参考。当此参数设置的坐标系统不同于地图的原有坐标系统时，系统会进行动态投影，并返回动态投影后的地图图片

dpi

integer

可选

地图显示的dpi，默认值为96

isBoundaryVisible

string

可选

是否显示边界，默认为true

format

string

可选

图片格式，支持PNG、BMP、GIF、JPG、WebP,默认PNG，不区分大小写

visibletype

enum<integer>

可选

影像和边框显示的控制，0.都不显示 1.显示影像 2.显示边框 3.显示影像和边框 4.子集显示默认为3

枚举值:

01234

默认值:

rasterVisible

array[object (VisibleControl对象) {3}]

可选

当visibletype = 4的时候启用子集显示，把需要控制的子集列出来，没有列出来的子集不进行显示

rasterName

string

子影像名称

必需

image

boolean

必需

影像是否显示，true为显示

默认值:

true

footprint

boolean

必需

边框是否显示，true为显示

默认值:

true

renderingRule

object (renderingRule)

可选

用来指定影像显示的风格，包含拉伸显示方式、颜色表、波段组合以及应用栅格函数进行快速处理等。不指定时，使用发布服务时所配置的风格。

displayMode

enum<string>

必需

渲染模式，目前支持MinMax，PercentClip两种模式，分为对应最大最小值拉伸，百分比裁剪拉伸

枚举值:

MinMaxPercentClip

bandIds

array[integer]

必需

影像显示的波段组合。若影像的显示模式为STRETCHED，该属性指定一个波段的索引号(波段索引号从0开始计数)；若影像的显示模式为COMPOSITE，该属性为组合的波段索引号，例如：属性值3,2,1表示采用4波段、3波段、2波段分别对应 R、G、B颜色通道进行组合显示。波段编号从 0 开始。例子[0，1，2]

interpolationMode

integer

必需

影像显示时使用的插值算法，0为最临近，1为双线性，2为三次卷积，默认值为最邻近

noDataColor

object

可选

无效值显示的颜色，也就是无效色，默认为透明色，格式为{ "red": 255, "green": 255, "blue": 255，“alpha”:255}

isUseBackValue

string

可选

是否使用背景值，false为不使用，否则为使用

backgroudValue

array[integer]

可选

单波段影像对应一个值，多波段影像对应三个值，可以为不同的值，例如200，100，250，启用了背景值之后才有作用[200，100，250]

backgroundColor

object (Color)

可选

stdevCoefficient

number

可选

标准差系数，标准差拉伸渲染的时候需要，默认为2.5

默认值:

2.5

minPercent

number

可选

最小的百分比裁剪值，百分比裁剪拉伸的时候需要，默认为0.5

默认值:

0.5

maxPercent

number

可选

最大的百分比裁剪值，百分比裁剪拉伸的时候需要，默认为0.5

默认值:

0.5

brightness

integer

可选

影像显示的亮度。数值范围为-100到100，增加亮度为正，降低亮度为负。

contrast

integer

可选

影像显示的对比度。数值范围为-100到100，增加对比度为正，降低对比度为负。

示例

{
    "request": "image",
    "layerName": "testBackValue",
    "imageSize": {
        "width": 1280,
        "height": 1080
    },
    "scale": 5000,
    "center": [
        39384271.079,
        3236048.935
    ],
    "renderingRule": {
        "displayMode": "MinMax",
        "noDataColor": {
            "red": 255,
            "green": 0,
            "blue": 0,
            "alpha": 255
        },
        "isUseBackValue": "true",
        "backgroudValue": [
            200,
            200,
            200
        ],
        "backgroundColor": {
            "red": 0,
            "green": 255,
            "blue": 0,
            "alpha": 255
        }
    },
    "crs": "EPSG:2363",
    "transparent": "false",
    "format": "PNG"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://172.16.1.44:9800/rest/services//image/image' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": "image",
    "layerName": "testBackValue",
    "imageSize": {
        "width": 1280,
        "height": 1080
    },
    "scale": 5000,
    "center": [
        39384271.079,
        3236048.935
    ],
    "renderingRule": {
        "displayMode": "MinMax",
        "noDataColor": {
            "red": 255,
            "green": 0,
            "blue": 0,
            "alpha": 255
        },
        "isUseBackValue": "true",
        "backgroudValue": [
            200,
            200,
            200
        ],
        "backgroundColor": {
            "red": 0,
            "green": 255,
            "blue": 0,
            "alpha": 255
        }
    },
    "crs": "EPSG:2363",
    "transparent": "false",
    "format": "PNG"
}'

返回响应

🟢200成功

application/octet-stream

Body

object {0}

示例

如果成功直接获取图片，指定格式为 PNG、BMP、GIF、WebP  或 JPG，则返回一幅图片内存

修改于 2023-02-01 08:19:03

kanqmap

tileImage