WMS卫星影像接口说明

风云卫星的部分云图按照标准的WMS(Web地图服务)接口提供卫星影像接口服务,根据客户端的请求参数,将相应的卫星影像进行切割拼接和缩放处理,返回给客户端的是一张完整的影像,方便用户程序调用和集成。

本服务包括GetCapabilities和GetMap两个接口,前者基于XML对服务内容和参数进行详细说明,后者对卫星影像进行定制化处理并返回图像。

GetCapabilities请求说明

在调用GetCapabilities请求时,本接口将返回一个包含服务元数据格式的响应,并且该响应基于 WMS标准的XML格式。

GetCapabilities请求参数

GetCapabilities操作的URL请求参数如下表所示:

GetCapabilities操作请求主要参数

请求参数 是否必须 描述
REQUEST=GetCapabilities 请求名称,需要设为“GetCapabilities”。

GetCapabilities请求示例

GetCapabilities操作的请求方式如下:

https://data.nsmc.org.cn/NSMCAPI/v1/nsmc/image/wms/ability?request=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个或多个边界框。包含以下属性:

  • CRS,表明应用于边界框的图层 CRS。
  • minx, miny, maxx, maxy,表明边界框的大小。
  • resx 和 resy(可选),表示空间分辨率。

BoundingBox 元数据指明了图层的坐标范围,而在 GetMap请求中请求参数 BBOX指明了返回图像的区域。

MinScaleDenominator & MaxScaleDenominator

最小最大比例尺倒数,用于表示比例尺范围。

如果两个元素同时不存在,表示没有比例尺限制。

Dimension 适用于多维数据。继承自父图层。
MetadataURL 元数据 URL。不能被子图层继承。提供图层数据详细和标准的元数据。
Attribution

用于定义图层或图层集合的地理信息来源。可以被子图层继承。

  • “OnlineResource”表示数据提供者的 URL。
  • “Title”是数据提供者的名称。
  • “LogoURL”是 Logo 图片的 URL。
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请求参数

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 返回图片的输出格式。

GetMap请求示例

访问MERSI全球影像的URL如下所示:

https://data.nsmc.org.cn/NSMCAPI/v1/nsmc/image/wms/compose?layers=FY3D_MERSI&datetime=20230213&request=GetMap&bbox=50,20,80,44&width=1000&height=800&version=1.0.0&format=jpg

其中日期时间“DATETIME”参数值为“20220801”,代表2022年8月1日(世界时),边界框“BBOX”参数值为“100,10,120,30”,代表经度范围100~120°E、纬度范围10~30°N。

访问全球静止卫星云图的URL如下所示:

https://data.nsmc.org.cn/NSMCAPI/v1/nsmc/image/wms/compose?layers=GEOS_IRX&datetime=202302140200&request=GetMap&bbox=0,0,45,45&width=256&height=256&version=1.1.0&format=png

其中日期时间“DATETIME”参数值为“202208011300”,代表2022年8月1日13时(世界时),边界框“BBOX”参数值为“90,0,135,45”,代表经度范围90~135°E、纬度范围0~45°N。

GetMap返回说明

对于一个合法的 GetMap 请求,服务器将根据请求参数返回一幅图像。

对于一个非法的 GetMap 请求,服务器将返回一幅空白图像。

返回顶部