# WMS 1.3.0
WMS提供如下操作:
GetCapabitities：返回服务级元数据，它是对服务信息内容和要求参数的一种描述。
GetMap：返回一个地图影像，其地理空间参考和大小参数是明确定义了的。
GetFeatureInfo：返回显示在地图上的某些特殊要素的信息。
参照文档:
06-042_OpenGIS_Web_Map_Service_WMS_Implementation_Specification.pdf(https://portal.ogc.org/files/?artifact_id=14416)
# GetCapabitities
# 请求
请求参数
| 参数名称 | 是否必填 | 描述 |
|---|---|---|
| VERSION=version | 否 | 请求版本号，必须是1.3.0。 |
| SERVICE=WMS | 是 | 服务类型，必须是WMS。 |
| REQUEST=GetCapabilities | 是 | 请求名称，必须是GetCapabilities。 |
| FORMAT=MIME_type | 否 | 服务元数据信息的输出格式，默认是text/xml，其它格式可选，必须是完整的MIME类型，IGServer暂不支持该参数。 |
| UPDATESEQUENCE=string | 否 | 控制缓存的序列号，当返回结果有变更时该序号递增，IGServer暂不支持该参数。 |
请求示例
{{server}}/igs/rest/services/:serverName/WMSServer?version=1.3.0&service=WMS&request=GetCapabilities
1
# 响应
响应示例
<?xml version='1.0' encoding='utf-8'?>
<WMS_Capabilities xmlns="http://www.opengis.net/wms" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wms http://localhost:8089/igs/rest/ogc/schemas/wms/1.3.0/capabilities_1_3_0.xsd" version="1.3.0">
<Service>
<Name>OGC:WMS</Name>
<Title>Zondy Company Map Server</Title>
<Abstract>WMT Map Server maintained by Zondy Corporation. Contact: mapgis@public.wh.hb.cn</Abstract>
<KeywordList>
<Keyword>MapGIS</Keyword>
<Keyword>DCS</Keyword>
<Keyword>WMS</Keyword>
</KeywordList>
<OnlineResource xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://localhost:8089/igs/rest/services/beijing_w17_test/WMSServer"/>
<ContactInformation>
<ContactPersonPrimary>
<ContactPerson>吴信才</ContactPerson>
<ContactOrganization>武汉中地数码科技有限公司</ContactOrganization>
</ContactPersonPrimary>
<ContactPosition>集团董事长</ContactPosition>
<ContactAddress>
<AddressType>mail</AddressType>
<Address>湖北省武汉市光谷软件园A10</Address>
<City>Wuhan</City>
<StateOrProvince>Hubei</StateOrProvince>
<PostCode>430074</PostCode>
<Country>China</Country>
</ContactAddress>
<ContactVoiceTelephone>027-87785588</ContactVoiceTelephone>
<ContactFacsimileTelephone>027-87785588</ContactFacsimileTelephone>
<ContactElectronicMailAddress>mapgis@public.wh.hb.cn</ContactElectronicMailAddress>
</ContactInformation>
<Fees>none</Fees>
<AccessConstraints>none</AccessConstraints>
<MaxWidth>2048</MaxWidth>
<MaxHeight>2048</MaxHeight>
</Service>
<Capability>
<Request>
<GetCapabilities>
<Format>text/xml</Format>
<DCPType>
<HTTP>
<Get>
<OnlineResource xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://localhost:8089/igs/rest/services/beijing_w17_test/WMSServer?SERVICE=WMS&"/>
</Get>
<Post>
<OnlineResource xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://localhost:8089/igs/rest/services/beijing_w17_test/WMSServer?SERVICE=WMS&"/>
</Post>
</HTTP>
</DCPType>
</GetCapabilities>
<GetMap>
<Format>image/gif</Format>
<Format>image/jpg</Format>
<Format>image/png</Format>
<DCPType>
<HTTP>
<Get>
<OnlineResource xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://localhost:8089/igs/rest/services/beijing_w17_test/WMSServer?SERVICE=WMS&"/>
</Get>
</HTTP>
</DCPType>
</GetMap>
<GetFeatureInfo>
<Format>application/vnd.ogc.gml</Format>
<Format>text/html</Format>
<Format>text/plain</Format>
<Format>application/json</Format>
<DCPType>
<HTTP>
<Get>
<OnlineResource xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://localhost:8089/igs/rest/services/beijing_w17_test/WMSServer?SERVICE=WMS&"/>
</Get>
</HTTP>
</DCPType>
</GetFeatureInfo>
</Request>
<Exception>
<Format>BLANK</Format>
<Format>XML</Format>
<Format>INIMAGE</Format>
</Exception>
<Layer>
<Title>beijing_w17_test</Title>
<Abstract>A compliant implementation of WMS</Abstract>
<CRS>EPSG:4326</CRS>
<CRS>EPSG:3857</CRS>
<EX_GeographicBoundingBox>
<westBoundLongitude>115.40448659815915</westBoundLongitude>
<eastBoundLongitude>117.46520008794508</eastBoundLongitude>
<southBoundLatitude>39.41781726044531</southBoundLatitude>
<northBoundLatitude>41.05780257931024</northBoundLatitude>
</EX_GeographicBoundingBox>
<BoundingBox minx="39.41781726044531" miny="115.40448659815915" maxx="41.05780257931024" maxy="117.46520008794508" CRS="EPSG:4326"/>
<BoundingBox minx="1.2846768683366247E7" miny="4781698.251970508" maxx="1.3076166259720044E7" maxy="5020871.273225116" CRS="EPSG:3857"/>
<Layer queryable="1">
<Name>beijing_w17_test:t0</Name>
<Title>beijing_w17_test:北京市</Title>
<Abstract></Abstract>
<CRS>EPSG:4326</CRS>
<CRS>EPSG:3857</CRS>
<EX_GeographicBoundingBox>
<westBoundLongitude>115.40448659815915</westBoundLongitude>
<eastBoundLongitude>117.46520008794508</eastBoundLongitude>
<southBoundLatitude>39.41781726044531</southBoundLatitude>
<northBoundLatitude>41.05780257931024</northBoundLatitude>
</EX_GeographicBoundingBox>
<BoundingBox minx="39.41781726044531" miny="115.40448659815915" maxx="41.05780257931024" maxy="117.46520008794508" CRS="EPSG:4326"/>
<BoundingBox minx="1.2846768683366247E7" miny="4781698.251970508" maxx="1.3076166259720044E7" maxy="5020871.273225116" CRS="EPSG:3857"/>
</Layer>
<Layer queryable="1">
<Name>beijing_w17_test:t1</Name>
<Title>beijing_w17_test:绿地_1</Title>
<Abstract></Abstract>
<CRS>EPSG:4326</CRS>
<CRS>EPSG:3857</CRS>
<EX_GeographicBoundingBox>
<westBoundLongitude>115.6942631</westBoundLongitude>
<eastBoundLongitude>116.8830574</eastBoundLongitude>
<southBoundLatitude>39.6979361</southBoundLatitude>
<northBoundLatitude>40.5512486</northBoundLatitude>
</EX_GeographicBoundingBox>
<BoundingBox minx="39.6979361" miny="115.6942631" maxx="40.5512486" maxy="116.8830574" CRS="EPSG:4326"/>
<BoundingBox minx="1.2879026455995021E7" miny="4822143.779443616" maxx="1.301136243212897E7" maxy="4946374.57330774" CRS="EPSG:3857"/>
</Layer>
<Layer queryable="1">
<Name>beijing_w17_test:t2</Name>
<Title>beijing_w17_test:绿地_2</Title>
<Abstract></Abstract>
<CRS>EPSG:4326</CRS>
<CRS>EPSG:3857</CRS>
<EX_GeographicBoundingBox>
<westBoundLongitude>115.6942631</westBoundLongitude>
<eastBoundLongitude>117.0179376</eastBoundLongitude>
<southBoundLatitude>39.6979361</southBoundLatitude>
<northBoundLatitude>40.5512486</northBoundLatitude>
</EX_GeographicBoundingBox>
<BoundingBox minx="39.6979361" miny="115.6942631" maxx="40.5512486" maxy="117.0179376" CRS="EPSG:4326"/>
<BoundingBox minx="1.2879026455995021E7" miny="4822143.779443616" maxx="1.3026377227311065E7" maxy="4946374.57330774" CRS="EPSG:3857"/>
</Layer>
<Layer queryable="1">
<Name>beijing_w17_test:t3</Name>
<Title>beijing_w17_test:绿地_3</Title>
<Abstract></Abstract>
<CRS>EPSG:4326</CRS>
<CRS>EPSG:3857</CRS>
<EX_GeographicBoundingBox>
<westBoundLongitude>115.8147476</westBoundLongitude>
<eastBoundLongitude>117.4187314</eastBoundLongitude>
<southBoundLatitude>39.4529452</southBoundLatitude>
<northBoundLatitude>40.8621987</northBoundLatitude>
</EX_GeographicBoundingBox>
<BoundingBox minx="39.4529452" miny="115.8147476" maxx="40.8621987" maxy="117.4187314" CRS="EPSG:4326"/>
<BoundingBox minx="1.2892438729183504E7" miny="4786761.329183959" maxx="1.3070993389040168E7" maxy="4992037.2019703295" CRS="EPSG:3857"/>
</Layer>
</Layer>
</Capability>
</WMS_Capabilities>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
# GetMap
# 请求
请求参数
| 参数名称 | 是否必填 | 描述 |
|---|---|---|
| VERSION=1.3.0 | 是 | 请求版本号，必须是1.3.0。 |
| REQUEST=GetMap | 是 | 请求名称，必须是GetMap。 |
| LAYERS=layer_list | 是 | 地图图层列表。 地图图层之间以半角英文逗号进行分隔。最左边的图层在最 底，下一个图层放到前一个的上面，依次类推。 图层名称是服务元数据中的Layer—>Name元素中的内容。 服务元数据中的可选元素指定了能够请求的最大图层个数。 |
| STYLES=style_list | 是 | 请求图层的样式列表，图层样式之间以英文逗号分隔。 STYLES 值与 LAYERS 参数值是一一对应的。图层名称是服务元数据中定义的元素值。 如果请求不存在的 Style，服务器将返回一个 服务异常（code=StyleNotDefined）。 |
| CRS=namespace:identifier | 是 | 坐标参考系。 该参数值应该是 GetCapabilities 操作中服务器声明的 CRS。 如果请求包含了一个服务器不支持的 CRS，服务器将抛出一个服务异常（code = "InvalidCRS"）。 |
| BBOX=minx,miny,maxx,maxy | 是 | 边界框。 如果WMS的版本是1.3.0且参考系采用的是EPSG系统，则客户端传入的坐标点是纬经度的形式，在交给服务器处理时需要变成经纬度的形式。 |
| WIDTH=output_width | 是 | 地图图片的像素宽度。 |
| HEIGHT=output_height | 是 | 地图图片的像素高度。 |
| FORMAT=output_format | 是 | 地图的输出格式。 服务元数据中的 GetMap 中的 Format 之一。 |
| TRANSPARENT=TRUE|FALSE | 否 | 地图的背景是否透明，默认为FALSE。 |
| BGCOLOR=color_value | 否 | 背景色的十六进制红绿蓝颜色值（默认为 0xFFFFFF）。 |
| EXCEPTIONS=exception_format | 否 | WMS 的异常错误报告格式（默认为 XML）。 服务元数据中的 Exception 之一。 |
| TIME=time | 否 | 获取图层的时间值，IGServer暂不支持该参数。 |
| ELEVATION=elevation | 否 | 获取的图层的高程，IGServer暂不支持该参数。 |
| Other sample dimension(s) | 否 | 其他合适的维度值，IGServer暂不支持该参数。 |
请求示例
{{server}}/igs/rest/services/:serverName/WMSServer?layers=t0&version=1.3.0&crs=EPSG:4326&service=WMS&request=GetMap&format=image/png&bbox=-90,-180,90,180&width=512&height=256
1
# 响应
响应示例
# GetFeatureInfo
# 请求
请求参数
| 参数名称 | 是否必填 | 描述 |
|---|---|---|
| VERSION=1.3.0 | 是 | 请求版本号，必须是1.3.0。 |
| REQUEST=GetFeatureInfo | 是 | 请求名称，必须是GetFeatureInfo。 |
| LAYERS=layer_list | 是 | 地图图层列表。 地图图层之间以半角英文逗号进行分隔。最左边的图层在最 底，下一个图层放到前一个的上面，依次类推。 图层名称是服务元数据中的Layer—>Name元素中的内容。 服务元数据中的可选元素指定了能够请求的最大图层个数。 |
| STYLES=style_list | 是 | 请求图层的样式列表，图层样式之间以英文逗号分隔。 STYLES 值与 LAYERS 参数值是一一对应的。图层名称是服务元数据中定义的元素值。 如果请求不存在的 Style，服务器将返回一个 服务异常（code=StyleNotDefined）。 |
| CRS=namespace:identifier | 是 | 坐标参考系 该参数值应该是 GetCapabilities 操作中服务器声明的 CRS。 如果请求包含了一个服务器不支持的 CRS，服务器将抛出一个服务异常（code = "InvalidCRS"）。 |
| BBOX=minx,miny,maxx,maxy | 是 | 边界框。 如果WMS的版本是1.3.0且参考系采用的是EPSG系统，则客户端传入的坐标点是纬经度的形式，在交给服务器处理时需要变成经纬度的形式。 |
| WIDTH=output_width | 是 | 地图图片的像素宽度。 |
| HEIGHT=output_height | 是 | 地图图片的像素高度。 |
| TIME=time | 否 | 获取图层的时间值，IGServer暂不支持该参数。 |
| ELEVATION=elevation | 否 | 获取的图层的高程，IGServer暂不支持该参数。 |
| QUERY_LAYERS=layer_list | 是 | 待查询的图层列表，图层之间以英文逗号分隔，IGServer暂不支持该参数。 |
| INFO_FORMAT=output_format | 是 | 要素信息的返回格式（MIME 类型）。 |
| FEATURE_COUNT=number | 否 | 返回要素数量（默认为1）。 |
| I=pixel_column | 是 | 像素表示的要素 X 坐标（最左侧为0，向右递增）。 |
| J=pixel_row | 是 | 像素表示的要素 Y 坐标（最上侧为0，向下递增）。 |
| EXCEPTIONS=exception_format | 否 | WMS 的异常错误报告格式（默认为 application/vnd.ogc.se_xml）。 |
请求示例
{{server}}/igs/rest/services/:serverName/WMSServer?layers=t0&version=1.3.0&crs=EPSG:4326&service=WMS&request=GetFeatureInfo&format=image/png&bbox=-90,-180,90,180&width=512&height=256&query_layers=t0&info_format=text/html&i=85&j=43&x=0&y=0
1
# 响应
响应示例
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>ZDOGCServer GetFeatureInfo Output</title>
</head>
<style type="text/css">table.featureInfo, table.featureInfo td, table.featureInfo th {border:1px solid #ddd;border-collapse:collapse;margin:0;padding:0;font-size: 90%;padding:.2em .1em;}table.featureInfo th {padding:.2em .2em;font-weight:bold;background:#eee;text-align:center; }table.featureInfo td{ background:#fff;text-align:center;}table.featureInfo tr.odd td{background:#eee;}table.featureInfo
caption{text-align:left;font-size:100%;font-weight:bold;text-transform:uppercase;padding:.2em .2em; }</style>
<body>
<div align="left">
<table class="featureInfo">
<th colspan="10">图层名称：t0</th>
<tr>
<td>ID</td>
<td>mpArea</td>
<td>mpPerimeter</td>
<td>WRLD30_ID</td>
<td>SQKM</td>
<td>SQMI</td>
<td>COLOR_MAP</td>
<td>POP_1994</td>
<td>COLOR_INDEX</td>
<td>mpLayer</td>
</tr>
<tr>
<td>264</td>
<td>1264.454883790575</td>
<td>591.919791231547</td>
<td>0</td>
<td>9901803.0</td>
<td>3823086.25</td>
<td>1</td>
<td>2.840232E+7</td>
<td>0</td>
<td>1</td>
</tr>
</table>
</div>
</body>
</html>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39