iServer 9D(2019) 接口变更

发送反馈

Java API 变更

包 类/接口 字段/方法/属性/事件 备注
com.supermap.services.providers UGCAddressMatchProviderSetting getBinDistance/setBinDistance 新增参数
设置创建索引时，网格的间距
UGCMapProviderSetting boolean isMapEditable() 新增参数
设置地图是否可编辑，为true时允许编辑工作空间中的地图并持久化到磁盘。
void setMapEditable(boolean mapEditable) 新增参数
设置地图是否可编辑，为true时允许编辑工作空间中的地图并持久化到磁盘。
UGCSpatialAnalystProvider booleanOperator3D 三维布尔运算
loft 三维放样
getSection 三维获取截面
planeProjection 三维平面投影
shadowVolume 三维获取阴影体
convexHull 三维凸包
getSkylineSectorBody 获取天际线闭合体
getViewShedBody 获取可视域闭合体
ElasticsearchDataProviderSetting   新增类
Elasticsearch数据服务提供者设置类
ElasticsearchDataProvider   新增类
ElasticsearchDataProvider数据服务提供者
UGCDataProvider filteredDatasourceInfo 新增字段
数据服务提供者，增加过滤数据集信息字段
PostgisDataProvider   新增类
PostGIS数据服务提供者
PostgisDataProviderSetting   新增类
PostGIS数据服务提供者配置类
PostgisMapProvider   新增类
PostGIS地图服务提供者
PostgisMapProviderSetting   新增类
PostGIS地图服务提供者配置类
ShapefileDataProvider   新增类
Shapefile数据服务提供者
ShapefileDataProviderSetting   新增类
Shapefile数据服务提供者配置类
ShapefileMapProvider   新增类
Shapefile地图服务提供者
ShapefileMapProviderSetting   新增类
Shapefile地图服务提供者配置类
HBaseMapProviderSetting   新增类
HBase地图服务提供者配置类
HBaseMapProvider   新增类
HBase地图服务提供者
HBaseDataProviderSetting   新增类
HBase数据服务提供者配置类
HBaseDataProvider   新增类
HBase数据服务提供者
com.supermap.services.components Map boolean updateMap(MapParameter mapParameter) 永久更新地图状态，会更新到磁盘中进行持久化
Rectangle2D getProjectionExtent(String mapName) 获取当前投影下的范围
com.supermap.services.components.spi MapProvider boolean updateMap(MapParameter mapParameter) 永久更新地图状态，会更新到磁盘中进行持久化
VectorStyle getVectorStyle(VectorStyleParameter vectorStyleParameter) 获取指定地图中，指定矢量图层的样式
TiledVectorProvider Rectangle2D getProjectionExtent(String mapName) 获取当前投影下的范围
com.supermap.services.rest.commontypes GenerateSpatialDataPostParameter attributeFilter 空间分析，分段查询新增过滤条件
com.supermap.services.components.commontypes TransferGuideItem fare 换乘导引子项所表示的一段乘车路线的费用（即票价）
time 换乘导引子项所表示的一段乘车或步行路线所花费的时间（单位秒）
TileOutputType ZXY 新增枚举，根据xyz值取对应的MapBox瓦片
ScaleXY 新增枚举，根据xy以及比例尺取对应的MapBox瓦片
ViewBounds 新增枚举，根据viewBounds取对应的MapBox瓦片
VectorStyleParameter   新增类，获取Mapbox瓦片时，设置矢量风格参数
VectorTileParameter tileOutputType 设置瓦片出图方式，默认以viewBounds的方式
x 设置矢量瓦片的列号
y 设置矢量瓦片的行号
z 设置矢量瓦片的层级
OutputFormat MVT MVT 格式，输出MVT瓦片
EngineType HBASE 新增枚举值HBASE
SHAPEFILE 新增枚举值SHAPEFILE
POSTGIS 新增枚举值POSTGIS
SpatialDataStoreInfo editable 新增字段
是否允许编辑
MapCapability MVTCapabilities 支持返回MVT瓦片
MBStyle 支持返回Mapbox样式，包括返回style,spirte,font等
TileType MVTTile 新增MVT瓦片类型
com.supermap.services.providers.util DynamicOSGBRealspaceDataReader   新增类
实现模型数据集动态切s3m缓存功能
com.supermap.services.MappingParameters Map VectorStyle getVectorStyle(VectorStyleParameter vectorStyleParameter) throws MapException 新增接口
获取指定地图中，指定矢量图层的样式
com.supermap.processing.jobserver.commontypes MappingParameters ColorGradientType colorGradientType 主要用于分布式分析出图相关设置，设置专题图颜色渐变模式
ThemeRangeItem[] items 主要用于分布式分析出图相关设置，设置专题图子项设置
double rangeCount 主要用于分布式分析出图相关设置，设置专题图分段个数
RangeMode rangeMode 主要用于分布式分析出图相关设置，设置专题图分段模式
OutputType HBASE 新增枚举值HBASE，请求体中增加HBASE输出类型
POSTGIS 新增枚举值POSTGIS，请求体中增加POSTGIS输出类型
EngineType HBASE 新增枚举值HBASE
SHAPEFILE 新增枚举值SHAPEFILE
POSTGIS 新增枚举值POSTGIS
com.supermap.server.config.DistributeAnalysisSetting outputStoreInfo  
com.supermap.server.config OutputType ISERVERDATASTORE 新增输出的存储信息类型iServer DataStore
REGISTEREDDATABASE 新增输出的存储信息类型registered database
LicenseSetting masterServerAddress 主节点服务地址
com.supermap.server.config.DistributeAnalysisSetting outputStoreInfo   新增输出的存储信息类
com.supermap.services.components.spi MergeQueryResultByDatasetInfoSupported QueryResult queryByBounds(String mapName, Rectangle2D bounds, QueryParameterSet queryParameterSet,
boolean mergeResultByDatasetInfo)		 在指定的地图上，查询指定范围内的几何对象，以及外接矩形与指定范围相交的几何对象，把相同数据集的图层的过滤条件进行拼接。
SpritesSupportedProvider String[] listMVTSprites(MapParameter mapParameter) 列出所有Sprites图的名称
String getMVTSpriteJson(MapParameter mapParameter, String spriteName) 获取Sprite图的json表述
byte[] getMVTSpriteResource(MapParameter mapParameter, String spriteName) 获取Sprite资源
ProjectionExtent Rectangle2D getProjectionExtent(String mapName) 获取当前投影下的范围
DynamicMBStyleProvider   删除接口SpritesSupportedProvider
GeometrySpatialAnalyst GeometrySpatialAnalystResult buffer(Geometry geometry, BufferAnalystParameter bufferAnalystparameter, GeometrySpatialAnalystResultSetting resultSetting) 根据几何对象创建缓冲区，成功则返回一个面对象，失败则返回空值
GeometrySpatialAnalystResult buffer(GeometryWithPrjCoordSys geometry, BufferAnalystParameter bufferAnalystparameter,
GeometrySpatialAnalystResultSetting resultSetting)		 根据几何对象创建缓冲区，成功则返回一个面对象，失败则返回空值
GeometrySpatialAnalystResult identity(Geometry sourceGeometry, Geometry operateGeometry, GeometrySpatialAnalystResultSetting resultSetting) 对源几何对象和操作几何对象进行同一操作，用于实现两个几何对象之间的叠加分析
GeometrySpatialAnalystResult clip(Geometry sourceGeometry, Geometry operateGeometry, GeometrySpatialAnalystResultSetting resultSetting) 对两个Geometry进行裁剪操作
GeometrySpatialAnalystResult xor(Geometry sourceGeometry, Geometry operateGeometry, GeometrySpatialAnalystResultSetting resultSetting) 对两个几何对象进行对称差分析运算，即交集取反运算，实现两个几何对象之间的叠加分析
GeometrySpatialAnalystResult intersect(Geometry sourceGeometry, Geometry operateGeometry, GeometrySpatialAnalystResultSetting resultSetting) 用于两个几何对象进行相交方式的叠加分析，返回结果中保留两数据集相交的对象
GeometrySpatialAnalystResult erase(Geometry sourceGeometry, Geometry operateGeometry, GeometrySpatialAnalystResultSetting resultSetting) 对两个几何对象进行擦除操作，用于实现两个几何对象之间的叠加分析

