KQGIS服务资源rest地址新设计最终版（20220311）：

1、KQGIS Server、KQGIS Portal 区分，是 “ /rest/services ” 和 “/rest/portals/ ”的区分；
2、整体资源地址小写；
3、而在.md等文档等描述中:
（1）服务名首字母大写；
服务名称如下：NetworkAnalysis、Map、Plotting、Data、Geometry、GeoProcessing、DataFlow、GeoCoding；
（2）方法名首字符小写，而如果两个单词，第二个单词（如fieldBuffer中的Buffer）则大写，也即（驼峰命名法）；
如方法名： bestPath；closestFacility；trace；
4、一体化版本端口号：8699 ；微服务版本端口：9800；
5、其它注明：
（1）资源地址中服务名小写没关系，但是大家C++代码和前端类构造中，还是服务名首字母大写，方法名首字符小写（驼峰命名法）的规范些。
（2）有状态服务资源地址示例：
地图服务：http://127.0.0.1:8699/kqgis/rest/services/{servicename}/map
网络分析服务：http://127.0.0.1:8699/kqgis/rest/services/{servicename}/networkanalysis
http://127.0.0.1:8699/kqgis/rest/services/{servicename}/networkanalysis/bestpath;(资源地址中方法名也是全小写)
标绘服务：http://127.0.0.1:8699/kqgis/rest/services/{servicename}/plotting
数据服务：http://127.0.0.1:8699/kqgis/rest/services/{servicename}/data
（3）无状态服务资源地址示例：
几何服务：http://127.0.0.1:8699/kqgis/rest/services/geometry
地理处理服务：http://127.0.0.1:8699/kqgis/rest/services/geoprocessing
数据流服务：http://127.0.0.1:8699/kqgis/rest/services/dataflow
地理编码服务：http://127.0.0.1:8699/kqgis/rest/services/geocoding
（4）Portal资源地址示例：http://127.0.0.1:8699/kqgis/rest/portals/gateway

常用解析参数说明

颜色参数

颜色参数解析支持字符串格式和json对象格式

字符串格式支持类型如下

"rgba (255, 128, 12, 0.5)"
"#fff"
"#ff0011"
"slateblue"
"blah"
"ffffff"
"hsla(900, 15%, 90%, 0.5)"
"hsla(900, 15%, 90%)"
"hsl(900, 15%, 90%)"
"hsl(900, 0.15, 90%)"  // NOTE: not spec compliant.

json对象格式格式如下

{
    "red":255,
    "green":0,
    "blue":0,
    "alpha":255
}

距离单位参数

字符串支持类型如下

参数	底层对应
Meter	DistanceMeters
Kilometer	DistanceKilometers
Feet	DistanceFeet
NauticalMile	DistanceNauticalMiles
Yard	DistanceYards
Mile	DistanceMiles
Centimeter	DistanceCentimeters
Millimeter	DistanceMillimeters
Degree	DistanceDegrees

面积单位参数

字符串支持类型如下

参数	底层对应
SquareMeter	AreaSquareMeters
SquareKilometer	AreaSquareKilometers
SquareFeet	AreaSquareFeet
SquareYard	AreaSquareYards
SquareMile	AreaSquareMiles
Hectare	AreaHectares
Acre	AreaAcres
SquareNauticalMile	AreaSquareNauticalMiles
SquareDegree	AreaSquareDegrees
SquareCentimeter	AreaSquareCentimeters
SquareMillimeter	AreaSquareMillimeters

Filter 参数说明

查询过滤条件

参数	说明
where	查询条件，使用url编码之后的字符串，例如 PAC=420804 or PAC=420802
geometry	查询几何对象，geojson格式字符串，此参数如果在设置了query_define 中的geometry 参数后，会无效，会被覆盖。需要对字符串进行转义，例如：{ "type": "Polygon", "coordinates": [ [ [ 111.989792031851962, 31.427141945448305 ], [ 111.556656081144411, 30.94937986648603 ], [ 112.147296013927445, 30.639622035070929 ], [ 112.562056500059526, 30.999256127476599 ], [ 111.989792031851962, 31.427141945448305 ] ] ] }
subfields	查询返回的字段，以逗号隔开，例如：PAC,NAME，如果不传或传空返回所有字段
GroupByClause	分组条件，sdk底层支持，传入参数字段名称，多个字段以 , 逗号分割，例如 id,name
OrderByClause	排序条件，sdk底层支持，传入参数字段名称 + desc/asc，多个字段排序使用 , 逗号分割。举例： id desc,name asc
SpatialRel	查询空间判断过滤类型，
limit	限制返回数量，不传时，默认-1，根据`servicetype.xml`决定最大返回条数，比如数据服务的`MaxReturnCount`（其他服务根据需要自己添加）；如果传递的值大于配置的最大返回条数，则使用最大返回条数，否则使用用户设置的值。
Fids	过滤要素id数组,优先级最高
geoSRS	几何的空间参考信息，查询几何空间参考，支持EPSG、WKT、proj4字符串参数，例如epsg类型 EPSG:4490

