MapGIS OGC 共享服务使用说明.doc

MapGIS OGC 共享服务使用说明一、引言1、 数据格式需要支持XML、GML、KML和GeoRSS JSON2、 服务的通信协议需要支持http Get/POST、SOAP、REST3、 支持的OGC标准协议有：WMS WFS WCS WMTS WPS WFS-GWMSV1.0.0V1.1.0V1.1.1V1.3.0体系结构：OGC共享服务体系WFSV1.0.0V1.1.0WCSV1.1.2V1.0.0V1.1.0WMTSV1.0.0V0.9.3WPSV1.0.0WFS-G二、网络地图服务（WMS）1、接口说明1、GetCapabilities接口版本接口参数Required/OptionalDescription1.1.0.0GetCapabilitiesVERSION ORequest versionSERVICE=WMS RService typeREQUEST=GetCapabilities R Request nameUPDATESEQUENCE=string OSequence number orstring for cache control2、GetMap接口版本接口参数Required/OptionalDescription1.1.01.1.1GetMapVERSION=version RRequest version REQUEST=GetMap RRequest nameLAYERS=layer_listRComma-separated list of one or more map layers. Optional if SLD parameter is present.STYLES=style_listRComma-separated list of one rendering style perSRS=namespace:identifierCRS （1.3.0）RSpatial Reference System.BBOX=xmin,ymin,xmax,ymaxRBounding box corners (lower left, upper right) inSRS units.WIDTH=output_widthRWidth in pixels of map picture.HEIGHT=output_heightReight in pixels of map picture.FORMAT=output_formatROutput format of map.TRANSPARENT=TRUE|FALSEOBackground transparency of map(default=FALSE).BGCOLOR=color_valueOHexadecimal red-green-blue color value for thebackground color (default=0xFFFFFF).EXCEPTIONS=exception_formatOThe format in which exceptions are to be reportedby the WMS (default=SE_XML).TIME=timeOTime value of layer desired.ELEVATION=elevationOElevation of layer desired.Other sample dimension(s) OValue of other dimensions as appropriate.Vendor-specific parametersOOptional experimental parametersThe following parameters are used only with Web Map Services that support the Styled LayerDescriptor specification10.SLD=styled_layer_descriptor_URL O URL of Styled Layer Descriptor (as defined inSLD Specification).WFS=web_feature_service_URL O URL of Web Feature Service providing features tobe symbolized using SLD.3、GetFeatureInfo版本接口参数Required/OptionalDescription1.1.01.1.1GetFeatureInfoVERSION=versionR Request version.REQUEST=GetFeatureInfoR Request name. RPartial copy of the Map request parameters that generated the map for which information is desired. (BBOX, C WIDTH, HEIGHT)QUERY_LAYERS=layer_list R.Comma-separated list of one or more layers to bequeriedINFO_FORMAT=output_formatOReturn format of feature information (MIME type).FEATURE_COUNT=number ONumber of features about which to return information(default=1)X=pixel_columnI=pixel_column(1.3.0)RX coordinate in pixels of feature (measured fromupper left corner=0)Y=pixel_rowJ=pixel_row(1.3.0)Rupper left corner=0)EXCEPTIONS=exception_formatOThe format in which exceptions are to be reported by the WMS (default=application/vnd.ogc.se_xml).Vendor-specific parametersOOptional experimental parameters.WMS服务支持SOAP协议和HTTP Get 和post协议REST 协议HTTP GET/POST 协议SOAP协议WMS.asmxWMSHandler.ashxWMS 服务2、SOAP服务请求示例1）wms getcapability的请求串:98/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WMSServer?VERSION=1.3.0&REQUEST=GetCapabilities&SERVICE=WMS&FORMAT=&UPDATESEQUENCE=2） wms getmap请求串98/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WMSServer?VERSION=1.3.0&REQUEST=getmap&LAYERS=行政区.WP,中心线,文化教育.WT&STYLES=&CRS=&BBOX=114.1,30.4,114.6,30.8&WIDTH=300&HEIGHT=400&FORMAT=image/gif&TRANSPARENT=true&BGCOLOR=&EXCEPTIONS=&TIME=&ELEVATION=3）wms getfeatureinfo请求串：98/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WMSServer?REQUEST=GetFeatureInfo&SERVICE=WMS&VERSION=1.3.0&BBOX=114.125704740498,30.4584932093614,114.500788705197,30.7085740673183&WIDTH=1180&HEIGHT=650&QUERY_LAYERS=行政区.WP&X=482&Y=271&INFO_FORMAT=xml&FEATURE_COUNT=203、普通REST服务请求示例1）wms getcapability的请求串:98/MapgisOGCWebService/REST/WMSHandler.ashx?VERSION=1.3.0&REQUEST=GetCapabilities&SERVICE=WMS&FORMAT=&UPDATESEQUENCE=3） wms getmap请求串98/MapgisOGCWebService/REST/WMSHandler.ashx?VERSION=1.3.0&REQUEST=getmap&LAYERS=行政区.WP,中心线,文化教育.WT&STYLES=&CRS=&BBOX=114.1,30.4,114.6,30.8&WIDTH=300&HEIGHT=400&FORMAT=image/gif&TRANSPARENT=true&BGCOLOR=&EXCEPTIONS=&TIME=&ELEVATION=3）wms getfeatureinfo请求串：98/MapgisOGCWebService/REST/WMSHandler.ashx?REQUEST=GetFeatureInfo&SERVICE=WMS&VERSION=1.3.0&BBOX=114.125704740498,30.4584932093614,114.500788705197,30.7085740673183&WIDTH=1180&HEIGHT=650&QUERY_LAYERS=行政区.WP&X=482&Y=271&INFO_FORMAT=xml&FEATURE_COUNT=204、基于资源的REST服务请求示例以下示例中：TestData为资源名称，其他参数与OGC标准保持一致。1） GetCapabilities 接口http:/localhost/MapgisOGCWebService/REST/TestData/WMSServer?VERSION=1.3.0&REQUEST=GetCapabilities&SERVICE=WMS&FORMAT=&UPDATESEQUENCE=2)GetMap接口http:/localhost/MapgisOGCWebService/REST/TestData/WMSServer?VERSION=1.3.0&REQUEST=getmap&LAYERS=行政区.WP&STYLES=&CRS=&BBOX=&WIDTH=300&HEIGHT=400&FORMAT=image/gif&TRANSPARENT=true&BGCOLOR=&EXCEPTIONS=&TIME=&ELEVATION=3)GetFeatureInfo接口http:/localhost/MapgisOGCWebService/REST/TestData/WMSServer?REQUEST=GetFeatureInfo&SERVICE=WMS&VERSION=1.3.0&BBOX=114.125704740498,30.4584932093614,114.500788705197,30.7085740673183&WIDTH=1180&HEIGHT=650&QUERY_LAYERS=行政区.WP&X=482&Y=271&INFO_FORMAT=xml&FEATURE_COUNT=20参数说明 INFO_FORMAT：为返回值的类型；目前支持json和text/xml。注:数据信息保存在配置文件中,配置文件在没有指定资源名称的情况下位于服务站点跟目录下的“App_Data”文件夹中，在指定资源名的情况下位于服务站点跟目录下的“App_Data/资源名称”（例如：App_Data/TestData）文件夹中,配置文件名称见web.config中的配置三、网络要素服务（WFS）1、接口说明参数名称不区分大小写1）DescribeFeatureType 接口 接口名称支持版本参数名称必须/可选描述DescribeFeatureType1.0.01.1.0version RTypeName Rservice RRequestRoutputFormat O默认值为XMLSCHEMA2）GetCapabilities 接口接口名称支持版本参数名称必须/可选描述GetCapabilities1.0.01.1.0version Rservice RRequestR3) GetFeature 接口接口名称支持版本参数名称必须/可选描述GetFeature1.0.01.1.0version Rservice RRequestROutputFormatOTypeNameRPropertyNameOFilterO4）Transaction 接口接口名称支持版本参数名称必须/可选描述Transaction1.0.01.1.0version Rservice RRequestROutputFormatOOPERATIONRInsert /Update/Delete之一FeatureRLockFeature 与GetGmlObject未实现2、SOAP服务请求示例1） GetCapabilities接口http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=GetCapabilities2） DescribeFeatureType接口http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=DescribeFeatureType&TypeName=行政区.WP&OutputFormat= xmlschema3） GetFeature接口http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=GetFeature&TypeName=行政区.WP&OutputFormat=&Filter=chinawpID5Lin114.21 30.55114.36 30.66&PropertyName=http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=GetFeature&TypeName=行政区.WP&OutputFormat=&Filter=chinawpID5&PropertyName=4)Transaction 接口添加一个要素：http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=insert&Feature=114.125704740498,30.4584932093614 114.500788705197,30.7085740673183220.01031243157016410.574218647340381东西湖区0114.179248261659,30.7085740673183 114.179265618031,30.7080356675207 114.128670675899,30.5898230333757 114.179248261659,30.7085740673183更新一个要素：http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=update&Feature=114.125704740498,30.4584932093614 114.500788705197,30.70857406731831620.01031243157016410.574218647340381东西湖区0114.23,30.63 114.35,30.47 114.45,30.63 114.23,30.63其中FID应为需要更新的要素的FID删除一个要素：http:/localhost/MapgisOGCWebService/SOAP/OGCWebSvc.asmx/WFSServer?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=delete&Feature=19其中Feature为要删除的要素的FID号，同时删除多个要素时用逗号分隔多个FID值。3、 普通REST服务请求示例1)GetCapabilities接口http:/localhost/MapgisOGCWebService/REST/WFSHandler.ashx?Version=1.1.0&Service=WFS&Request=GetCapabilities2)DescribeFeatureType接口http:/localhost/MapgisOGCWebService/REST/WFSHandler.ashx?Version=1.1.0&Service=WFS&Request=DescribeFeatureType&TypeName=行政区.WP&OutputFormat= xmlschema3)GetFeature接口文化教育.wt 中心线http:/localhost/MapgisOGCWebService/REST/WFSHandler.ashx?Version=1.1.0&Service=WFS&Request=GetFeature&TypeName=行政区.WP&OutputFormat=&Filter=chinawpID5Lin114.21 30.55114.36 30.66&PropertyName=4、 4)Transaction 接口添加一个要素：http:/localhost/MapgisOGCWebService/REST/WFSHandler.ashx?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=insert&Feature=114.125704740498,30.4584932093614 114.500788705197,30.70857406731831620.01031243157016410.574218647340381东西湖区0114.23,30.63 114.35,30.47 114.45,30.63 114.23,30.63更新一个要素：http:/localhost/MapgisOGCWebService/REST/WFSHandler.ashx? Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=update&Feature=114.125704740498,30.4584932093614 114.500788705197,30.70857406731831620.01031243157016410.574218647340381东西湖区0114.23,30.63 114.35,30.47 114.47,30.55 114.45,30.63 114.23,30.63删除一个要素：http:/localhost/MapgisOGCWebService/REST/WFSHandler.ashx?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=delete&Feature=12其中Feature为要删除的要素的FID号，同时删除多个要素时用逗号分隔多个FID值。5、 基于资源的REST服务请求示例以下示例中：TestData为资源名称，其他参数与OGC标准保持一致。1)GetCapabilities接口http:/localhost/MapgisOGCWebService/REST/TestData/WFSServer?Version=1.1.0&Service=WFS&Request=GetCapabilities2)DescribeFeatureType接口http:/localhost/MapgisOGCWebService/REST/TestData/WFSServer?Version=1.1.0&Service=WFS&Request=DescribeFeatureType&TypeName=行政区.WP&OutputFormat= xmlschema3)GetFeature接口http:/localhost/MapgisOGCWebService/REST/TestData/WFSServer?Version=1.1.0&Service=WFS&Request=GetFeature&TypeName=行政区.WP&OutputFormat=&Filter=chinawpID5Lin114.21 30.55114.36 30.66&PropertyName= 4)Transaction 接口添加一个要素：http:/localhost/MapgisOGCWebService/REST/TestData/WFSServer?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=insert&Feature=114.125704740498,30.4584932093614 114.500788705197,30.70857406731831620.01031243157016410.574218647340381东西湖区0114.23,30.63 114.35,30.47 114.45,30.63 114.23,30.63更新一个要素：http:/localhost/MapgisOGCWebService/REST/TestData/WFSServer?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=update&Feature=114.125704740498,30.4584932093614 114.500788705197,30.70857406731831620.01031243157016410.574218647340381东西湖区0114.23,30.63 114.35,30.47 114.47,30.55 114.45,30.63 114.23,30.63删除一个要素：http:/localhost/MapgisOGCWebService/REST/TestData/WFSServer?Version=1.1.0&Service=WFS&Request=Transaction&TypeName=行政区.WP&OPERATION=delete&Feature=12其中Feature为要删除的要素的FID号，同时删除多个要素时用逗号分隔多个FID值。注:数据信息保存在配置文件中,配置文件在没有指定资源名称的情况下位于服务站点跟目录下的“App_Data”文件夹中，在指定资源名的情况下位于服务站点跟目录下的“App_Data/资源名称”（例如：App_Data/TestData）文件夹中,配置文件名称见web.config中的配置 五、网络覆盖服务 (WCS)支持版本为1.0.01、接口说明请求参数必需的/可选的说明REQUEST=GetCapabilitiesR该请求的名称VERSION=versionO该请求的版本SERVICE=WCSR服务程序类型 SECTION=/ or/WCS_Capabilities/Service or/WCS_Capabilities/Capability or/WCS_Capabilities/ContentMetadataOCapabilities文档的返回部分URL 组分说明SERVICE = WCS服务程序类型，必选。VERSION=0.7请求协议版本号，必选REQUEST=DescribeCoverageLayer 请求名称: DescribeCoverageLayer，必选LAYER=layer1,layer2, 用逗号隔开的需要描述的覆盖层列单(用其LayerIDs标识). 可选. 缺省值是所有覆盖层。URL 组分说明SERVICE = WCS服务程序类型，必选。VERSION=0.7请求协议版本，必选。REQUEST=GetCoverage请求名称: GetCoverage，必选。LAYER=LayerID可能获取的覆盖层名称，必选，只能有一个层名不论“层”是为单数或复数。RANGE=Range1, Range2, 在被请求层上定义的一个或多个范围集成分的标识符。当覆盖层只有一个范围集成分时，该元素可省。SRS=srs_identifier在请求中使用的空间参考系，必选。RESPONSE_SRS= srs_identifier响应中使用的空间参考系，可选的；默认值为请求SRS。 BBOX=minx, miny, maxx, maxy , minz, maxz请求边界框（左下角坐标，右上角坐标， Z坐标范围可选）内的子集。这些都在由SRS标识的空间参考系中表示，必选。ELEVATION=elev1,elev2,orELEVATION=min/max/res, 请求对应于指定的高程或高程区段的子集。当使用一个2-D SRS，且被查询的覆盖层具有默认高程时，它是可选的；当使用3-D CRS时，它不可选。TIME=time1,time2, orTIME=min/max/res, 请求对应于确定的时间瞬间或区段的子集。当使用SRS，且被查询层上定义了默认时间时，它是可选的。RANGE:PARAM=min/max/resorRANGE:PARAM=val1,val2, or just PARAM = 通过对包含复合观测量的范围成分RANGE上的参数PARAM进行约束来请求子集。例如：radiance:band=1,5,3 (radiance in bands 1, 5, 3)count:age=0/18 (age distribution under 18 yrs.)当被选的范围成分中该参数存在缺省值时，它是可选的。当覆盖层只有一个范围集成分时，前缀“RANGE:”可省略。WIDTH = w (integer)HEIGHT = h (integer)DEPTH =d (integer)请求一个指定宽度（x），高度（y）和深度（z）（格网点的整数）的格网。对于格网覆盖层而言，这些参数或者RESX，RESY，RESZ是必选的。RESX=x (double)RESY=y (double)RESZ=z (double)对格网覆盖层空间域进行二次抽样到该分辨率（用SRS单位表示）。对于格网覆盖层而言，这些参数或者WIDTH，HEIGHT，DEPTH参数是必须的。SupportedFormats覆盖数据文件的输出格式注: 网络覆盖信息保存在配置文件中,配置文件位于服务站点跟目录下的“App_Data”文件夹中，名称见web.config中的 2、SOAP服务请求示例1）getcapabilities接口http:/localhost/MapgisOGCWebService/SOAP/WCS.asmx/GetCapabilities?request=getcapabilities&service=wcs&Version=1.1.0§ion= 2）DescribeCoverage接口：http:/localhost/MapgisOGC