com.supermap.services.providers

Class ArcGISRestMapProvider

java.lang.Object

com.supermap.services.components.spi.TiledMapProviderBase

com.supermap.services.providers.RemoteTileProviderBase

com.supermap.services.providers.ArcGISRestMapProvider

All Implemented Interfaces:

Disposable, MapProvider, ProviderContextAware

public class ArcGISRestMapProvider
extends RemoteTileProviderBase

ArcGIS Rest map service provider.

ArcGISRestMapProvider supports drawing operations and map queries. The map query function provided by the Query resource of ArcGIS REST map service, and support sql query, spatial query, scope query; Do not support distance inquiries, recent feature query; Unsupported query parameters are: query start record location, expect to return the number of records, only return to the ground information.

• Notes:
• Docking Query Parameters: geometry, geometryType, where, objectIds, outFields, returnGeomery, orderByFields (ArcGIS 10.1 or higher version). outStatistics (ArcGIS 10.1 or higher).
• Supported spatial query relations: INTERSECT, CONTAIN, CROSS, TOUCH, WITHIN and OVERLAP.

Nested Class Summary

Nested classes/interfaces inherited from class com.supermap.services.providers.RemoteTileProviderBase

RemoteTileProviderBase.GetDefaultImageWhenException

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.RemoteTileProviderBase

SEND_REQUEST_COUNT

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
ArcGISRestMapProvider() Default constructor.
ArcGISRestMapProvider(ArcGISRestMapProviderSetting setting) Constructors with parameters

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	cacheEnabled()
protected void	checkSetting(MapProviderSetting setting) Checks the configuration of map service provider.
MapImage	getMapImage(MapParameter mapParameter, ImageOutputOption outputOption) Gets map images according to map parameters and image output settings.
protected Point2D	getOrigin(java.lang.String mapName) Get the geographical coordinate of left upper corner of the map.
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 TiledMapProviderBase.TileDataConverter	getTileDataConverter()
protected byte[]	getTileImage(TiledMapProviderBase.TileImageParameter parameter)
protected java.lang.String	getTileImageUrl(TiledMapProviderBase.TileImageParameter parameter)
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)
QueryResult	queryByBounds(java.lang.String mapName, Rectangle2D bounds, QueryParameterSet queryParameterSet) Queries the geometries in the specified range on the map.
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.
boolean	support(java.lang.String mapName, MapCapability capability) Determines whether the map supports the specified function.

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

dispose, generateBigImage, getContent, getContent, getContent, getImageBySendURL, getImageBySendURL, init, sendRequestByHttpURLConnection, sendRequestByHttpURLConnection, viewEntire

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

clearCache, fillWatermark, findNearest, getDefaultMapParameter, getDefaultMapParameters, getMapParameter, getMapProviderSetting, getNames, getOverview, getProximalResolution, getProximalResolution, getResolutoinByScale, getResource, getResource, measureArea, measureDistance, outputImage, outputImage, outputImageToFile, outputImageToFile, queryByDistance, rectifyMapParameter, setDefaultMapParameter, setDefaultMapParameters, setMapProviderSetting, setProviderContext, updateMap

Methods inherited from class java.lang.Object

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

Constructor Detail

ArcGISRestMapProvider

public ArcGISRestMapProvider(ArcGISRestMapProviderSetting setting)

Constructors with parameters

Parameters:

setting - Configure by ArcGIS Rest service provider

ArcGISRestMapProvider

public ArcGISRestMapProvider()

Default constructor.

Method Detail

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.

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.

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.

getTileImageUrl

protected java.lang.String getTileImageUrl(TiledMapProviderBase.TileImageParameter parameter)

Specified by:

getTileImageUrl in class RemoteTileProviderBase

getTileImage

protected byte[] getTileImage(TiledMapProviderBase.TileImageParameter parameter)

Overrides:

getTileImage in class RemoteTileProviderBase

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.

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.

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.

checkSetting

protected void checkSetting(MapProviderSetting setting)

Description copied from class: TiledMapProviderBase

Checks the configuration of map service provider.

Overrides:

checkSetting in class TiledMapProviderBase

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.

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.

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

cacheEnabled

protected boolean cacheEnabled()

Specified by:

cacheEnabled in class TiledMapProviderBase

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.

getTileDataConverter

protected TiledMapProviderBase.TileDataConverter getTileDataConverter()

Overrides:

getTileDataConverter 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.