举例：

{
    "geoSRS": "epsg:4326",
    "subfields": "name,bd09x,bd09y",
    "where": "code1 = '11' OR code1 = '12'",
    "geometry": {\"type\":\"Polygon\",\"coordinates\":[[[116.14155415,39.8467652],[116.14155415,40.05856944],[116.45586301,40.05856944],[116.45586301,39.8467652],[116.14155415,39.8467652]]]},
    "SpatialRel": "Intersects",
    "limit":5
}

几何对象参数说明

几何传参以geojson格式字符串传参，要求进行转义。

type成员的值必须是下面之一："Point"、"MultiPoint"、"LineString"、"MultiLineString"、"Polygon"、"MultPolygon"或"GeometryCollection"。这些值分别对应：点、多点、线、多线、面、多面、几何集合。

举例：

{\"type\":\"Point\",\"coordinates\":[116.14155415,39.8467652]}
{\"type\":\"Point Z\",\"coordinates\":[116.14155415,39.8467652,100]} #带Z坐标
{\"type\":\"Point M\",\"coordinates\":[116.14155415,39.8467652,null,1000]} #带M坐标
{\"type\":\"Point ZM\",\"coordinates\":[116.14155415,39.8467652,100,1000]} #带Z、M坐标

{\"type\":\"MultiPoint\",\"coordinates\":[[116.14155415,39.8467652],[116.14155415,40.05856944]]}
 
{\"type\":\"LineString\",\"coordinates\":[[116.14155415,39.8467652],[116.14155415,40.05856944],[116.45586301,40.05856944],[116.45586301,39.8467652]]}

{\"type\":\"Polygon\",\"coordinates\":[[[116.14155415,39.8467652],[116.14155415,40.05856944],[116.45586301,40.05856944],[116.45586301,39.8467652],[116.14155415,39.8467652]]]}

{\"type\":\"MultiPolygon\",\"coordinates\":[[[[116.14155415,39.8467652],[116.14155415,40.05856944],[116.45586301,40.05856944],[116.45586301,39.8467652],[116.14155415,39.8467652]]]]}
 
{\"type\":\"GeometryCollection\",\"Geometries\": [{\"type\":\"multipolygon\",\"coordinates\": [[[[39538570.904916,3348045.926657],[39541833.722435,3348045.926657],[39541833.722435,3346090.262741 ],[39538570.904916,3346090.262741],[39538570.904916,3348045.926657]]]]},{\"type\":\"multipolygon\",
                \"coordinates\": [[[[39539422.074704,3347671.006632],[39541185.212121,3347671.006632],[39541185.212121,3346576.645476],[39539422.074704,3346576.645476],[39539422.074704,3347671.006632]]]]}]}

空间参考参数说明

空间参考，建议按照命名规范geoSRS，outSRS等

支持EPSG、WKT、proj4字符串参数，例如epsg类型 EPSG:4490

SpatialRel参数说明

字符串	底层对应	意义
Intersects	eKQSpatialRel::KQSpatialRelIntersect	相交
EnvelopeIntersects	eKQSpatialRel::KQSpatialRelEnvelopeIntersect	外接矩形相交
Touches	eKQSpatialRel::KQSpatialRelTouches	相接
Overlaps	eKQSpatialRel::KQSpatialRelOverlaps	覆盖
Crosses	eKQSpatialRel::KQSpatialRelCrosses	穿越
Within	eKQSpatialRel::KQSpatialRelWithin	被包含
Contains	eKQSpatialRel::KQSpatialRelContains	包含
Disjoint	eKQSpatialRel::KQSpatialRelDisjoint	相离
Equals	eKQSpatialRel::KQSpatialRelEquals	相等
InteriorIntersects	eKQSpatialRel::KQSpatialRelInteriorIntersect	内部相交(内部相交 = 相交 - 相接)

operateType参数说明

字符串	底层对应	意义
Intersect	KQTopology::Boolean_Intersect	相交，当源数据是面时，操作数据必须是面；当源数据是线时，操作数据必须是线或者面；当源数据是点时，操作数据可以是点、线、面。
Union	KQTopology::Boolean_Union	联合，源数据和操作数据的几何类型必须都是面。
Erase	KQTopology::Boolean_Erase	擦除，当源数据是面时，操作数据必须是面；当源数据是线时，操作数据必须是线或者面；当源数据是点时，操作数据可以是点、线、面。
Update	KQTopology::Boolean_Update	更新，源数据和操作数据的几何类型必须都是面。
SymmetricalDifference	KQTopology::Boolean_SymmetricalDifference	交集取反，源数据和操作数据的几何类型必须相同。
Clip	KQTopology::Boolean_Clip	裁剪，当源数据是面时，操作数据必须是面；当源数据是线时，操作数据必须是线或者面；当源数据是点时，操作数据可以是点、线、面。
Identity	KQTopology::Boolean_Identity	识别，源数据可以是点、线、面，操作数据必须是面或者几何类型与源数据相同。

outFields参数说明

字符串	底层对应	意义
OnlyID	KQTopology::AttributeInheritance_OnlyID	结果要素属性只记录源要素ID、操作要素ID
FromSource	KQTopology::AttributeInheritance_FromSource	结果要素属性与源要素属性一致
FromOper	KQTopology::AttributeInheritance_FromOper	结果要素属性与操作要素属性一致
All	KQTopology::AttributeInheritance_All	结果要素属性记录源要素属性和操作要素属性

金字塔参数

{
   "origin" :[ // 起算远点
      34.323,
      113.555
   ],
   "bound" : [ // 范围，xmin,ymin,xmax,ymax
      -60.0,
      -20.,
      60.0,
      20.0
   ]
   "tileSize": 256, // 返回瓦片的大小
   "degree2Meter": PI * 6378137 / 18， // 度转米
   "DPI" : 96,
   "levels": [ // int array
   ],
   "scales": [ // double array
   ],
   "resolutions": [ // double array
   ],
}

名称	必填	类型	说明
origin	是	double[]	[x,y] 的数组
bound	是	double[]	[xmin,ymin,xmax,ymax]的数组
degree2Meter	否	double	度转米的大小，默认 PI * 6378137 / 18
tileSize	否	int	瓦片大小，默认256
DPI	否	int	默认96
levels	是	int[]	层级数组
scales	否	double[]	比例尺数组, 此值可以通过分辨率/(0.0254/DPI) 获取
resolutions	是	double[]	分辨率数组

**NOTE：levels, scales, resolution 数组个数需要一致，如果不一致，向最少的对齐。"

8.5 数据源conninfo

8.5数据源conninfo的json串

名称	必填	类型	说明
connecttype	是	string	数据源类型，支持 Folder,RelationalDB_Access,KQSpatialDB,KQPostgisDB,RelationalDB_PostgreSQL,RelationalDB_Kingbase8, RelationalDB_MySql, RelationalDB_SQL,RelationalDB_OCI11,RelationalDB_DM,S57,GDB,GeoJSON,MongoDB
folderpath	条件	string	文件路径，当数据源为文件时有效，数据源类型为Folder。
filepath	条件	string	文件全路径, 当数据源为文件行数据库或文件时有效，数据源类型为Folder,RelationalDB_Access,KQSpatialDB为文件型数据源。
server	条件	string	数据库服务器地址(IP或机器名)
instance	条件	string	数据库实例名或端口
database	条件	string	数据库名称
user	条件	string	数据源用户名
password	条件	string	数据库密码
dataset_name	条件	string	表名
~~dataset_type~~	~~条件~~	~~int or string~~	~~当连接为数据集时（dataset_name设置有效时），此参数必填，否则可能会打开失败。（shp文件会自动设置，可不填）~~ 已废弃不在需要

dataset_type类型对应值，常用矢量要素类对应Dataset_FeatureClass = 9，栅格数据集Dataset_RasterDataset = 2

其他类型参照如下

数据集类型

数据源的连接类型：

关于数据源连接信息的组织

文件夹或shp文件:

// 指定文件夹路径folderpath
{
    "connecttype":"Folder",
    "dataset_name":"aaa.shp",
    "folderpath":"D:/data"
}

// 指定shp文件路径filepath
{
    "connecttype":"Folder",
    "filepath":"D:/data/aaa.shp"
}

关于桌面中目录视图中的数据库连接信息的内容：

对于下面的数据库连接中的举例可能并不太正常，经以参考为准。

苍穹Access库（KQ Access database, eConnectionRelationalDBAccess )

选择文件类型要求为 mdb,accdb 后缀的.

{
    "connecttype":"RelationalDB_Access",
    "filepath":"D:/data/aaa.mdb"
}

苍穹SQL Server数据库(KQ SQL Server database, eConnectionRelationalDBSQL)

{
    "connecttype":"RelationalDB_SQL",
    "server":"127.0.0.1",
    "database":"kanq",
    "user":"sa",
    "password":"******"    
}

苍穹SpatialDB数据库(KQ SpatialDB database, eConnectionKQSpatialDB)

选择文件类型要求为 kqdb 后缀的.

{
    "connecttype":"KQSpatialDB",
    "filepath":"D:/data/aaa/nt2.kqdb"
}

Spatialite数据库(Spatialite database, eConnectionSpatialite)

原生的Spatialite数据库，选择文件类型要求为 db,sqlite 后缀的.

{
    "connecttype":"Spatialite",
    "filepath":"D:/data/aaa/nt2.db"
}

苍穹Oracle数据库(KQ Oracle database, eConnectionRelationalDBOCI11)

{
    "connecttype":"RelationalDB_OCI11",
    "database":"127.0.0.1/orcl",
    "user":"kanq",
    "password":"******"
}

OracleSpatial数据库(OracleSpatial database, eConnectionOracleSpatial)

原生的OracleSpatial数据库

{
    "connecttype":"OracleSpatial",
    "database":"127.0.0.1/orcl",
    "user":"aaa",
    "password":"******"
}

苍穹达梦数据库（KQ DM databse, eConnectionRelationalDBDM)

{
    "connecttype":"RelationalDB_DM",
    "database":"127.0.0.1:5236",
    "user":"kanq",
    "password":"******"
}

苍穹人大金仓数据库ODBC(KQ KingBase database ODBC)

注意这里有 postgis选项

// 无postpis时 : eConnectionRelationalDBKin8
{
    "connecttype":"RelationalDB_Kingbase8",
    "server":"127.0.0.1",
    "instance":"54321",
    "database":"kanqdb",
    "user":"SYSTEM",
    "password":"******"
}

// 有postgis时 : eConnectionKQPostgisDBKin8
{
    "connecttype":"PostgisDB_Kingbase",
    "server":"127.0.0.1",
    "instance":"54321",
    "database":"kanqdb",
    "user":"SYSTEM",
    "password":"******"
}

苍穹瀚高安全数据库ODBC(KQ HighGoEncrypt database ODBC, eConnectionRelationalDBPg)

注意这里有 DBTYPE 选项

{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",
    "instance":"5866",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "HighGoEncrypt"
}

PostGIS数据库（PostGIS database, eConnectionPostgis ）

原生的PostGIS数据库

{
    "connecttype":"Postgis",
    "server":"127.0.0.1",
    "instance":"5432",
    "database":"gis",
    "user":"aaa",
    "password":"******"
}

苍穹MySQL数据库(KQ MySQL databse, eConnectionRelationalDBMySql )

{
    "connecttype":"RelationalDB_MySql",
    "server":"127.0.0.1", 
    "instance":"3306",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******" 
}

GDB数据库(GDB database, eConnectionGDB)

选择后缀为 gdb 的文件

{
    "connecttype":"GDB",
    "filepath":"D:/data/aaa/nt2.gdb"
}

GJB数据库(eConnectionGJB,KQ GJB database)

{
    "connecttype":"GJB",
    "folderpath":"D:/data/aaa"
}

苍穹PostgreSQL数据库（KQ PostgreSQL database)

注意这里有 postgis选项

// 无postpis时 : eConnectionRelationalDBPg
{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",  
    "instance":"5432",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******"   
}

// 有postgis时 : eConnectionKQPostgisDB
{
    "connecttype":"KQPostgisDB",
    "server":"127.0.0.1",  
    "instance":"5432",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******"   
}

苍穹人大金仓数据库

注意这里有 postgis情况, 并且有 DBTYPE 选选项

// 无postpis时 : eConnectionRelationalDBPg
{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",  
    "instance":"54321",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "KES_PG"
}

// 有postgis时 : eConnectionKQPostgisDB
{
    "connecttype":"KQPostgisDB",
    "server":"127.0.0.1",  
    "instance":"54321",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "KES_PG"
}

苍穹瀚高数据库(KQ HighGo database)

注意这里有 postgis情况, 并且有 DBTYPE 选选项

// 无postpis时 : eConnectionRelationalDBPg
{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",  
    "instance":"5866",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "HighGo"
}

// 有postgis时 : eConnectionKQPostgisDB
{
    "connecttype":"KQPostgisDB",
    "server":"127.0.0.1",  
    "instance":"5866",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "HighGo"
}

苍穹神通高斯数据库(KQ GaussDB database)

注意这里有 postgis情况, 并且有 DBTYPE 选选项

// 无postpis时 : eConnectionRelationalDBPg
{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",  
    "instance":"10222",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "GaussDB"
}

// 有postgis时 : eConnectionKQPostgisDB
{
    "connecttype":"KQPostgisDB",
    "server":"127.0.0.1",  
    "instance":"10222",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "GaussDB"
}

苍穹优炫数据库(KQ UXDB database)

注意这里有 postgis情况, 并且有 DBTYPE 选选项

// 无postpis时 : eConnectionRelationalDBPg
{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",  
    "instance":"5432",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "UXDB"
}

// 有postgis时 : eConnectionKQPostgisDB
{
    "connecttype":"KQPostgisDB",
    "server":"127.0.0.1",  
    "instance":"5432",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "UXDB"
}

苍穹亚信数据库(KQ AntDB database)

注意这里有 postgis情况, 并且有 DBTYPE 选选项

// 无postpis时 : eConnectionRelationalDBPg
{
    "connecttype":"RelationalDB_PostgreSQL",
    "server":"127.0.0.1",  
    "instance":"6432",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "AntDB"
}

// 有postgis时 : eConnectionKQPostgisDB
{
    "connecttype":"KQPostgisDB",
    "server":"127.0.0.1",  
    "instance":"6432",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "AntDB"
}

苍穹星环数据库(KQ KunDB database, eConnectionRelationalDBMySql)

注意 DBTYPE 选选项

{
    "connecttype":"RelationalDB_MySql",
    "server":"127.0.0.1", 
    "instance":"3306",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "KunDB"
}

苍穹柏睿数据库(KQ RapidsDB database, eConnectionRelationalDBMySql)

注意有 DBTYPE 选选项

{
    "connecttype":"RelationalDB_MySql",
    "server":"127.0.0.1", 
    "instance":"13306",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "RapidsDB"
}

南大通用数据库(KQ GBase8a database, eConnectionRelationalDBMySql)

注意有 DBTYPE 选选项

{
    "connecttype":"RelationalDB_MySql",
    "server":"127.0.0.1", 
    "instance":"5258",
    "database":"kanqdb",
    "user":"kanq",
    "password":"******",
    "DBTYPE": "GBase8a"
}

ArcSDE SQL Server数据库（eConnectionArcSql）

{
    "connecttype":"ArcSql",
    "database":"sde",
    "instance":"sde:sqlserver:127.0.0.1",
    "password":"******",
    "server":"127.0.0.1",
    "user":"sde"
}

ArcSDE Oracle数据库（eConnectionArcOracle）

{
    "connecttype":"ArcOracle",
    "database":"sde",
    "instance":"sde:oracle11g:arcsde",
    "password":"******",
    "server":"127.0.0.1",
    "user":"sde"
}

ArcSDE PostgreSQL数据库（ eConnectionArcPG ）

{
    "connecttype":"ArcPG",
    "database":"sde",
    "instance":"sde:postgresql:127.0.0.1",
    "password":"******",
    "server":"127.0.0.1",
    "user":"sde"
}

ArcSDE GDB数据库（eConnectionArcGDB）

{
    "connecttype":"ArcGDB",
    "folderpath":"D:/data/aaa.gdb"
}

苍穹MongoDB数据库（KQ MongoDB database, eConnectionMongoDB)

无用户及密码

{
	"CONNECTTYPE": "MongoDB",
	"DATABASE": "cqmongodb46",
	"PASSWORD": "",
	"SERVER": "172.16.3.87",
	"USER": ""
}

有用户及密码

{
	"CONNECTTYPE": "MongoDB",
	"DATABASE": "kanqdb",
	"PASSWORD": "******",
    "server":"127.0.0.1", // 如果要改端口，将端口值跟在ip后面，如127.0.0.1:27028
	"USER": "user1"
}

矢量要素类

{
	"CONNECTTYPE": "RelationalDB_PostgreSQL",
	"DATABASE": "pg_cpp",
	"INSTANCE": "5432",
	"PASSWORD": "******",
	"SERVER": "172.16.1.253",
	"USER": "kanq",
	"dataset_name":"洪山区_行政区_面",
	"dataset_type":9
}

整体示例

以查询要素集请求示例

{
    "request": "QueryFeature",
    "dataset": {
        "connecttype":"Folder",
        "dataset_name":"北京市矢量_百度POI_XZQ.shp",
        "filepath":"D:/KQGIS/湖北shp"
    },
    "filter": {
        "clipGeometry": true,
        "geoSRS": "epsg:4326",
        "subfields": "name,bd09x,bd09y",
        "query_geo": true,
        "where": "code1 = '11' OR code1 = '12'",
        "geometry": "{\"type\":\"Polygon\",\"coordinates\":[[[116.14155415,39.8467652],[116.14155415,40.05856944],[116.45586301,40.05856944],[116.45586301,39.8467652],[116.14155415,39.8467652]]]}",
        "SpatialRel": "Intersects",
        "limit":"5"
    }
}

开发服务插件配置说明

依赖包

1、commontools、ServicePluginBase(服务插件基类)、Common（常用参数解析以及常用工具类）
2、httpd 独立测试的http服务进程，用于加载服务插件，进行测试，此需要vs2015 编译支持，依赖libhv库（hv.dll），需要C++11。如不需要编译可直接使用编译好的程序。

环境配置注意事项

http 配置相关

1、httpd 需要依赖配置文件，对应程序同级目录下的etc目录下httpd.conf文件，主要是对http服务相关配置，如端口、线程数量、日志设置等等；

2、插件加载

http加载插件通过httpd.exe 同目录下的servicesconfig.xml，用于配置加载那些插件，支持多服务插件加载。每个服务插件对应一个service，同时支持多command配置，可参考服务的配置。

dllName 动态库名称

serverName 服务名称用于http请求

command下参数

names 组成http请求的方法部分，如proc

id 保证唯一，这个主要是为了建议kqserver 前端java代理使用，需和服务配置保持一致，测试插件时保证唯一即可。

示例配置如下，常用组成请求地址：http://127.0.0.1:8180/DemoService/proc

<?xml version="1.0" encoding="utf-8"?>
<config> 
    <services> 
        <service serverName="DemoService" dllName="DemoService"> 
            <command id="0x0000420C" remark="Demo服务" commandname="PROC" waittime="60*5" names="proc" isExtentService="true"/> 
        </service>  
    </services> 
</config>

复杂的配置如下

<?xml version="1.0" encoding="utf-8"?>
<config> 
    <services> 
        <service serverName="GeometryServer" dllName="GeometryService"> 
            <command id="0x00004000" remark="图形操作" commandname="GEOMETRY_OPERATOR" waittime="60*5" names="operator" isExtentService="true"/>  
            <command id="0x00004001" remark="坐标投影转换" commandname="PROJECT" waittime="60" names="project" isExtentService="true"/>  
            <command id="0x00004002" remark="计算面积长度" commandname="GEOMETRY_AREALENGTH" waittime="60*5" names="length,area,lengths,areas,areasandlengths" isExtentService="true"/>  
            <command id="0x00004003" remark="缓冲分析" commandname="GEOMETRY_BUFFER" waittime="60*5" names="buffer" isExtentService="true"/>  
            <command id="0x00004004" remark="叠置分析" commandname="GEOMETRY_OVERLAP" waittime="60*5" names="overlap" isExtentService="true"/>  
            <command id="0x00004005" remark="差异分析" commandname="GEOMETRY_DIFFERENCE" waittime="60*5" names="difference" isExtentService="true"/>  
            <command id="0x00004006" remark="导出SHP文件" commandname="EXPORTSHAPE" waittime="60*5" names="exportshp,exportshape" isExtentService="true"/>  
            <command id="0x00004007" remark="投影系统转换" commandname="PROJECTSYSTEM" waittime="60*5" names="projectsystem" isExtentService="true"/>  
            <command id="0x00004008" remark="图形合并" commandname="GEOMETRY_UNION" waittime="60*5" names="union" isExtentService="true"/>  
            <command id="0x00004009" remark="对称差分析" commandname="GEOMETRY_SYMDIFFERENCE" waittime="60*5" names="symdifference" isExtentService="true"/>  
            <command id="0x0000400A" remark="计算图形属性" commandname="GEOMETRY_ATTRIBUTE" waittime="60*5" names="geometryattribute" isExtentService="true"/>  
            <command id="0x0000400B" remark="导出OFD文件" commandname="EXPORTOFD" waittime="60*5" names="exportofd" isExtentService="true"/>  
            <command id="0x00004011" remark="CAD文件解析" commandname="CAPPARSER" waittime="60*5" names="cadparser" isExtentService="true"/>  
            <command id="0x00004101" remark="图形检查" commandname="GEOMETRYCHECK" waittime="60*5" names="GEOMETRYCHECK" isExtentService="true"/> 
        </service>  
        <service serverName="GPService" dllName="GeoProcessingService"> 
            <command id="0x0000420A" remark="GP服务" commandname="PROC" waittime="60*5" names="proc" isExtentService="true"/> 
        </service>  
        <service serverName="VectorCatalogServer" dllName="VectorCatalogService"> 
            <command id="0x00004208" remark="矢量目录服务" commandname="VECTORCATALOGSERVICE" waittime="60*5" names="proc" isExtentService="true"/> 
        </service> 
    </services> 
</config>

连接配置参数

服务端为保持灵活性以及兼容性，对8.5版本的connectinfo 进行了xml配置映射，对应connectTypes.xml文件，如其中没有缺少对应sde插件配置或配置改动或有误，请通知服务端同事进行调整。对于数据源的解析，如有问题调试common工程中解析数据源方法，并修改提交，以便进行逐步完善目前配置如下，

<?xml version="1.0" encoding="UTF-8"?>
<ConnectTypes version="8.5">
    <ConnectionType name="Shapefile" required="filepath" connectType="35" dbType="21" isFile="true" isDir="true"/>
    <ConnectionType name="KqSqlite" required="filepath" connectType="2" dbType="16"/>
    <ConnectionType name="KqOracle" required="dbname,username,password" connectType="3" version="11g" dbType="4"/>
    <ConnectionType name="KqAccess" required="filepath" connectType="4" dbType="6"/>
    <ConnectionType name="KqSqlServer" required="server,instance,dbname,username,password" connectType="5" dbType="5"/>
    <ConnectionType name="KqPostgreSQL" required="server,instance,dbname,username,password" connectType="6" dbType="10"/>
    <ConnectionType name="KqHighgo" required="server,instance,dbname,username,password" connectType="6" dbType="11"/>
    <ConnectionType name="KqMySql" required="server,instance,dbname,username,password" connectType="7" dbType="13"/>
    <ConnectionType name="KqKingbase7" required="server,instance,dbname,username,password" connectType="8" dbType="14"/>
    <ConnectionType name="KqKingbase8" required="server,instance,dbname,username,password" connectType="8" dbType="15"/>
    <ConnectionType name="KqRESTMapService" required="url" connectType="11" dbType="-1"/> 
    <ConnectionType name="ArcRESTMapService" required="url" connectType="12" dbType="-1"/>  
    <ConnectionType name="ArcWMS" required="url" connectType="13" dbType="-1"/>  
    <ConnectionType name="OGCWMS" required="url" connectType="14" dbType="-1"/>  
    <ConnectionType name="TiandituWMTS" required="url" connectType="15" dbType="-1"/>  
    <ConnectionType name="KqTerrainFile" required="url" connectType="16" dbType="-1"/>  
    <ConnectionType name="GoogleEarth" required="url" connectType="17" dbType="-1"/>    
    <ConnectionType name="BingMap" required="url" connectType="18" dbType="-1"/>    
    <ConnectionType name="MapBox" required="url" connectType="19" dbType="-1"/> 
    <ConnectionType name="OpenStreet" required="url" connectType="20" dbType="-1"/> 
    <ConnectionType name="TileOPFile" required="filepath" connectType="21" dbType="-1"/> 
    <ConnectionType name="ArcWMTS" required="url" connectType="22" dbType="-1"/>   
    <ConnectionType name="MongoDB" required="server,instance,dbname" connectType="23" dbType="-1"/>
    <ConnectionType name="ArcAccess" required="filepath" connectType="24" dbType="3"/>
    <ConnectionType name="ArcOracle" required="server,instance,dbname,username,password" connectType="25" dbType="0"/>
    <ConnectionType name="ArcSqlServer" required="server,instance,dbname,username,password" connectType="26" dbType="1"/>
    <ConnectionType name="VCT" required="filepath" connectType="27" dbType="-1"/>
    <ConnectionType name="WMS" required="url" connectType="28" dbType="-1"/>
    <ConnectionType name="WFS" required="url" connectType="29" dbType="-1"/>
    <ConnectionType name="WMTS" required="url" connectType="30" dbType="-1"/>
    <ConnectionType name="PostgisDBKin8" required="server,instance,dbname,username,password" connectType="31" dbType="17"/>
    <ConnectionType name="PostgisDBPg" required="server,instance,dbname,username,password" connectType="32" dbType="17"/>
    <ConnectionType name="Spatialite" required="server,instance,dbname,username,password" connectType="33" dbType="-1"/>
    <ConnectionType name="OracleSpatial" required="server,instance,dbname,username,password" connectType="34" dbType="-1"/>
    <ConnectionType name="Folder" required="filepath" connectType="35" dbType="40"/>
    <ConnectionType name="GDB" required="filepath" connectType="36" dbType="-1"/>
    <ConnectionType name="S57" required="filepath" connectType="37" dbType="-1"/>
    <ConnectionType name="KQSpatialDB" required="filepath" connectType="38" dbType="-1" requireFullPath="true"/>
</ConnectTypes>

开发示例

开发示例请参考demoservice工程，以及代码中的具体注释

功能包含了原CalculatorService功能的简单计算功能；简单的矢量要素集查询功能，用于展示常用参数解析以及json返回的构建等。

对应请求http地址

http://127.0.0.1:8180/DemoService/proc

简单计算加法请求

{
    "request": "Calc",
    "command":"add",
    "A":10,
    "B":5
}

要素集查询请求http body体 json

{
    "request": "QueryFeature",
    "dataset": {
        "connecttype":"Folder",
        "dataset_name":"北京市矢量_百度POI_XZQ.shp",
        "filepath":"D:/KQGIS/湖北shp"
    },
    "filter": {
        "clipGeometry": true,
        "geoSRS": "epsg:4326",
        "subfields": "name,bd09x,bd09y",
        "query_geo": true,
        "where": "code1 = '11' OR code1 = '12'",
        "geometry": "{\"type\":\"Polygon\",\"coordinates\":[[[116.14155415,39.8467652],[116.14155415,40.05856944],[116.45586301,40.05856944],[116.45586301,39.8467652],[116.14155415,39.8467652]]]}",
        "SpatialRel": "Intersects",
        "limit":"5"
    }
}

postman请求配置

附录：通用参数说明

KQGIS服务资源rest地址新设计最终版（20220311）：#

常用解析参数说明#

颜色参数#

距离单位参数#

面积单位参数#

Filter 参数说明#

几何对象参数说明#

空间参考参数说明#

SpatialRel参数说明#

operateType参数说明#

outFields参数说明#

金字塔参数#

8.5 数据源conninfo#

关于数据源连接信息的组织#

整体示例#

开发服务插件配置说明#

依赖包#

环境配置注意事项#

http 配置相关#

连接配置参数#

开发示例#

KQGIS服务资源rest地址新设计最终版（20220311）：

常用解析参数说明

颜色参数

距离单位参数

面积单位参数

Filter 参数说明

几何对象参数说明

空间参考参数说明

SpatialRel参数说明

operateType参数说明

outFields参数说明

金字塔参数

8.5 数据源conninfo

关于数据源连接信息的组织

整体示例

开发服务插件配置说明

依赖包

环境配置注意事项

http 配置相关

连接配置参数

开发示例