AGSOpenStreetMapLayer Class Reference

---

Description

An instance of this class allows you display maps from Open Street Map.

In a Model-View-Controller architecture, this object represents the Model. The corresponding View object, AGSTiledLayerView, is created when this object is added to the map.

Defined in:

AGSOpenStreetMapLayer.h ( ArcGIS library)

Since:

1.0

Inheritance diagram for AGSOpenStreetMapLayer:

List of all members.

Public Member Functions
((deprecated)	- __attribute__
(void)	- dataChanged
(void)	- layerDidFailToLoad:
(void)	- layerDidLoad
(NSOperation< AGSTileOperation > *)	- retrieveImageAsyncForTile:
Static Public Member Functions
(AGSOpenStreetMapLayer *)	+ openStreetMapLayer
Properties
id< AGSLayerDelegate >	delegate
NSError *	error
AGSEnvelope *	fullEnvelope
AGSEnvelope *	initialEnvelope
BOOL	loaded
NSString *	name
NSOperationQueue *	operationQueue
BOOL	renderNativeResolution
AGSSpatialReference *	spatialReference
id< AGSTiledLayerTileDelegate >	tileDelegate
AGSTileInfo *	tileInfo
BOOL	timeAware
AGSUnits	units

---

Member Function Documentation

- ((deprecated) __attribute__

AGSOpenStreetMapLayer maintains a local cache on the device containing tiles retrieved from the map service. This makes redrawing the map much faster and also reduces overall network usage. This method can be used to clear the local cache.

Returns:

Returns NO if no tiles are removed from cache.

Since:

1.0

Deprecated:

Use [AGSTileRequestOperation clearAGSTiles] instead.

- (void) dataChanged

This method tells the layer that the data has changed and it should be redrawn.

Since:

1.0

Implemented in AGSGraphicsLayer.

- (void) layerDidFailToLoad:

(NSError *)

error

Method to notify the delegate that a layer failed to load. This method will also post a "LayerFailedToLoad" notification that can be observed by the developer.

Parameters:

error

Information regarding the cause of the layer failing to load.

Since:

1.0

- (void) layerDidLoad

Method to notify the delegate that a layer successfully loaded. This method will also post a "LayerDidLoad" notification that can be observed by the developer.

Since:

1.0

+ (AGSOpenStreetMapLayer*) openStreetMapLayer

Return an initialized, auto released, layer.

Since:

1.8

- (NSOperation<AGSTileOperation>*) retrieveImageAsyncForTile:

(AGSTile *)

tile

Retrieve tile asynchronously. This method must be implemented by subclasses.

Parameters:

tile

The tile to get image for.

Returns:

NSOperation that implements the protocol AGSTileOperation for current tile request.

Since:

1.0

See also:

AGSTiledLayerTileDelegate

---

Property Documentation

- (id<AGSLayerDelegate>) delegate [read, write, assign, inherited]

Delegate to be notified when the layer is loaded or fails to load. When this layer is loaded, a corresponding AGSLayerView object is automatically set as the delegate. This delegate must not be replaced.

Since:

1.0

- (NSError*) error [read, retain, inherited]

Information about the error associated with a layer.

Since:

1.0

- (AGSEnvelope*) fullEnvelope [read, retain]

Full extent of OpenStreetMap.

Since:

1.0

Implements AGSLayer.

- (AGSEnvelope*) initialEnvelope [read, retain]

Initial extent of OpenStreetMap.

Since:

1.0

Implements AGSLayer.

- (BOOL) loaded [read, assign, inherited]

A property indicating whether the layer is loaded and ready to be used. When the layer is loaded, the value becomes YES, and layer properties can be accessed.

Since:

1.0

See also:

AGSLayerDelegate

- (NSString*) name [read, retain, inherited]

The name of the layer. This property will be set by the framework when the layer is added to the map.

Since:

1.8

- (NSOperationQueue*) operationQueue [read, retain, inherited]

Operation queue used by tiled layer to make asynchronous requests. Default operation queue size is 4.

Since:

1.0

- (BOOL) renderNativeResolution [read, assign, inherited]

Gets a value that determines if the layer renders at the native resolution. This property will not have any affect on iOS devices without a retina display. If using an iOS device with a retina display and you want to take advantage of that display you can set this value to YES. If YES, this layer will use more memory and network bandwidth, but the layer will render at a higher resolution. This property is not settable for every layer type.

Since:

2.1

Implemented in AGSGPResultLayer, AGSGraphicsLayer, AGSDynamicMapServiceLayer, AGSImageServiceLayer, AGSTiledMapServiceLayer, and AGSLocalTiledLayer.

- (AGSSpatialReference*) spatialReference [read, retain]

Spatial Reference used by OpenStreetMap.

Since:

1.0

Implements AGSLayer.

- (id<AGSTiledLayerTileDelegate>) tileDelegate [read, write, assign, inherited]

Delegate to be notified when a tile is retrieved asynchronously. When this layer is loaded, a corresponding View object is automatically set as the tileDelegate which should not be replaced.

Since:

1.0

- (AGSTileInfo*) tileInfo [read, retain]

Tiling scheme used by OpenStreetMap.

Since:

1.0

Implements AGSTiledLayer.

- (BOOL) timeAware [read, assign, inherited]

A property indicating whether the layer is time-aware.

Since:

1.0

- (AGSUnits) units [read, write, assign, inherited]

The units the layer is in. Possible values include

• AGSUnitsCentimeters
• AGSUnitsDecimalDegrees
• AGSUnitsDecimeters
• AGSUnitsFeet
• AGSUnitsInches
• AGSUnitsKilometers
• AGSUnitsMeters
• AGSUnitsMiles
• AGSUnitsMillimeters
• AGSUnitsNauticalMiles
• AGSUnitsPoints
• AGSUnitsUnknown
• AGSUnitsYards

Since:

1.0