statistics接口
URL: |
http:// <SAServer-URL> / statistics |
父资源: |
SAServer |
[ 服务说明 ]
statistics接口用于对SAServer的空间数据源进行统计。
[ 参数说明 ]
参数 | 参数说明 |
---|---|
format |
参数作用:指定操作结果返回格式 取值范围:html | json ,该参数默认值为html |
layers |
参数作用:指定要统计的图层名称 参数说明:statistics接口只能针对单图层进行统计,layer参数只能设置为一个图层名称 |
geo |
参数作用:置分析的空间范围 参数说明: geojson格式 |
srsin |
参数作用:设置分析的空间范围的坐标参考 参数说明:使用国际惯用的EPSG代码指定,如EPSG:4326 |
where |
参数作用:指定属性过滤条件 参数说明:where参数的书写规则如SQL语言的WHERE子句,精确查询使用=号,如 字段名=×× ;模糊查询使用LIKE关键字,并使用%号来进行模糊替换,如 字段名 LIKE '%××% ' 。由于本软件所有服务均以UTF-8编码为输入输出标准,在进行请求的WHERE值或其他参数中如果含有中文,要预先使用encodeURI类似的函数对中文进行编码。 |
groupfield |
参数作用:指定分组字段 参数说明:可选参数,如果设置该参数则对服务处理结果按照分组字段进行分组统计并返回,否则输出结果将不进行分组 |
statfields |
参数作用:指定统计字段 参数说明:使用frequercy模式时,statfields指定要计数的字段名,多个字段使用逗号分隔,如statfields=name1,CLASID,PINYIN;使用summary模式时,其值为字段与计算方法的组合,中间用”|”(竖线)符分隔,多个组合之间使用逗号分隔,如name1|SUM,CLASID|MAX,PINYIN|MIN; 使用spatial模式时,其值为字段与计算方法的组合,中间用”|”(竖线)符分隔,多个组合之间使用逗号分隔,如Geometry|IAREA,Geometry|CAREA |
method |
参数作用:指定统计模式 取值范围:frequency | summary |spatial, 默认值为frequency |
callback |
参数作用:Ajax客户端使用JSONP方式进行跨域处理时所指定的回调函数名称 参数说明:可选参数,该参数仅在format参数值为json时有效 |
[ 示例 ]
feature请求接口示例:
http://127.0.0.1:8099/newmap/rest/services/samples/china/SAServer/statistics?&layers=首都和省级行政中心&geo=&srsin=&where=&groupfield=&statfields=name&method=frequency&format=json
[ 返回结果 ]
{
"statisticsresult":[{
}
"layer":"首都和省级行政中心",
"method":"frequency",
"statresult":[{
] "method":"frequency",
"statresult":[{
"field":"name",
"values":
}"values":
{"上海":1,"乌鲁木齐":1,"兰州":1,"北京":1,"南京":1,"南宁":1,"南昌":1,"台北":1,"合肥":1,"呼和浩特":1,"哈尔滨":1,"天津":1,"太原":1,"广州":1,"成都":1,"拉萨":1,"昆明":1,"杭州":1,"武汉":1,"沈阳":1,"济南":1,"海口":1,"澳门":1,"石家庄":1,"福州":1,"西宁":1,"西安":1,"贵阳":1,"郑州":1,"重庆":1,"银川":1,"长春":1,"长沙":1,"香港":1}}
]