NewMapServer REST API

feature接口

URL:	http:// <FeatureServer-URL> / feature
父资源:	FeatureServer

[ 服务说明 ]

feature接口规定了对FeatureServer数据源进行查询的请求参数格式。

[ 参数说明 ]

参数	参数说明
format	参数作用：指定操作结果返回格式取值范围：html \| json \| kml \| kmz \| gml ，该参数默认值为html
layer	参数作用：指定要查询的图层名称参数说明：支持多图层查询，图层名称之间用英文逗号隔开，但是需要注意的是：maxitems参数需要设置为足够大的值，如果值设置过小，返回不了所有所查的图层信息
text	参数作用：查询条件参数说明：该参数只在FeatureServer设置了默认查询字段 <featurename> 时才有效，当text参数非空时，where参数将失去作用，服务器端将采用 <featurename> like '%<text>%'方式组织where参数。
geotype	参数作用：指定空间过滤条件 geo 参数的类型取值范围：point \| bbox \| polygon \| geojson
geo	参数作用：指定空间过滤条件参数说明：该参数根据 geotype 参数指定的格式进行设置，具体说明如下: geotype = point时 geo采用点结构为 x,y 或者 x,y,r 格式的字符串 geotype = bbox时 geo采用矩形范围为 xmin,ymin,xmax,ymax 格式的字符串 geotype = polygon时 geo采用多边形范围为 x1,y1,x2,y2,...xn,yn 格式的字符串 geotype = geojson时 geo采用geojson结构的Geometry对象格式为：{"type":"Polygon","coordinates":[[[105,25],[112,75],[112,23],[105,23],[105,75]]]}
sortmode	参数作用：结果排序方式参数说明： sortmode 0;默认方式，相似度排序 sortmode 1;中心位置远近排序 sortmode 2;配合sortfield 字段升降排序 sortmode 3;某个区域内均匀分布 sortmode 4;首先相似度排序，然后相似度相同的记录集合根据sortfield 字段排序备注：排序方式4，要建立分词库，否则效率很低。
srsin	参数作用：指定geo参数所采用的空间投影参数说明：使用国际惯用的EPSG代码指定，如EPSG:4326
where	参数作用：指定查询的属性过滤条件参数说明：where参数的书写规则如SQL语言的WHERE子句，精确查询使用=号，如 "字段名"='××' ;模糊查询使用LIKE关键字，并使用%号来进行模糊替换，如 "字段名" LIKE '%××%'。由于本软件所有服务均以UTF-8编码为输入输出标准，在进行请求的WHERE值或其他参数中如果含有中文，要预先使用encodeURI类似的函数对中文进行编码。text参数非空时，where参数将失去作用。当layer参数设置为多图层时，图层之间用分号‘;’隔开依次写条件。
srsout	参数作用：指定输出结果的投影信息参数说明：使用国际惯用的EPSG代码指定，如EPSG:4326
fieldsout	参数作用：指定输出结果所需返回的字段属性参数说明：多个字段名称之间采用逗号','分隔，当该参数为空时候将不返回任何属性信息，当参数值为' * '时将返回所有字段信息。当layer参数为多图层时，设置规则如下：图层之间用分号‘;’隔开依次写属性字段，每个图层的返回的字段属性参照前面。如两个图层若均要返回所有字段属性：fieldsout=; 若均返回部分属性：fieldsout=图层1属性1,图层1属性2;图层2属性1,图层2属性2
page	参数作用：分页方式返回结果时，指定页码参数说明：page参数代表分页数，当值为 -1 时不采用分页
maxitems	参数作用：maxitems代表每页所容纳的结果数，参数说明：maxitems参数默认为30,当参数设定值大于150时,将按照150返回结果
maxfeatures	参数作用：maxfeatures代表不采用分页的情况下一次请求返回的结果总数，参数说明：maxfeatures参数默认为200,该参数只有在参数 page = -1 时才有效
georssencoding	参数作用：当指定返回格式为GeoRSS时，该参数用来指定GeoRSS采用的文件格式，参数说明：georssencoding参数默认为GML,支持的可选格式有SIMPLE和GML
rssencoding	参数作用：当指定返回格式为GeoRSS时，该参数用来指定RSS文件采用的文件格式，参数说明：rssencoding参数默认为ATOM,支持的可选格式有ATOM和RSS2
callback	参数作用：Ajax客户端使用JSONP方式进行跨域处理时所指定的回调函数名称参数说明：可选参数，该参数仅在format参数值为json时有效

[ 示例 ]

feature请求接口示例：
http://127.0.0.1:8099/newmap/rest/services/samples/china/FeatureServer/feature?layer=首都和省级行政中心&text=&geotype=bbox&geo=-180,-90,180,90&srsin=EPSG:4326&where="NAME" like '%京%'&srsout=EPSG:4326&fieldsout="NAME"&page=1&maxitems=10&format=json

[ 返回结果 ]

feature操作成功时的返回结果示例：

{
    "header":{
        "totalItemsCount":"2",
        "pageItemsCount":2,
        "pages":1,
        "page":1,
        "maxItemsPerPage":10
    },
    "content":{
        "layername":"首都和省级行政中心",
        "spatialReference":"EPSG:4326",
        "fieldsSet":{
            "featureid":"名称",
            "featurename":"名称",
            "fields":[
                {"name":"名称","type":"string"}
            ]
        },
        "features":{
            "type":"FeatureCollection",
            "features":[
                {"type":"Feature","id":"0","geometry":{"type": "Point", "coordinates": [ 116.380940, 39.923615 ] },"properties":{"名称":"北京"}},
                {"type":"Feature","id":"9","geometry":{ "type": "Point", "coordinates": [ 118.772780, 32.047615 ] },"properties":{"名称":"南京"}}
            ]
        }
    }
}

feature操作失败时的返回结果示例：

{
"exceptionCode":"400",
"exceptionText":"layer参数无效"
}

feature接口

URL:

父资源: