com.supermap.services.providers

Class GeoPackageMapProvider

java.lang.Object

com.supermap.services.components.spi.TiledMapProviderBase

com.supermap.services.providers.LocalTileProviderBase

com.supermap.services.providers.GeoPackageMapProvider

All Implemented Interfaces:

Disposable, MapProvider, ProviderContextAware

public class GeoPackageMapProvider
extends LocalTileProviderBase

Nested Class Summary

Nested classes/interfaces inherited from class com.supermap.services.components.spi.TiledMapProviderBase

TiledMapProviderBase.TileDataConverter, TiledMapProviderBase.TileImageDrawer, TiledMapProviderBase.TileImageParameter

Field Summary

Fields inherited from class com.supermap.services.providers.LocalTileProviderBase

localTileResource

Fields inherited from class com.supermap.services.components.spi.TiledMapProviderBase

CACHE_DIR, LINK_MARK, lock, logger, message, QUESTION_MARK, REGEX, REPLACEMENT, tilePixHeight, tilePixWidth

Constructor Summary

Constructors

Constructor and Description
GeoPackageMapProvider()
GeoPackageMapProvider(GeoPackageMapProviderSetting providerSetting)

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	cacheEnabled()
void	clearCache(java.lang.String mapName, Rectangle2D bounds) Clears the cache corresponding to a specified area.
void	dispose() Release the resource object.
QueryResult	findNearest(java.lang.String mapName, Geometry geometry, double maxDistance, QueryParameterSet queryParameterSet) Queries the nearest geometric object on a specified map whose distance to a specified geometry is within a certain value.
MapParameter	getDefaultMapParameter(java.lang.String mapName) Gets the default map parameters of the specified map.
MapImage	getMapImage(MapParameter mapParameter, ImageOutputOption outputOption) Gets map images according to map parameters and image output settings.
MapParameter	getMapParameter(java.lang.String mapName) Gets the status of a map (the map parameters) after outputting map images last time.
protected Point2D	getOrigin(java.lang.String mapName) Get the geographical coordinate of left upper corner of the map.
Overview	getOverview(MapParameter mapParameter, ImageOutputOption outputOption) Gets the overview map image according to map parameters and image output settings.
java.lang.String	getResource(java.lang.String mapName, ResourceParameter resourceParameter) Gets the resource image of a specified map according to a resource image parameter.
OutputFormat[]	getSupportImageFormat(java.lang.String mapName) Return the supported image formats.
double[]	getSupportResolutions(java.lang.String mapName) Returns the resolution of the current service support.
protected byte[]	getTileImage(TiledMapProviderBase.TileImageParameter tileParam)
VectorStyle	getVectorStyle(java.lang.String mapName, java.lang.String[] layerNames, VectorStyleType type) Gets the specified vector layer style in the specified map.
protected java.util.Map<java.lang.String,MapParameter>	initDefaultMapParameter() Initializing the default map status, a mapping object will be returned, of which the key is map name, valude is map parameter object.
protected java.util.List<java.lang.String>	initSupportedMapNames() Initializes the supported map list.
protected boolean	isResolutionEquals(double resolution1, double resolution2) Determines if two resolutions are within the tolerance (1.0E-6)
MeasureResult	measureArea(java.lang.String mapName, Point2D[] points, MeasureParameter measureParam) Measures areas on a specified map based on 2D geographic coordinates and a measuring parameter.
MeasureResult	measureDistance(java.lang.String mapName, Point2D[] points, MeasureParameter measureParam) Measures distances on a specified map based on 2D geographic coordinates and a measuring parameter.
protected byte[]	outputImage(MapParameter param, ImageOutputOption outputOption, double currentResolution) Output image in real time.
QueryResult	queryByBounds(java.lang.String mapName, Rectangle2D bounds, QueryParameterSet queryParameterSet) Queries the geometries in the specified range on the map.
QueryResult	queryByDistance(java.lang.String mapName, Geometry geometry, double distance, QueryParameterSet queryParameterSet) Queries all the geometric objects on a specified map whose distances to a specified geometry are within a certain value.
QueryResult	queryByGeometry(java.lang.String mapName, Geometry geometry, SpatialQueryMode spatialQueryMode, QueryParameterSet queryParameterSet) Queries geometric objects that satisfy a certain spatial relationship with a specified geometric object and meet query conditions on a specified map.
QueryResult	queryBySQL(java.lang.String mapName, QueryParameterSet queryParameterSet) Performs SQL query on specified map.
MapParameter	setDefaultMapParameter(MapParameter mapParameter) Sets the default map parameters.
boolean	support(java.lang.String mapName, MapCapability capability) Determines whether the map supports the specified function.
MapImage	viewEntire(java.lang.String layerName, MapParameter mapParameter, ImageOutputOption outputOption) Displays a map in the Full Extent mode according to map layer name, map parameters and image output settings.