REST API 变更

模块 资源名称 资源/参数/请求/表述 备注 URL模板
spatialanalyst planeProjection DatasetPlaneProjectionResultsResource 新增基于指定数据集的三维平面投影资源 /spatialanalyst/datasets/{datasetName}/planeprojection
/spatialanalyst/datasets/{datasetName}/planeprojection/{ResultID}
section

DatasetSectionResultsResource

 新增基于指定数据集的三维获取截面资源 /spatialanalyst/datasets/{datasetName}/section
/spatialanalyst/datasets/{datasetName}/section/{ResultID}

shadowVolume

DatasetShadowVolumeResultsResource

新增基于指定数据集的构建阴影体资源

 /spatialanalyst/datasets/{datasetName}/shadowvolume
/spatialanalyst/datasets/{datasetName}/shadowvolume/{ResultID}

SpatialQuery3D

DatasetSpatialQuery3DResultsResource

 新增基于指定数据集的三维空间查询结果集资源，查询获得指定空间关系类型的结果 /spatialanalyst/datasets/{datasetName}/SpatialQuery3D
/spatialanalyst/datasets/{datasetName}/SpatialQuery3D/{ResultID}

RelativePosition3D

DatasetGetRelativePosition3DResultsResource

新增基于指定数据集的三维空间查询结果集资源，查询获得数据的空间关系

 /spatialanalyst/datasets/{datasetName}/RelativePosition3D
/spatialanalyst/datasets/{datasetName}/RelativePosition3D/{ResultID}

buffer3D

DatasetBuffer3DResultsResource

新增基于指定数据集的三维缓冲区分析

 /spatialanalyst/datasets/{datasetName}/buffer3d
/spatialanalyst/datasets/{datasetName}/buffer3d/{ResultID}

border

DatasetBorderResultsResource

新增基于指定数据集的边界提取资源

 /spatialanalyst/datasets/{datasetName}/border
/spatialanalyst/datasets/{datasetName}/border/{ResultID}

shadowration

DatasetShadowRatioResultsResource

新增基于指定数据集的阴影率查询资源

 /spatialanalyst/datasets/{datasetName}/shadowratio
/spatialanalyst/datasets/{datasetName}/shadowratio/{ResultID}

booleanOperator3D

 GeometryBooleanOperator3DResultsResource

新增基于几何对象的三维布尔运算资源

 /spatialanalyst/geometry/3d/booleanoperator
/spatialanalyst/geometry/3d/booleanoperator/{ResultID}

convexHull

 GeometryConvexHullResultsResource

新增基于几何对象的三维凸包资源

 /spatialanalyst/geometry/3d/convexhull
/spatialanalyst/geometry/3d/convexhull/{ResultID}

loft

 GeometryLoftResultsResource 新增基于几何对象的三维放样资源 /spatialanalyst/geometry/3d/loft
spatialanalyst/geometry/3d/loft/{ResultID}

skylineSectorBody

 GeometrySkylineSectorBodyResultsResource

新增基于几何对象的构建天际线闭合体资源

 /spatialanalyst/geometry/3d/skylinesectorbody
/spatialanalyst/geometry/3d/skylinesectorbody/{ResultID}

viewShedBody

 GeometryViewShedBodyResultsResource

新增基于几何对象的构建可视域闭合体资源

 /spatialanalyst/geometry/3d/viewshedbody
/spatialanalyst/geometry/3d/viewshedbody/{ResultID}

generatespatialdata

  

空间分析，分段查询请求体中新增过滤字段

 spatialanalyst/datasets/{datasetName}/linearreferencing/generatespatialdata
spatialanalyst/datasets/{datasetIndex}/linearreferencing/generatespatialdata

3DInfo

 Geometry3DInfoResultsResource

新增获取几何体信息资源

  

buffer3D

 GeometryBuffer3DResultsResource

新增基于几何对象的三维缓冲区分析

 /spatialanalyst/geometry/3d/buffer
/spatialanalyst/geometry/3d/buffer/{ResultID}

RelativePosition3D

 GeometryGetRelativePosition3DResultsResource

新增基于几何对象的三维空间查询资源，查询获得数据的空间关系

 /spatialanalyst/geometry/relativePosition3D
