zxyTileImage

已测完

http://172.16.1.44:9800

POST

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

获取zxy规范的地图格网图片。默认返回的地图图片的格式是 PNG。

将完整的地图图片以像素为单位切割成多个相同大小的格网，那么地图就可以由多个小块拼合而成。zxyTileImage 资源就表示以 ZXY 规范划分的地图的小块。

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

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

处理方法zxyTileImage

layerName

array[string]

可选

图层名称数组，如果不设置，则获取全部图层的信息

integer

地图缩放级别。

必需

integer

必需

格网在地图中列号，从左向右递增。默认情况下，切片从地图最左上角开始，其格网列号为0

integer

必需

格网在地图中行号，从上向下递增。默认情况下，切片从地图最左上角开始，其格网行号为0

imageSize

object ( imageSize参数)

必需

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

width

integer

必需

height

string

必需

transparent

boolean

可选

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

antialias

boolean

可选

是否反锯齿出图。底层是否支持

backgroundColor

object (Color)

可选

地图的背景色，支持#FFFFFFFF格式（通道顺序底层确认，例如ARGB），以及 { "blue": 255, "green": 255, "red": 255，“alpha”:255}

red

integer

红色

必需

green

integer

绿色

必需

blue

integer

蓝色

必需

alpha

integer

Alpha

可选

customParams

可选

format

string

可选

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

dpi

integer

可选

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

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，增加对比度为正，降低对比度为负。

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

示例

{
    "request": "zxyTileImage",
    "layerName":"420281大冶市",
    "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
        }
    },
    "imageSize": {
        "width": 256,
        "height": 256
    },
    "x":1,
    "y":2,
    "z":11,
    "crs":"EPSG:2362",
    "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/zxytileimage' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": "zxyTileImage",
    "layerName":"420281大冶市",
    "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
        }
    },
    "imageSize": {
        "width": 256,
        "height": 256
    },
    "x":1,
    "y":2,
    "z":11,
    "crs":"EPSG:2362",
    "transparent": false,
    "format":"PNG"
}'

返回响应

🟢200成功

application/octet-stream

Body

object {0}

修改于 2023-02-02 09:45:27

tileImage

GetCapabilities