Methods inherited from class com.supermap.services.providers.LocalTileProviderBase

generateBigImage

Methods inherited from class com.supermap.services.components.spi.TiledMapProviderBase

checkSetting, fillWatermark, getDefaultMapParameters, getMapProviderSetting, getNames, getProximalResolution, getProximalResolution, getResolutoinByScale, getResource, getTileDataConverter, init, outputImage, outputImageToFile, outputImageToFile, rectifyMapParameter, setDefaultMapParameters, setMapProviderSetting, setProviderContext, updateMap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GeoPackageMapProvider

public GeoPackageMapProvider()

GeoPackageMapProvider

public GeoPackageMapProvider(GeoPackageMapProviderSetting providerSetting)

Method Detail

dispose

public void dispose()

Description copied from class: TiledMapProviderBase

Release the resource object.

Specified by:

dispose in interface Disposable

Overrides:

dispose in class TiledMapProviderBase

getMapParameter

public MapParameter getMapParameter(java.lang.String mapName)

Description copied from interface: MapProvider

Gets the status of a map (the map parameters) after outputting map images last time.

Specified by:

getMapParameter in interface MapProvider

Overrides:

getMapParameter in class TiledMapProviderBase

Parameters:

mapName - The specified map name.

Returns:

Map parameters.

clearCache

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

Description copied from interface: MapProvider

Clears the cache corresponding to a specified area.

Specified by:

clearCache in interface MapProvider

Overrides:

clearCache in class TiledMapProviderBase

getMapImage

public MapImage getMapImage(MapParameter mapParameter,
                   ImageOutputOption outputOption)

Description copied from interface: MapProvider

Gets map images according to map parameters and image output settings.

Specified by:

getMapImage in interface MapProvider

Overrides:

getMapImage in class TiledMapProviderBase

Parameters:

mapParameter - Map parameters.

outputOption - Image output settings.

Returns:

The map image object.

getResource

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

Description copied from interface: MapProvider

Gets the resource image of a specified map according to a resource image parameter.

Specified by:

getResource in interface MapProvider

Overrides:

getResource in class TiledMapProviderBase

Parameters:

mapName - The map name.

resourceParameter - The resource image parameter.

Returns:

The resource image address.

measureDistance

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

Description copied from interface: MapProvider

Measures distances on a specified map based on 2D geographic coordinates and a measuring parameter.

Specified by:

measureDistance in interface MapProvider

Overrides:

measureDistance in class TiledMapProviderBase

Parameters:

mapName - The map name.

points - The array of 2D geographic coordinates.

measureParam - The measuring parameter.

Returns:

Measurement result object.

measureArea

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

Description copied from interface: MapProvider

Measures areas on a specified map based on 2D geographic coordinates and a measuring parameter.

Specified by:

measureArea in interface MapProvider

Overrides:

measureArea in class TiledMapProviderBase

Parameters:

mapName - The map name.

points - The array of 2D geographic coordinates.

measureParam - The measuring parameter.

Returns:

Measurement result object.

queryByDistance

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

Description copied from interface: MapProvider

Queries all the geometric objects on a specified map whose distances to a specified geometry are within a certain value.

Which means to query all the geometries within a circle whose center is the specified geometry.