/spatialanalyst/geometry/relativePosition3D/{ResultID}
map

layers

 LayersResource 更新地图状态 /maps/{mapName}/layers

prjProjectionExtent

 PrjProjectionExtentResource 新增获取投影全球范围的资源 /maps/{mapName}/prjCoordSys/projection/extent
data

featureResults

   新增支持参数

请求体参数新增aggregations字段，用于支持聚合查询。当请求体参数中含aggregations字段时，请求的响应体中新增aggregations字段，该字段表述的聚合查询的结果信息

 services/{servicesName}/rest/data/featureResults
datacatalog

dataexport

 RsExportDataResource 新增关系型数据的导出资源

datacatalog/relationship/dataexport?dataId={dataId}&fileType={}
management

validation

 ValidationResource 新增通过pgSql中的数据源创建服务提供者 manager/validation
distributedanalyst

odlinemake

 ODLineMakeResource 新增OD分析资源 distributedanalyst/rest/v1/jobs/spatialanalyst/odlinemake
distributedanalyst/rest/v1/jobs/spatialanalyst/odlinemake/{jobID}

reconstructtracks

 ReconstructTracksResource 新增轨迹重建资源 distributedanalyst/rest/v1/jobs/spatialanalyst/reconstructtracks
distributedanalyst/rest/v1/jobs/spatialanalyst/reconstructtracks/{jobID}

buildregiongrid

 BuildRegionGridResource 新增创建区域格网资源 /distributedanalyst/rest/v1/jobs/dataprocessing/buildregiongrid
/distributedanalyst/rest/v1/jobs/dataprocessing/buildregiongrid/{resultID}
geometry

buffer

 GeometryBufferServiceResource 几何服务新增缓冲区分析资源 /iserver/services/{component}/restjsr/v1/geometry/buffer
/iserver/services/{component}/restjsr/v1/geometry/buffer/{ResultID}

overlay

 GeometryOverlayServiceResource 几何服务新增叠加分析资源 /iserver/services/{component}/restjsr/v1/geometry/overlay
/iserver/services/{component}/restjsr/v1/geometry/overlay/{ResultID}

配置文件变更

文件路径

文件名称

配置项

 备注

{ISERVER_HOME}\webapps\iserver\WEB-INF

iserver-system.xml

 新增加provider-type类型ElasticsearchProvider PostGIS数据服务提供者
新增加provider-type类型MongoDBMVTTileProvider
新增加provider-type类型PostgisDataProvider
新增加provider-type类型PostgisMapProvider PostGIS地图服务提供者
新增加provider-type类型ShapefileDataProvider Shapefile数据服务提供者
新增加provider-type类型ShapefileMapProvider Shapefile地图服务提供者
新增加provider-type类型HBaseMapProvider HBase地图服务提供者
新增加provider-type类型HBaseDataProvider HBase数据服务提供者
新增加provider-type类型MongoDBMVTTileProvider MongoDBMVT地图服务提供者
license节点增加masterServerAddress配置项 当启用服务节点许可时，主节点服务地址配置项

iserver-services.xml

 <com.supermap.services.providers.FilteredDatasourceInfo>节点下进行配置
数据源名称存在时需配置：
  • <datasourceName>: 数据源名称。
  • <includedDatasetNames>：选择发布数据集列表
当数据源名称不存在时，需设置：
  • <connInfo>：数据源连接信息。
  • <alias>：数据源别名。
  • <engineType>：引擎类型。
  • <server>：服务。
  • <dataBase>：数据库名称。
  • <driver>：数据源连接所需的驱动程序名。
  • <password>：密码。
  • <user>：用户名。
  • <connect>：数据源是否自动连接数据。
  • <exclusive>：是否以独占方式打开数据源。
  • <openLinkTable>：是否把数据库中的其他非 SuperMap 数据表作为 LinkTable 打开。
  • <readOnly>：是否为只读。
  • <includedDatasetNames>：过滤的数据集列表。
  

iserver-datacatalog.xml

 iserver-datastores.xml改名为iserver-datacatalog.xml，iServer仍兼容 iserver-datastores.xml。两个配置文件都存在则优先加载iserver-datastores.xml中的内容。 数据目录服务配置文件名称变更