com.supermap.services.providers

类 UGCMapProvider

  • java.lang.Object
    • com.supermap.services.providers.UGCMapProvider
    • 构造器详细资料

      • UGCMapProvider

        public UGCMapProvider()
        

        默认构造函数。

      • UGCMapProvider

        public UGCMapProvider(UGCMapProviderSetting providerSetting)
        

        通过 SuperMap 地图服务提供者配置信息构建 UGCMapProvider 对象。

        参数:
        providerSetting - SuperMap 地图服务提供者配置信息。
    • 方法详细资料

      • findNearest

        public QueryResult findNearest(java.lang.String mapName,
                              Geometry geometry,
                              double maxDistance,
                              QueryParameterSet queryParameterSet)
        

        在指定地图上,查找距离指定几何对象一定容限内的几何对象。 当限制了返回几何对象个数(由QueryParameterSet.expectCount指定)时,查询结果为查询总记录中距离指定中心最近的expectCount个地物,这expectCount个地物按无序排列。

        指定者:
        findNearest 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        geometry - 几何对象。其投影坐标系与地图坐标系相同。
        maxDistance - 容限范围。其坐标单位与地图坐标单位相同。
        queryParameterSet - 查询参数集。可对某个地图的多个图层进行查询,单个图层的查询参数在 queryParameterSet.queryParams[i] 中进行设置。
        返回:
        查询结果对象。
      • getDefaultMapParameter

        public MapParameter getDefaultMapParameter(java.lang.String mapName)
        

        获取指定地图的默认地图参数。

        初始的默认地图参数是由所访问的服务类型决定的,比如,访问 SuperMap Objects Java 提供的 GIS 能力,那么初始默认地图参数从工作空间文件中获取到。

        指定者:
        getDefaultMapParameter 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        返回:
        地图参数对象。
      • getMapImage

        public MapImage getMapImage(MapParameter mapParameter,
                           ImageOutputOption outputOption)
        

        根据地图参数、图片输出设置获取地图图片。

        指定者:
        getMapImage 在接口中 MapProvider
        参数:
        mapParameter - 地图参数。该参数不能为空。
        outputOption - 图片输出设置。
        返回:
        地图图片对象。
      • getTileImage

        public MapImage getTileImage(MapParameter mapParameter,
                            ImageOutputOption outputOption)
        

        根据地图参数、图片输出设置获取瓦片图片。

        指定者:
        getTileImage 在接口中 MapProvider
        参数:
        mapParameter - 地图参数。该参数不能为空。
        outputOption - 图片输出设置。
        返回:
        瓦片图片对象。
      • updateMap

        public boolean updateMap(MapParameter mapParameter)
        
        从接口复制的说明: MapProvider
        永久更新地图状态,会更新到磁盘中进行持久化。
        指定者:
        updateMap 在接口中 MapProvider
        参数:
        mapParameter - 要更新的地图状态。
        返回:
        是否更新成功。
      • getMapParameter

        public MapParameter getMapParameter(java.lang.String mapName)
        

        获取指定地图上次出图之后的状态(地图参数)。

        指定者:
        getMapParameter 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        返回:
        地图参数。
      • getNames

        public java.util.List<java.lang.String> getNames()
        

        获取当前 SuperMap 地图服务提供者对应的所有地图名。

        指定者:
        getNames 在接口中 MapProvider
        指定者:
        getNames 在接口中 TilingProvider
        返回:
        地图名称列表。
      • getOverview

        public Overview getOverview(MapParameter mapParameter,
                           ImageOutputOption outputOption)
        

        根据地图参数以及图片输出设置获取鹰眼。

        指定者:
        getOverview 在接口中 MapProvider
        参数:
        mapParameter - 地图参数。该参数不能为空。
        outputOption - 图片输出设置。
        返回:
        鹰眼对象。
      • getResource

        public java.lang.String getResource(java.lang.String mapName,
                                   ResourceParameter resourceParameter)
        

        根据资源图片参数获取指定地图的资源图片。

        指定者:
        getResource 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        resourceParameter - 资源图片参数。
        返回:
        资源图片地址。
      • getResource

        public byte[] getResource(java.lang.String mapName,
                         ResourceParameter resourceParameter,
                         Point2D[] points)
        
        从接口复制的说明: MapProvider

        根据资源图片参数获取指定地图的资源图片。

        指定者:
        getResource 在接口中 MapProvider
        参数:
        mapName - 地图名称。
        resourceParameter - 资源图片参数。
        points - 绘制资源图片时用的点
        返回:
        图片对应的二进制流。
      • measureArea

        public MeasureResult measureArea(java.lang.String mapName,
                                Point2D[] points,
                                MeasureParameter measureParam)
        

        根据二维地理坐标点、量算参数,在指定地图上进行面积量算。

        指定者:
        measureArea 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        points - 二维地理坐标点数组。
        measureParam - 量算参数。
        返回:
        量算结果对象。
      • measureDistance

        public MeasureResult measureDistance(java.lang.String mapName,
                                    Point2D[] points,
                                    MeasureParameter measureParam)
        

        根据二维地理坐标点、量算参数,在指定地图上进行距离量算。

        指定者:
        measureDistance 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        points - 二维地理坐标点数组。
        measureParam - 量算参数。
        返回:
        量算结果对象。
      • queryByDistance

        public QueryResult queryByDistance(java.lang.String mapName,
                                  Geometry geometry,
                                  double distance,
                                  QueryParameterSet queryParameterSet)
        

        在指定地图上,查询距离指定的几何对象一定范围内的所有几何对象。 当限制了返回几何对象个数(由QueryParameterSet.expectCount指定)时,查询结果为查询总记录中随机抽取的 expectCount 个对象。

        到指定几何对象的一定距离范围,实际是以指定几何对象为中心的一个圆,在这个圆内以及与圆相交的几何对象都能够被查询出来。

        指定者:
        queryByDistance 在接口中 MapProvider
        参数:
        mapName - 地图名称 。该参数不能为空。
        geometry - 几何对象。其投影坐标系与地图坐标系相同。
        distance - 查询的距离范围。其坐标单位与地图坐标单位相同。
        queryParameterSet - 查询参数集。可对某个地图的多个图层进行查询,单个图层的查询参数在 queryParameterSet.queryParams[i] 中进行设置。
        返回:
        查询结果对象。
      • queryByBounds

        public QueryResult queryByBounds(java.lang.String mapName,
                                Rectangle2D bounds,
                                QueryParameterSet queryParameterSet)
        

        在指定的地图上,查询指定范围内的几何对象。

        指定者:
        queryByBounds 在接口中 MapProvider
        参数:
        mapName - 地图名称。
        bounds - 指定的查询范围。其投影坐标系与地图坐标系相同。
        queryParameterSet - 查询参数集。可对某个地图的多个图层进行查询,单个图层的查询参数在 queryParameters.queryParams[i] 中进行设置。
        返回:
        查询结果对象。
      • queryByGeometry

        public QueryResult queryByGeometry(java.lang.String mapName,
                                  Geometry geometry,
                                  SpatialQueryMode spatialQueryMode,
                                  QueryParameterSet queryParameterSet)
        

        在指定地图上,查询与指定的几何对象符合某种空间关系和查询条件的几何对象。

        指定者:
        queryByGeometry 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        geometry - 几何对象。该几何对象仅包含空间信息、形状信息等,并不包括属性信息。其投影坐标系与地图坐标系相同。
        spatialQueryMode - 空间几何对象间的查询模式。空间几何对象间的查询模式定义了一些几何对象之间的空间位置关系,根据这些空间关系来构建过滤条件执行查询 。例如:查询可被包含在面对象中的空间对象,与面有相离或者相邻关系的空间对象等。
        queryParameterSet - 查询参数集。可对某个地图的多个图层进行查询,单个图层的查询参数在 queryParameterSet.queryParams[i] 中进行设置。
        返回:
        查询结果对象。
      • queryBySQL

        public QueryResult queryBySQL(java.lang.String mapName,
                             QueryParameterSet queryParameterSet)
        

        在指定地图上执行 SQL 查询。

        指定者:
        queryBySQL 在接口中 MapProvider
        参数:
        mapName - 地图名称。该参数不能为空。
        queryParameterSet - 查询参数集。可对某个地图的多个图层进行查询,单个图层的查询参数在 queryParameterSet.queryParams[i] 中进行设置。
        返回:
        查询结果对象。
      • viewEntire

        public MapImage viewEntire(java.lang.String layerName,
                          MapParameter mapParameter,
                          ImageOutputOption outputOption)
        

        根据地图图层名、地图参数以及图片输出设置进行全幅显示。

        参数中指定的图层名称限定了全幅显示的地理范围,规则是以该图层内容的最小外接矩形作为全幅显示的地理范围。

        指定者:
        viewEntire 在接口中 MapProvider
        参数:
        layerName - 地图图层名,即以该图层的最小外接矩形作为全幅显示的地理范围。
        mapParameter - 地图参数。
        outputOption - 图片输出设置。
        返回:
        地图对象。
      • checkParameterNull

        protected static void checkParameterNull(java.lang.Object obj,
                              java.lang.String parameterName)
        

        检查参数是否为空。

        如果名称为 parameterName 的参数为空时,抛出 IllegalArgumentException 异常。

        参数:
        obj - 待检查的参数类型。
        parameterName - 待检查的参数名称。
      • getProvider

        protected com.supermap.services.providers.InnerUGCMapProvider getProvider(java.lang.String name)
        
        获取内部地图Provider
        参数:
        name - 地图名称
        返回:
        内部地图Provider
      • dispose

        public void dispose()
        

        释放 SuperMap 地图服务提供者所占用的资源。

        指定者:
        dispose 在接口中 Disposable
      • checkExcludedFieldsInMapsSetting

        protected void checkExcludedFieldsInMapsSetting(ExcludedFieldsInMap[] excludedFieldsInMaps)
        
      • checkDatasourceType

        protected void checkDatasourceType(Workspace ugoWorkspace)
        
      • pauseForRefreshWorkspace

        public void pauseForRefreshWorkspace()
        

        暂停服务。

      • refreshWorkspaceFinished

        public void refreshWorkspaceFinished()
        

        工作空间刷新完毕。

      • refreshWorkspace

        public void refreshWorkspace()
        

        刷新工作空间。

      • clearCache

        public void clearCache(java.lang.String mapName,
                      Rectangle2D bounds)
        

        根据地图名称和边框清除指定区域的缓存。

        指定者:
        clearCache 在接口中 MapProvider
        参数:
        mapName - 地图名称。
        bounds - 边界范围。
      • finalize

        protected void finalize()
                         throws java.lang.Throwable
        
        覆盖:
        finalize 在类中 java.lang.Object
        抛出:
        java.lang.Throwable
      • support

        public boolean support(java.lang.String mapName,
                      MapCapability capability)
        
        从接口复制的说明: MapProvider
        判断地图是否支持相应功能。
        指定者:
        support 在接口中 MapProvider
        参数:
        mapName - 地图名。
        capability - 功能类型。
        返回:
        返回true表示支持该功能;返回false表示不支持该功能。
      • checkPrjSupportMBStyle

        public boolean checkPrjSupportMBStyle(int value)
        
      • getVectorStyle

        public VectorStyle getVectorStyle(java.lang.String mapName,
                                 java.lang.String[] layerNames,
                                 VectorStyleType type)
        
        从接口复制的说明: MapProvider
        获取指定地图中,指定矢量图层的样式
        指定者:
        getVectorStyle 在接口中 MapProvider
        参数:
        mapName - 地图名称
        layerNames - 图层名称
        type - 矢量样式类型
        返回:
        矢量图层样式
      • getSDFFonts

        public byte[] getSDFFonts(java.lang.String fontstack,
                         java.lang.String range)
        
        从接口复制的说明: SDFFontsSupportedProvider
        获取sdf格式的数据
        指定者:
        getSDFFonts 在接口中 SDFFontsSupportedProvider
        参数:
        fontstack - 字体名称
        range - 字体的
        返回:
        字体数据