风云卫星的部分云图按照标准的WMS(Web地图服务)接口提供卫星影像接口服务,根据客户端的请求参数,将相应的卫星影像进行切割拼接和缩放处理,返回给客户端的是一张完整的影像,方便用户程序调用和集成。
本服务包括GetCapabilities和GetMap两个接口,前者基于XML对服务内容和参数进行详细说明,后者对卫星影像进行定制化处理并返回图像。
在调用GetCapabilities请求时,本接口将返回一个包含服务元数据格式的响应,并且该响应基于 WMS标准的XML格式。
GetCapabilities操作的URL请求参数如下表所示:
GetCapabilities操作请求主要参数
请求参数 | 是否必须 | 描述 |
---|---|---|
REQUEST=GetCapabilities | 是 | 请求名称,需要设为“GetCapabilities”。 |
GetCapabilities操作的请求方式如下:
采用请求示例中的URL访问 GetCapabilities后,返回一段XML,主要包含“Service”和“Capability”两个组成部分。
“Service”中的内容是对服务通用元数据的一个整体描述,其中包含的元素说明如下:
Service通用服务元数据的元素说明
元素名称 | 描述 |
---|---|
Name | WMS服务的名称。 |
Title | 服务的简短描述。 |
Abstract | 有关服务的更多描述信息。 |
OnlineResource | 服务的网站参考。 |
KeywordList | Keyword | 关键字。 |
ContactInformation | 联系信息。 |
LayerLimit | 图层限制个数。该元素值是一个正整数,表示允许客户端在单个GetMap请求中能够请求的最大图层个数。 |
MaxWidth & MaxHeight | 最大宽度和高度。这两个元素的值是正整数,表示允许客户端在单个GetMap请求中能够请求的图片的最大宽度和高度。如果任意一个值没有,服务器将默认为没有限制。 |
Fees | 费用。“none”(不区分大小写)表示免费。 |
AccessConstraints | 访问限制。“none”(不区分大小写)表示没有访问限制。该元素的内容没有准确的语法定义,客户端可以显示用户信息和行为内容。 |
“Capability”中的内容包括“Request”请求信息和“Layer”图层信息两部分。
——“Request”请求信息包含了服务所支持的请求(GetCapabilities、GetMap 或 GetFeatureInfo),每一种操作的输出格式,以及每一个操作的 URL 前缀。
——“Layer”图层信息包括元素属性和元素内容,分别如下两表所示。
Layer图层元素内容说明
元素名称 | 是否必须 | 描述 |
---|---|---|
Title | 是 | 图层标题。不能被子图层继承。 |
Name | 否 |
图层名称。不能被子图层继承。 在 GetMap请求中,使用 Name 作为 LAYERS 参数的值。 |
Abstract | 否 | 图层摘要。提供有关图层的更加详细的描述。不能被子图层继承。 |
KeywordList | 否 | 关键字列表。不能被子图层继承。 |
Style | 否 |
图层风格。 0个或多个“Style”用来表示单个图层或者图层集合的风格。每一个 Style 包含“Name”和“Title”元素。Name 用于设置 GetMap 请求中的 STYLES 参数。 Style 还可能包含其他一些元素。“Abstract”提供了风格的描述,“LegendURL”包含了图例的图片位置。 LegendURL 中的“Format”元素表示图例图片的 MIME 类型,“Format”元素的 width 和 height 属性表示图片的像素大小。 Style 可以被子图层继承,如果子图层的 Name 和父图层一样,则子图层将不会重新定义 Style。 |
EX_GeographicBoundingBox | 否 |
地理边界框。可以继承自父图层。 每一个命名的图层将包含一个“EX_GeographicBoundingBox”元素,表示图层覆盖的最小边界矩形区域,以十进制的度数表示。 EX_GeographicBoundingBox 有利于在没有坐标转换时的地理搜索。 该元素通过 westBoundLongitude、eastBoundLongitude、southBoundLatitude 和 northBoundLatitude 组成。 |
CRS | 是 |
坐标参考系统(Coordinate Reference System)。可以被子图层继承。 每一个图层有一个或多个 CRS。 CRS 根元素包含0个或多个 CRS 元素,列举了通用于所有子图层的 CRS。 |
BoundingBox | 是 |
边界框。可以继承自父图层。 一个图层包含1个或多个边界框。包含以下属性:
BoundingBox 元数据指明了图层的坐标范围,而在 GetMap请求中请求参数 BBOX指明了返回图像的区域。 |
MinScaleDenominator & MaxScaleDenominator | 否 |
最小最大比例尺倒数,用于表示比例尺范围。 如果两个元素同时不存在,表示没有比例尺限制。 |
Dimension | 否 | 适用于多维数据。继承自父图层。 |
MetadataURL | 否 | 元数据 URL。不能被子图层继承。提供图层数据详细和标准的元数据。 |
Attribution | 否 |
用于定义图层或图层集合的地理信息来源。可以被子图层继承。
|
Identifier & AuthorityURL | 否 | 使用0个或多个“Identifier”列举 Authority 定义的 ID 号或者标签。 |
FeatureListURL | 否 | 要素 URL 列表。 |
DataURL | 否 | 提供了图层相关的数据的链接。不能被子图层继承。 |
Layer图层元素属性说明
属性 | 允许的值 | 含义(默认值为0) |
---|---|---|
queryable | 0,false,1,true |
0,false:图层不可查。 1,true:图层可查。 |
cascaded | 0,正整数 |
0:图层还没有被层叠 Map 服务器(Cascading Map Server)转发。 n:图层已经被转发 n 次。 |
opaque | 0,false,1,true |
0,false:返回的图像不是完全不透明。 1,true:返回的图像完全不透明。 |
noSubsets | 0,false,1,true |
0,false:可以绘制一个完整边界框的子集。 1,true:只绘制完整边界框。 |
fixedWidth | 0,正整数 |
0:可以生成一个任意宽度的图像。 非0:返回图像的宽度固定,不能修改。 |
fixedHeight | 0,正整数 |
0:可以生成一个任意高度的图像。 非0:返回图像的高度固定,不能修改。 |
GetMap 操作的请求参数如下表所示:
GetMap 操作请求参数
请求参数 | 是否必须 | 描述 |
---|---|---|
VERSION | 是 | 请求版本号。当前为1.3.0 |
REQUEST | 是 | 请求名称。需要设为“GetMap”。 |
LAYERS | 是 | 图层列表。通过 GetCapability请求 获取,例如:FY3D_MERSI或GEOS_IRX。 |
DATETIME | 是 | 希望获取图层的时间值(世界时)。时次产品以YYYYMMDDhhmm的格式,日产品以YYYYMMDD的格式。 |
BBOX | 是 | 边界框。 表示请求返回图像的范围,该参数的值为半角英文逗号分隔的一串实数,形如“minx,miny,maxx,maxy”,分别代表指定 CRS 下的区域坐标最小 X、最小 Y、最大 X、最大 Y。 如果请求包含一个非法的 BBOX,比如最小 X 大于或等于最大 X,或者最小 Y 大于或等于最大 Y 等情况,服务器将抛出一个服务异常。 如果请求的 BBOX 所表示范围跟服务元数据中的 “BoundingBox”没有重叠,服务器将返回一个空的内容(一幅空白图)。 |
WIDTH | 是 | 返回图片的像素宽度。 |
HEIGHT | 是 | 返回图片的像素高度。 |
FORMAT | 是 | 返回图片的输出格式。 |
访问MERSI全球影像的URL如下所示:
其中日期时间“DATETIME”参数值为“20220801”,代表2022年8月1日(世界时),边界框“BBOX”参数值为“100,10,120,30”,代表经度范围100~120°E、纬度范围10~30°N。
访问全球静止卫星云图的URL如下所示:
其中日期时间“DATETIME”参数值为“202208011300”,代表2022年8月1日13时(世界时),边界框“BBOX”参数值为“90,0,135,45”,代表经度范围90~135°E、纬度范围0~45°N。
对于一个合法的 GetMap 请求,服务器将根据请求参数返回一幅图像。
对于一个非法的 GetMap 请求,服务器将返回一幅空白图像。