NOAA ERDDAP
更轻松地获取科学数据
登录 | ?    
提供方: NOAA NMFS SWFSC ERD    

ERDDAP > wms > 文档

ERDDAP的 Web 地图服务 (WMS ) 允许您请求在地图上绘制数据的图像WMS  (external link)是一个开放地理空间联盟( OGC )  (external link)ISO (19128)  (external link)标准用于“创建和显示来自多个远程和异构来源同时发送的已注册和叠加的地图式信息视图”。 See the list of datasets available via WMS at this ERDDAP installation.

使用WMS制作地图的三种方法

  1. 理论上,任何人都可以下载、安装和使用WMS客户端软件。
    一些客户端是: ArcGIS  (外部链接)uDig  (外部链接) 。要使它们工作,您需要在计算机上安装软件。然后,您需要将WMS服务的 URL 输入客户端。例如,在ArcGIS (尚未完全工作,因为它不处理时间!)中,使用“Arc Catalog : Add Service : Arc Catalog Servers Folder : GIS Servers : Add WMS Server”。在ERDDAP中,每个数据集都有自己的WMS服务,位于
    https://coastwatch.pfeg.noaa.gov/erddap/zh-CN /wms/ datasetID / request ?
    例如: https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?
    (某些WMS客户端程序不希望该 URL 末尾有? 。) See the list of datasets available via WMS at this ERDDAP installation.

    实际上,我们还没有发现任何WMS客户端能够正确处理除经度和纬度之外的其他维度(例如时间),而WMS规范指定了此功能, ERDDAP的WMS服务器中的大多数数据集都利用了此功能。您可能会发现,使用数据集的制作图表格式并选择.kml文件类型( OGC标准)将图像加载到Google Earth  (外部链接)中可以提供良好的(非WMS )地图客户端。 See the list of datasets with Make A Graph at this ERDDAP installation.

  2. 网页作者可以在网页中嵌入WMS客户端。
    例如, ERDDAP使用Leaflet  (外部链接) ,这是一个非常通用的WMS客户端,用于每个ERDDAP数据集 (像这样 ) 的WMS页面。 See the list of datasets available via WMS at this ERDDAP installation. Leaflet不会自动处理除经度和纬度之外的其他维度(例如时间),因此您必须编写Java Script(或其他脚本代码)来执行此操作。(有冒险精神的Java Script 程序员可以从网页像这样查看源代码。)

    另一个常用的Java Script WMS客户端是OpenLayers  (外部链接)

  3. 拥有浏览器或计算机程序的人可以生成特殊的WMS URL。
    例如: See the list of datasets available via WMS at this ERDDAP installation.
    请参阅下文详细信息。

    实际上,为此目的使用数据集的制作图表网页比使用WMS更容易、更通用且更高效。
    See the list of datasets with Make A Graph at this ERDDAP installation.

形成GetCapabilities URL

GetCapabilities请求返回一个 XML 文档,该文档提供有关服务的背景信息以及有关此服务中所有可用数据的基本信息。对于此数据集,对于WMS版本 1.3.0,使用
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&request=GetCapabilities&version=1.3.0

GetCapabilities请求支持的参数包括:

名称=值* 描述
service=WMS 必需的。
version =版本 目前, ERDDAP的WMS支持“1.1.0”、“1.1.1”和“1.3.0”。
此参数为可选参数,默认为“1.3.0”。
request=GetCapabilities 必需的。
*参数名称不区分大小写。
参数值区分大小写,并且必须进行百分比编码 (外部链接) :查询值中除 A-Za-z0-9_-!.~'()* 之外的所有字符都必须编码为 %HH,其中 HH 是字符的 2 位十六进制值,例如空格变为 %20。#127 以上的字符必须转换为 UTF-8 字节,然后每个 UTF-8 字节都必须进行百分比编码(请向程序员寻求帮助)。有“网站可以为您进行百分比编码/解码 (外部链接)
参数在 URL 中可以按任意顺序排列,以 '&' 分隔。
 

形成GetMap URL

拥有浏览器或计算机程序的人可以生成一个特殊的 URL 来请求地图。URL 必须采用以下格式
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN /wms/ datasetID / request ?查询
WMS GetMap请求的查询由多个参数名称=值组成,以“&”分隔。例如,
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,jplMURSST41:analysed_sst,Coastlines,Nations&styles=&format=image/png
GetMap请求的参数选项有:
 