Specified by:

queryByDistance in interface MapProvider

Overrides:

queryByDistance in class TiledMapProviderBase

Parameters:

mapName - The map name.

geometry - The geometric object.

distance - The querying distance.

queryParameterSet - Query parameters can query multiple layers of a map. The query parameters in a single layer can be set in queryParameterSet.queryParams[i] .

Returns:

Query result object.

queryByGeometry

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

Description copied from interface: MapProvider

Queries geometric objects that satisfy a certain spatial relationship with a specified geometric object and meet query conditions on a specified map.

Specified by:

queryByGeometry in interface MapProvider

Overrides:

queryByGeometry in class TiledMapProviderBase

Parameters:

mapName - The map name.

geometry - The geometric object, which has spatial information and shape information, but no attribute information.

spatialQueryMode - The spatial query mode, which defines several spatial relationships between geometries, and it allows users to construct filter conditions to perform querying. For example, searching spatial objects which are contained in specified region object, or which have a disjoint or adjacent relationship with the specified region object.

queryParameterSet - Query parameters can query multiple layers of a map. The query parameters in a single layer can be set in queryParameterSet.queryParams[i] .

Returns:

Query result object.

queryByBounds

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

Description copied from interface: MapProvider

Queries the geometries in the specified range on the map.

Specified by:

queryByBounds in interface MapProvider

Overrides:

queryByBounds in class TiledMapProviderBase

Parameters:

mapName - The map name.

bounds - The specified query bounds.

Returns:

Query result object.

queryBySQL

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

Description copied from interface: MapProvider

Performs SQL query on specified map.

Specified by:

queryBySQL in interface MapProvider

Overrides:

queryBySQL in class TiledMapProviderBase

Parameters:

mapName - The map name.

queryParameterSet - Query parameters can query multiple layers of a map. The query parameters in a single layer can be set in queryParameterSet.queryParams[i] .

Returns:

Query result object.

setDefaultMapParameter

public MapParameter setDefaultMapParameter(MapParameter mapParameter)

Description copied from interface: MapProvider

Sets the default map parameters.

Specified by:

setDefaultMapParameter in interface MapProvider

Overrides:

setDefaultMapParameter in class TiledMapProviderBase

Parameters:

mapParameter - Map parameters.

Returns:

The map parameter object.

getDefaultMapParameter

public MapParameter getDefaultMapParameter(java.lang.String mapName)

Description copied from interface: MapProvider

Gets the default map parameters of the specified map.

Retrieval of the initial default map parameter depends on the type of the service accessed. For example, if the GIS functions provided by SuperMap Objects Java are accessed, the initial default map parameter is obtained from a workspace file; if the GIS functions of a WMS service are accessed, the default map parameter is determined in the WMS service.

Specified by:

getDefaultMapParameter in interface MapProvider

Overrides:

getDefaultMapParameter in class TiledMapProviderBase

Parameters:

mapName - The map name.

Returns:

The map parameter object.

viewEntire

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

Description copied from interface: MapProvider

Displays a map in the Full Extent mode according to map layer name, map parameters and image output settings.

The full geographic map extent to display is the minimum circumscribed rectangle of the specified layer.

Specified by:

viewEntire in interface MapProvider

Overrides:

viewEntire in class TiledMapProviderBase

Parameters:

layerName - Layer name, used to determine the full map extent.

mapParameter - Map parameters.

outputOption - Image output settings.

Returns:

The Map object.

getOverview

public Overview getOverview(MapParameter mapParameter,
                   ImageOutputOption outputOption)

Description copied from class: TiledMapProviderBase

Gets the overview map image according to map parameters and image output settings.

Specified by:

getOverview in interface MapProvider

Overrides:

getOverview in class TiledMapProviderBase

Parameters:

mapParameter - Map parameters.

outputOption - Image output settings.

Returns:

The overview map image object.

findNearest

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

Description copied from interface: MapProvider

Queries the nearest geometric object on a specified map whose distance to a specified geometry is within a certain value. When limit the number of returned geometric objects (specified by QueryParameterSet.expectCount), the query result is the expectCount features nearest to the center in the records. There is no orders of expectCount.

