tileImage

已测完

http://172.16.1.44:9800

POST

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

获取影像集的瓦片图片。默认返回的图片的格式是 PNG。

将出的完整的影像集图片以像素为单位切割成多个相同大小的格网，那么地图就可以由多个小块拼合而成。tileImage 资源表示的就是这些地图的小块，通过该接口服务，可以获取地图（{mapName}）中相应的格网图片，可以设置一些定制输出图片的参数，如设置出图的图层、图片大小、格网行列号、地图是否透明、动态投影的目标投影等。

格网的划分规则如下：将地图全幅显示时的图片从左上角开始，往下和往右进行切割，切割的大小默认为 256*256 像素，左上角的格网行号为 0，列号为 0，往下和往右依次递增。其中，格网的大小和地图的比例尺等参数都可以在请求时进行指定。

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

请求参数

Path 参数

servicename

string

必需

Header 参数

ua_token

string

可选

默认值:

Body 参数application/json

request

string

必需

影像集名称，对应CollectionName。

layerName

string

必需

scale

number

必需

指定地图显示的比例尺。

integer

必需

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

integer

必需

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

origin

object

必需

切片的起始参考点，默认为地图范围的左上角。如果指定为其他值，则以所赋值作为切片的起始参考点，计算切片行列号。如对示范数据中的“世界地图”设置了切片起始点为 origin={"x":-200,"y":45}，则 origin 位于行列号为（0，0）的切片左上角，同时位于行列号为（-1，-1）的切片的右下角。

number

起点x坐标。

必需

number

起点y坐标。

必需

imageSize

object ( imageSize参数)

可选

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

width

integer

必需

height

string

必需

width

integer

可选

图像宽度，和imageSize 功能类似，优先级低于imageSize。

height

integer

可选

图像高度，和imageSize 功能类似，优先级低于imageSize。

srs

string

可选

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

transparent

boolean

可选

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

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

format

string

可选

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

dpi

integer

可选

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

angle

number

可选

示例

{
    "request": "tileImage",
    "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,
    "scale":250000,
    "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/tileimage' \
--header 'ua_token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": "tileImage",
    "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,
    "scale":250000,
    "crs":"EPSG:2362",
    "transparent": false,
    "format":"PNG"
}'

返回响应

🟢200成功

application/octet-stream

Body

object {0}

修改于 2023-02-02 10:00:46

image

zxyTileImage