名称=值* 描述
service=WMS 必需的。
version =版本 请求版本。目前, ERDDAP的WMS支持“1.1.0”、“1.1.1”和“1.3.0”。必填。
request=GetMap 请求名称。必填。
layers =图层列表 一个或多个地图图层的逗号分隔列表。图层按其在列表中出现的顺序绘制。当前在ERDDAP的WMS中,数据集中的图层名称被命名为datasetID : variableName 。在ERDDAP的WMS中,有五个图层不是基于ERDDAP数据集的:
  • "Land"可能在网格数据集的图层之前(作为底层)或图层之后(作为陆地掩模)绘制。
  • "Coastlines"通常应在网格数据集的图层之后绘制。
  • "LakesAndRivers"绘制湖泊和河流。这通常应该在网格数据集的图层之后绘制。
  • "Nations"绘制国家政治边界。这通常应在网格数据集的图层之后绘制。
  • "States"绘制州政治边界。这通常应在网格数据集的图层之后绘制。
必需的。
styles =样式列表 每个请求图层的渲染样式的逗号分隔列表。当前在ERDDAP的WMS中,每个图层提供的唯一样式是默认样式,通过“”(无)指定。例如,如果您请求 3 个图层,则可以使用“styles=,,”。或者,更简单的是,您可以通过“styles=”请求所有图层的默认样式。必填。
1.1.0:srs=命名空间:标识符
1.1.1: srs=命名空间:标识符
1.3.0:crs=命名空间:标识符
坐标参考系。
目前在ERDDAP的WMS 1.1.0 中,唯一有效的 SRS 是 EPSG:4326。
目前在ERDDAP的WMS 1.1.1 中,唯一有效的 SRS 是 EPSG:4326。
目前在ERDDAP的WMS 1.3.0 中,唯一有效的 CRS 是 CRS:84 和 EPSG:4326,
必需的。
bbox= 4个逗号分隔值 边界框角(以 SRS/CRS 为单位)。对于版本 1.3.0 且 CRS=EPSG:4326,这 4 个值为:minLat、minLon、maxLat、maxLon。对于所有其他情况,这 4 个值为:minLon、minLat、maxLon、maxLat。(相反的顺序!是的,这很奇怪。欢迎来到OGC的世界!) ERDDAP支持数据集经度(可能为 0 到 360,也可能为 -180 到 180)和纬度范围内的请求。大多数WMS客户端假设经度值在 -180 到 180 范围内。如果ERDDAP提供经度为 -180 到 180 的数据集变体,请将其用于WMS请求。必填。
width =输出宽度 地图图片的宽度(以像素为单位)。必填。
height =输出高度 地图图片的高度(以像素为单位)。必填。
format =输出格式 地图的输出格式。目前在ERDDAP的WMS中,只有 image/png 有效。必填。
transparent=TRUE|FALSE 地图背景透明度。可选(默认值 = FALSE )。如果为TRUE ,则使用 BGColor 的任何图像部分都将变为透明。
bgcolor =颜色值 背景颜色的十六进制 0xRRGGBB 颜色值。可选(默认值=0xFFFFFF,白色)。如果 transparent=true,我们建议bgcolor =0x808080(灰色),因为白色在某些调色板中。
exceptions =异常格式 WMS异常响应的格式。可选。
目前, ERDDAP的WMS 1.1.0 和 1.1.1 支持“application/vnd.ogc.se_xml”(默认),
“application/vnd.ogc.se_blank”(空白图像)和“application/vnd.ogc.se_inimage”(图像中的错误)。
目前, ERDDAP的WMS 1.3.0 支持“XML”(默认)、 "BLANK" (空白图像)和
“INIMAGE”(图像中的错误)。
time =时间 所需图层的时间值,以 ISO 8601 格式指定: yyyy-MM-ddTHH:mm:ssZ 。目前在ERDDAP的WMS中,每个请求只能指定一个时间值。
在ERDDAP的WMS中,将使用最接近您指定的值(如果介于最小值和最大值之间)。
在ERDDAP的WMS中,默认值是数据集的一维时间数组中的最后一个值。
在ERDDAP的WMS中,“当前”被解释为最后可用时间(最近或最近)。
可选(在ERDDAP的WMS中,默认是最后一个值,无论它是否是最近的)。
elevation =海拔 所需图层的海拔。当前在ERDDAP的WMS中,每个请求只能指定一个海拔值。
在ERDDAP的WMS中,这用于高度或深度(转换为高度)维度(如果有)。(以米为单位,正数=向上)
在ERDDAP的WMS中,将使用最接近您指定的值(如果介于最小值和最大值之间)。
可选(在ERDDAP的WMS中,默认值是数据集的 1D 高度或深度数组中的最后一个值)。
dim_名称= 适当时指定其他维度的值。目前在ERDDAP的WMS中,每个请求每个维度只能指定一个值。
在ERDDAP的WMS中,这用于非时间、非高度、非深度维度。
维度的名称将是“dim_”加上该维度的数据集的名称,例如“dim_model”。
在ERDDAP的WMS中,将使用最接近您指定的值(如果介于最小值和最大值之间)。
可选(在ERDDAP的WMS中,默认值是维度的 1D 数组中的最后一个值)。
*参数名称不区分大小写。
参数值区分大小写,并且必须进行百分比编码 (外部链接) :查询值中除 A-Za-z0-9_-!.~'()* 之外的所有字符都必须编码为 %HH,其中 HH 是字符的 2 位十六进制值,例如空格变为 %20。#127 以上的字符必须转换为 UTF-8 字节,然后每个 UTF-8 字节都必须进行百分比编码(请程序员帮助)。有些网站会为您进行百分比编码/解码 (外部链接)
参数在 URL 中可以按任意顺序排列,以 '&' 分隔。