Specified by:

findNearest in interface MapProvider

Overrides:

findNearest in class TiledMapProviderBase

Parameters:

mapName - The map name.

geometry - The geometric object.

maxDistance - The maximum distance, of which the unit is identical with that of the map specified with mapName parameter.

queryParameterSet - Query parameters can query multiple layers of a map. The query parameters in a single layer can be set in queryParameterSet.queryParams[i] .

Returns:

Query result object.

support

public boolean support(java.lang.String mapName,
              MapCapability capability)

Description copied from interface: MapProvider

Determines whether the map supports the specified function.

Specified by:

support in interface MapProvider

Overrides:

support in class TiledMapProviderBase

Parameters:

mapName - The map name.

capability - Function type.

Returns:

true means to support; otherwise, false.

outputImage

protected byte[] outputImage(MapParameter param,
                 ImageOutputOption outputOption,
                 double currentResolution)

Description copied from class: TiledMapProviderBase

Output image in real time. It is stored in the specified path according to the map parameter.

Overrides:

outputImage in class TiledMapProviderBase

Parameters:

param - Map status

outputOption - Image parameter

currentResolution - Resolution

getTileImage

protected byte[] getTileImage(TiledMapProviderBase.TileImageParameter tileParam)

Specified by:

getTileImage in class LocalTileProviderBase

getSupportResolutions

public double[] getSupportResolutions(java.lang.String mapName)

Description copied from class: TiledMapProviderBase

Returns the resolution of the current service support. If all resolutions are supported, empty is returned.

Specified by:

getSupportResolutions in class TiledMapProviderBase

Parameters:

mapName - The map name.

Returns:

The resolution array.

initSupportedMapNames

protected java.util.List<java.lang.String> initSupportedMapNames()

Description copied from class: TiledMapProviderBase

Initializes the supported map list.

Specified by:

initSupportedMapNames in class TiledMapProviderBase

Returns:

The map name list.

initDefaultMapParameter

protected java.util.Map<java.lang.String,MapParameter> initDefaultMapParameter()

Description copied from class: TiledMapProviderBase

Initializing the default map status, a mapping object will be returned, of which the key is map name, valude is map parameter object.

Specified by:

initDefaultMapParameter in class TiledMapProviderBase

Returns:

Map status mapping. The key is the map name, and the value is the map parameter object.

getSupportImageFormat

public OutputFormat[] getSupportImageFormat(java.lang.String mapName)

Description copied from class: TiledMapProviderBase

Return the supported image formats.

Specified by:

getSupportImageFormat in class TiledMapProviderBase

Parameters:

mapName - The map name.

Returns:

Supported image format array

getOrigin

protected Point2D getOrigin(java.lang.String mapName)

Description copied from class: TiledMapProviderBase

Get the geographical coordinate of left upper corner of the map.

Specified by:

getOrigin in class TiledMapProviderBase

Parameters:

mapName - The map name.

Returns:

The geographical coordinate of left upper corner of the map.

cacheEnabled

protected boolean cacheEnabled()

Specified by:

cacheEnabled in class TiledMapProviderBase

isResolutionEquals

protected boolean isResolutionEquals(double resolution1,
                         double resolution2)

Description copied from class: TiledMapProviderBase

Determines if two resolutions are within the tolerance (1.0E-6)

Overrides:

isResolutionEquals in class TiledMapProviderBase

Parameters:

resolution1 - double

resolution2 - double

Returns:

Is it equal

getVectorStyle

public VectorStyle getVectorStyle(java.lang.String mapName,
                         java.lang.String[] layerNames,
                         VectorStyleType type)

Description copied from interface: MapProvider

Gets the specified vector layer style in the specified map.

Specified by:

getVectorStyle in interface MapProvider

Overrides:

getVectorStyle in class TiledMapProviderBase

Parameters:

mapName - The map name.

layerNames - The layer name.

type - The vector style type.

Returns:

Vector layer style.