com.supermap.services.providers
类 UGCRealspaceProvider
- java.lang.Object
-
- com.supermap.services.providers.UGCRealspaceProvider
-
- 所有已实现的接口:
- Disposable, ProviderContextAware, RealspaceProvider
public class UGCRealspaceProvider extends java.lang.Object implements RealspaceProvider, ProviderContextAware, Disposable
SuperMap 三维服务提供者。
UGCRealspaceProvider 提供了 SuperMap 三维的相关服务,封装了与 SuperMap 三维相关的 GIS 功能。
-
-
嵌套类概要
嵌套类 限定符和类型 类和说明 static class
UGCRealspaceProvider.WorkspaceDataRefresh
工作空间中的数据修改后刷新工作空间。
-
构造器概要
构造器 构造器和说明 UGCRealspaceProvider()
构造函数。UGCRealspaceProvider(UGCRealspaceProviderSetting setting)
通过 SuperMap 三维服务提供者配置构建UGCRealspaceProvider
对象。
-
方法概要
方法 限定符和类型 方法和说明 boolean
cleanCacheData(java.lang.String dataName)
清除动态发布数据的缓存void
dispose()
释放对象。java.lang.String
getCacheAccessKey()
返回用于对缓存数据进行加密的密码。RealspaceDataResult
getData(RealspaceDataParam dataParam)
获取三维瓦片数据结果。RealspaceDataResult
getData(java.lang.String dataName, java.lang.String relativePath)
根据相对路径获取瓦片数据结果。RealspaceDataResult
getData(java.lang.String sceneName, java.lang.String layerName, RealspaceDataParam dataParam)
根据场景名以及图层名及瓦片 参数三维瓦片数据结果。RealspaceDataResult
getData(java.lang.String dataName, java.lang.String relativePath, RelativePathType relativePathType)
根据相对路径及相对路径的类型获取瓦片数据结果。byte[]
getDataConfig(java.lang.String dataName)
根据三维数据的名称获取三维缓存数据的配置文件。byte[]
getDataConfig(java.lang.String dataName, CompressType compressType)
根据名称获取三维缓存数据的配置文件。java.util.List<RealspaceDataInfo>
getDataInfos()
获取当前 Provider 的所有三维数据信息。java.lang.Object
getdataSetFromWorkspace(Workspace workspace, java.lang.String dataName)
根据数据名 获取所在工作空间的数据集或地图对象java.lang.String
getDataVersion(RealspaceDataParam dataParam)
java.lang.String
getDataVersion(java.lang.String dataName, int xIndex, int yIndex, int level, java.lang.String fileExtension)
根据索引获取瓦片数据的最新版本号。java.lang.String
getDataVersion(java.lang.String dataName, java.lang.String relativePath)
根据相对路径获取瓦片数据的最新版本号。java.lang.String
getLayerExtendXML(java.lang.String sceneName, java.lang.String layerName)
获取指定图层的图层扩展信息PrjCoordSys
getLayerPrj(java.lang.String sceneName, java.lang.String layerName)
获取指定图层的投影信息byte[]
getModelIndex(java.lang.String dataName)
根据三维数据的名称获取三维模型缓存数据的模型索引文件。java.util.List<OfflineDataInfo>
getOfflineDataPaths(java.lang.String sceneName, java.lang.String layerName)
获取特定三维场景的所有数据离线包的位置信息SceneInfo
getSceneInfo(java.lang.String sceneName)
根据三维场景的名称,获取三维场景的信息。java.util.List<java.lang.String>
getSceneNames()
获取当前服务提供者所有可用的三维场景的名称。RealspaceTilesRevisionInfo
getTilesRevisionInfo(java.lang.String dataName, long revisionNumber)
获取指定版本号的瓦片变更 信息。byte[]
getVectorIndex(java.lang.String dataName)
根据名称获取三维矢量缓存数据的索引文件。boolean
isDataAvailable(java.lang.String dataName)
三维数据是否可用。boolean
isSceneAvailable(java.lang.String sceneName)
三维场景是否可用。boolean
isSecurityEnabled()
是否启用安全机制。RealspaceDataResult[]
outputDataToMemory(java.lang.String sceneName, java.lang.String layerName, Output3DDataToMemoryParam outputParam)
根据场景名以及图层名将三维瓦片生成到内存中void
pauseForRefreshWorkspace()
阻止请求,以便刷新工作空间。void
refreshWorkspace()
刷新工作空间。void
refreshWorkspaceFinished()
刷新工作空间结束,继续请求。void
setProviderContext(ProviderContext context)
设置服务提供者上下文。
-
-
-
构造器详细资料
-
UGCRealspaceProvider
public UGCRealspaceProvider()
构造函数。
-
UGCRealspaceProvider
public UGCRealspaceProvider(UGCRealspaceProviderSetting setting)
通过 SuperMap 三维服务提供者配置构建
UGCRealspaceProvider
对象。- 参数:
setting
- uperMap 三维服务提供者配置。
-
-
方法详细资料
-
getData
public RealspaceDataResult getData(RealspaceDataParam dataParam) throws RealspaceException
从接口复制的说明:RealspaceProvider
获取三维瓦片数据结果。- 指定者:
getData
在接口中RealspaceProvider
- 参数:
dataParam
- 瓦片参数。- 抛出:
RealspaceException
-
getData
public RealspaceDataResult getData(java.lang.String sceneName, java.lang.String layerName, RealspaceDataParam dataParam) throws RealspaceException
从接口复制的说明:RealspaceProvider
根据场景名以及图层名及瓦片 参数三维瓦片数据结果。- 指定者:
getData
在接口中RealspaceProvider
- 参数:
sceneName
- 场景名。layerName
- 图层名。dataParam
- 瓦片参数。- 抛出:
RealspaceException
-
outputDataToMemory
public RealspaceDataResult[] outputDataToMemory(java.lang.String sceneName, java.lang.String layerName, Output3DDataToMemoryParam outputParam) throws RealspaceException
从接口复制的说明:RealspaceProvider
根据场景名以及图层名将三维瓦片生成到内存中- 指定者:
outputDataToMemory
在接口中RealspaceProvider
- 参数:
sceneName
- 场景名layerName
- 图层名- 返回:
- 生成的三维瓦片
- 抛出:
RealspaceException
-
getData
public RealspaceDataResult getData(java.lang.String dataName, java.lang.String relativePath) throws RealspaceException
根据相对路径获取瓦片数据结果。
瓦片数据相对路径的设置有以下情况:
- 对于地形和影像三维缓存数据来说,相对路径从缓存配置文件(SCT 和 SCI3D)所在的目录开始,也就是从缓存层号开始,缓存配置文件同级下存放了分层的缓存数据 。比如缓存层号为12,那么相对路径为“12/.../.../缓存文件”。
- 对于模型的三维缓存数据来说,相对路径从缓存配置文件的父一级目录开始,即与缓存层号同级的数据。模型数据与地形和影像数据不同, 在分层目录下存放的不是缓存之后的数据,而是模型缓存文件的索引,其缓存数据文件(SGM)存放在缓存配置文件上一级的目录下。
- 对于 KML 数据来说,相对路径设为 KML 文件即可。
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。relativePath
- 瓦片数据的相对路径。- 返回:
- 瓦片数据结果。
- 抛出:
RealspaceException
- 三维异常信息。
-
getData
public RealspaceDataResult getData(java.lang.String dataName, java.lang.String relativePath, RelativePathType relativePathType) throws RealspaceException
根据相对路径及相对路径的类型获取瓦片数据结果。
如果是相对缓存配置文件时瓦片数据相对路径的设置有以下情况:
- 对于地形和影像三维缓存数据来说,相对路径从缓存配置文件(SCT 和 SCI3D)所在的目录开始,也就是从缓存层号开始,缓存配置文件同级下存放了分层的缓存数据 。比如缓存层号为12,那么相对路径为“12/.../.../缓存文件”。
- 对于模型的三维缓存数据来说,相对路径从缓存配置文件的父一级目录开始,即与缓存层号同级的数据。模型数据与地形和影像数据不同, 在分层目录下存放的不是缓存之后的数据,而是模型缓存文件的索引,其缓存数据文件(SGM)存放在缓存配置文件上一级的目录下。
- 对于 KML 数据来说,相对路径设为 KML 文件即可。
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。relativePath
- 瓦片数据的相对路径。relativePathType
- 瓦片数据的相对路径类型。- 返回:
- 瓦片数据结果。
- 抛出:
RealspaceException
- 三维异常信息。
-
getDataConfig
public byte[] getDataConfig(java.lang.String dataName) throws RealspaceException
根据三维数据的名称获取三维缓存数据的配置文件。- 指定者:
getDataConfig
在接口中RealspaceProvider
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。- 返回:
- 三维缓存数据的配置文件。
- 抛出:
RealspaceException
- 三维异常信息。
-
getDataConfig
public byte[] getDataConfig(java.lang.String dataName, CompressType compressType) throws RealspaceException
从接口复制的说明:RealspaceProvider
根据名称获取三维缓存数据的配置文件。- 指定者:
getDataConfig
在接口中RealspaceProvider
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。- 返回:
- 三维缓存数据的配置文件。
- 抛出:
RealspaceException
- 三维异常信息。
-
getDataInfos
public java.util.List<RealspaceDataInfo> getDataInfos()
获取当前 Provider 的所有三维数据信息。- 指定者:
getDataInfos
在接口中RealspaceProvider
- 返回:
- 三维数据信息。
- 抛出:
RealspaceException
- 三维异常信息。
-
getDataVersion
public java.lang.String getDataVersion(java.lang.String dataName, int xIndex, int yIndex, int level, java.lang.String fileExtension) throws RealspaceException
根据索引获取瓦片数据的最新版本号。- 指定者:
getDataVersion
在接口中RealspaceProvider
- 参数:
dataName
- 对应 SuperMap 三维场景中的三维图层的名称(LayerName)。xIndex
- 瓦片数据在 X 方向的索引。yIndex
- 瓦片数据在 Y 方向的索引。level
- 瓦片数据的层号,仅模型的三维缓存数据需要设置。fileExtension
- 瓦片数据的扩展名。包括 *.png,*.jpg,*.bil等。- 返回:
- 瓦片数据的版本。
- 抛出:
RealspaceException
- 三维异常信息。
-
getDataVersion
public java.lang.String getDataVersion(java.lang.String dataName, java.lang.String relativePath) throws RealspaceException
根据相对路径获取瓦片数据的最新版本号。
瓦片数据相对路径的设置有以下情况:
- 对于地形和影像三维缓存数据来说,相对路径从缓存配置文件(SCT 和 SCI3D)所在的目录开始,也就是从缓存层号开始,缓存配置文件同级下存放了分层的缓存数据 。比如缓存层号为12,那么相对路径为“12/.../.../缓存文件”。
- 对于模型三维缓存数据来说,相对路径从缓存配置文件的父一级目录开始,即从缓存层号目录开始,模型数据与地形和影像数据不同, 在分层目录下存放的不是缓存之后的数据,而是模型缓存文件的索引文件(index),版本号指的也是该索引文件的版本号。
- KML 数据没有版本号。
- 指定者:
getDataVersion
在接口中RealspaceProvider
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。relativePath
- 瓦片数据的相对路径。- 返回:
- 瓦片数据的最新版本号。
- 抛出:
RealspaceException
- 三维异常信息。
-
getDataVersion
public java.lang.String getDataVersion(RealspaceDataParam dataParam) throws RealspaceException
-
getModelIndex
public byte[] getModelIndex(java.lang.String dataName) throws RealspaceException
根据三维数据的名称获取三维模型缓存数据的模型索引文件。
该文件以“index”为文件的扩展名,与模型缓存数据的配置文件(扩展名为“scm”的文件)位于同样的父目录下。
- 指定者:
getModelIndex
在接口中RealspaceProvider
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。- 返回:
- 模型索引文件。
- 抛出:
RealspaceException
- 三维异常信息。
-
getVectorIndex
public byte[] getVectorIndex(java.lang.String dataName) throws RealspaceException
从接口复制的说明:RealspaceProvider
根据名称获取三维矢量缓存数据的索引文件。- 指定者:
getVectorIndex
在接口中RealspaceProvider
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。- 返回:
- 矢量数据的索引文件。
- 抛出:
RealspaceException
- 三维异常信息。
-
getSceneInfo
public SceneInfo getSceneInfo(java.lang.String sceneName) throws RealspaceException
根据三维场景的名称,获取三维场景的信息。- 指定者:
getSceneInfo
在接口中RealspaceProvider
- 参数:
sceneName
- 三维场景的名称。- 返回:
- 三维场景信息。
- 抛出:
RealspaceException
- 三维异常信息。
-
getSceneNames
public java.util.List<java.lang.String> getSceneNames() throws RealspaceException
获取当前服务提供者所有可用的三维场景的名称。- 指定者:
getSceneNames
在接口中RealspaceProvider
- 返回:
- 可用的场景名称列表。
- 抛出:
RealspaceException
- 三维异常信息。
-
isDataAvailable
public boolean isDataAvailable(java.lang.String dataName) throws RealspaceException
三维数据是否可用。- 指定者:
isDataAvailable
在接口中RealspaceProvider
- 参数:
dataName
- 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称(LayerName)。- 返回:
- 三维数据可用返回 true;否则返回 false。
- 抛出:
RealspaceException
- 三维异常信息。
-
isSceneAvailable
public boolean isSceneAvailable(java.lang.String sceneName) throws RealspaceException
三维场景是否可用。- 指定者:
isSceneAvailable
在接口中RealspaceProvider
- 参数:
sceneName
- 三维场景的名称。- 返回:
- 三维场景可用返回 true;否则返回 false。
- 抛出:
RealspaceException
- 三维异常信息。
-
setProviderContext
public void setProviderContext(ProviderContext context)
设置服务提供者上下文。
- 指定者:
setProviderContext
在接口中ProviderContextAware
- 参数:
context
- 服务提供者上下文。
-
dispose
public void dispose()
释放对象。
- 指定者:
dispose
在接口中Disposable
-
refreshWorkspace
public void refreshWorkspace()
刷新工作空间。
-
refreshWorkspaceFinished
public void refreshWorkspaceFinished()
刷新工作空间结束,继续请求。
-
pauseForRefreshWorkspace
public void pauseForRefreshWorkspace()
阻止请求,以便刷新工作空间。
-
getCacheAccessKey
public java.lang.String getCacheAccessKey()
从接口复制的说明:RealspaceProvider
返回用于对缓存数据进行加密的密码。- 指定者:
getCacheAccessKey
在接口中RealspaceProvider
- 返回:
- 返回用于对缓存数据进行加密的密码。
-
isSecurityEnabled
public boolean isSecurityEnabled()
从接口复制的说明:RealspaceProvider
是否启用安全机制。- 指定者:
isSecurityEnabled
在接口中RealspaceProvider
- 返回:
- 安全机制启用则返回 true;否则返回 false。
-
cleanCacheData
public boolean cleanCacheData(java.lang.String dataName) throws RealspaceException
清除动态发布数据的缓存- 指定者:
cleanCacheData
在接口中RealspaceProvider
- 参数:
dataName
-- 返回:
- 抛出:
RealspaceException
-
getOfflineDataPaths
public java.util.List<OfflineDataInfo> getOfflineDataPaths(java.lang.String sceneName, java.lang.String layerName) throws RealspaceException
获取特定三维场景的所有数据离线包的位置信息- 指定者:
getOfflineDataPaths
在接口中RealspaceProvider
- 参数:
sceneName
- 三维场景的名称。- 返回:
- 返回离线包位置
- 抛出:
RealspaceException
- 从以下版本开始:
- 6.1.3
-
getTilesRevisionInfo
public RealspaceTilesRevisionInfo getTilesRevisionInfo(java.lang.String dataName, long revisionNumber)
从接口复制的说明:RealspaceProvider
获取指定版本号的瓦片变更 信息。- 指定者:
getTilesRevisionInfo
在接口中RealspaceProvider
revisionNumber
- 版本号。- 返回:
- 变更 信息。
-
getdataSetFromWorkspace
public java.lang.Object getdataSetFromWorkspace(Workspace workspace, java.lang.String dataName)
根据数据名 获取所在工作空间的数据集或地图对象- 参数:
workspace
- 工作空间dataName
- 数据名- 返回:
-
getLayerPrj
public PrjCoordSys getLayerPrj(java.lang.String sceneName, java.lang.String layerName) throws RealspaceException
从接口复制的说明:RealspaceProvider
获取指定图层的投影信息- 指定者:
getLayerPrj
在接口中RealspaceProvider
- 参数:
sceneName
- 场景名layerName
- 图层名- 返回:
- 图层投影信息
- 抛出:
RealspaceException
-
getLayerExtendXML
public java.lang.String getLayerExtendXML(java.lang.String sceneName, java.lang.String layerName) throws RealspaceException
从接口复制的说明:RealspaceProvider
获取指定图层的图层扩展信息- 指定者:
getLayerExtendXML
在接口中RealspaceProvider
- 参数:
sceneName
- 场景名layerName
- 图层名- 返回:
- 图层扩展信息xml
- 抛出:
RealspaceException
-
-