(根据WMS 1.3.0 规范表 8 修订)

笔记

Examples

ERDDAP is compatible with the current WMS 1.3.0 standard.

GetCapabilities https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&request=GetCapabilities&version=1.3.0
GetMap
(opaque)
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,jplMURSST41:analysed_sst,Coastlines,Nations&styles=&format=image/png
GetMap
(transparent)
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.3.0&request=GetMap&bbox=-89.99,-179.99,89.99,180.0&time=2002-06-01T09:00:00Z&crs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=jplMURSST41:analysed_sst&styles=&format=image/png&transparent=TRUE
In Leaflet (外部链接) Demo (WMS 1.3.0)

 

ERDDAP is also compatible with the older WMS 1.1.1 standard, which may be needed when working with older client software.

GetCapabilities https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&request=GetCapabilities&version=1.1.1
GetMap
(opaque)
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.1.1&request=GetMap&bbox=-179.99,-89.99,180.0,89.99&time=2002-06-01T09:00:00Z&srs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,jplMURSST41:analysed_sst,Coastlines,Nations&styles=&format=image/png
GetMap
(transparent)
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.1.1&request=GetMap&bbox=-179.99,-89.99,180.0,89.99&time=2002-06-01T09:00:00Z&srs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=jplMURSST41:analysed_sst&styles=&format=image/png&transparent=TRUE
In Leaflet (外部链接) Demo (WMS 1.1.1)

 

ERDDAP is also compatible with the older WMS 1.1.0 standard, which may be needed when working with older client software.

GetCapabilities https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&request=GetCapabilities&version=1.1.0
GetMap
(opaque)
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.1.0&request=GetMap&bbox=-179.99,-89.99,180.0,89.99&time=2002-06-01T09:00:00Z&srs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=Land,jplMURSST41:analysed_sst,Coastlines,Nations&styles=&format=image/png
GetMap
(transparent)
https://coastwatch.pfeg.noaa.gov/erddap/zh-CN/wms/jplMURSST41/request?service=WMS&version=1.1.0&request=GetMap&bbox=-179.99,-89.99,180.0,89.99&time=2002-06-01T09:00:00Z&srs=EPSG:4326&width=360&height=180&bgcolor=0x808080&layers=jplMURSST41:analysed_sst&styles=&format=image/png&transparent=TRUE
In Leaflet (外部链接) Demo (WMS 1.1.0)

 
Translated by Google ?
ERDDAP ,版本2.26
免责声明|隐私政策|联系方式