MapView

Inflate the MapView object from XML and apply a class-specific base style. This constructor of MapView allows subclasses to use their own base style when they are being inflated.

This constructor is called when the MapView object is being inflated from XML. Attributes that are specified in the XML are used to help inflate this object. This constructor, by default, uses a style of 0. This implies that the only attribute values that are applied are those in Android's Context's Theme and the given attributes stipulated in the XML. The inherited method, onFinishInflate(), is called after all the children have been added.

The constructor is used if you are instantiating the MapView using Java code (see the class description for an example of this usage).

The constructor is used if you are instantiating the MapView using Java code (see the class description for an example of this usage).

The constructor is used if you are instantiating the MapView using the URL of a WebMap. If you need to add a layer above such a MapView, you should invoke addLayer(Layer) in an OnStatusChangedListener.

Java code sample to add a GraphicsLayer on top of the WebMap:

 
 MapView mv = new MapView(this, "http://www.arcgis.com/home/item.html?id=12345", "myname", "mypassword");
 setContentView(mv);
 
 mv.setOnStatusChangedListener(new OnStatusChangedListener() {
   private static final long serialVersionUID = 1L;
 
   public void onStatusChanged(View source, STATUS status) {
     if (status == STATUS.INITIALIZED) {
 
       // add a graphics layer
       mv.addLayer(new GraphicsLayer(this, new SimpleRenderer(new SimpleMarkerSymbol(Color.RED, 20, STYLE.DIAMOND)),
           null, null));
     }
   }
 });
 
 

The constructor is used if you are instantiating the MapView using the URL of a WebMap. If you need to add a layer above such a MapView, you should invoke addLayer(Layer) in an OnStatusChangedListener.

Java code sample to add a GraphicsLayer on top of the WebMap:

 
 MapView mv = new MapView(this, "http://www.arcgis.com/home/item.html?id=12345", "myname", "mypassword");
 setContentView(mv);
 
 mv.setOnStatusChangedListener(new OnStatusChangedListener() {
   private static final long serialVersionUID = 1L;
 
   public void onStatusChanged(View source, STATUS status) {
     if (status == STATUS.INITIALIZED) {
 
       // add a graphics layer
       mv.addLayer(new GraphicsLayer(this, new SimpleRenderer(new SimpleMarkerSymbol(Color.RED, 20, STYLE.DIAMOND)),
           null, null));
     }
   }
 });
 
 

The constructor is used if you are instantiating the MapView using the URL of a WebMap. If you need to add a layer above such a MapView, you should invoke addLayer(Layer) in an OnStatusChangedListener.

Java code sample to add a GraphicsLayer on top of the WebMap:

 
 MapView mv = new MapView(this, "http://www.arcgis.com/home/item.html?id=12345", "myname", "mypassword");
 setContentView(mv);
 
 mv.setOnStatusChangedListener(new OnStatusChangedListener() {
   private static final long serialVersionUID = 1L;
 
   public void onStatusChanged(View source, STATUS status) {
     if (status == STATUS.INITIALIZED) {
 
       // add a graphics layer
       mv.addLayer(new GraphicsLayer(this, new SimpleRenderer(new SimpleMarkerSymbol(Color.RED, 20, STYLE.DIAMOND)),
           null, null));
     }
   }
 });
 
 

The constructor is used if you are instantiating the MapView using a WebMap. If you need to add a layer above such a MapView, you should invoke addLayer(Layer) in an OnStatusChangedListener.

Java code sample to add a GraphicsLayer on top of the WebMap:

 
 MapView mv = new MapView(this, webmap, null, null);
 setContentView(mv);
 
 mv.setOnStatusChangedListener(new OnStatusChangedListener() {
   private static final long serialVersionUID = 1L;
 
   public void onStatusChanged(View source, STATUS status) {
     if (status == STATUS.INITIALIZED) {
 
       // add a graphics layer
       mv.addLayer(new GraphicsLayer(this, new SimpleRenderer(new SimpleMarkerSymbol(Color.RED, 20, STYLE.DIAMOND)),
           null, null));
     }
   }
 });
 
 

Instantiates an object of MapView from a webmap. The MapView contains the operational layers from the given webmap and the basemap layers from the give basemap.

Adds the child Layer at the given index.

The index position is zero-based, meaning that a value of 0 represents the first Layer to be drawn by the MapView.

An index number out of current index range is not allowed. For instance, if you have 3 layers with index 0, 1, and 2, then you cannot add the next Layer with an index position of 3.

Adds the child Layer. The new layer is placed on top of the map.

Adds the Layer array.

If the MapView is initialized, centers the map at the given point.

Returns a swatch image of the given geometry rendered with the specified symbol.

Returns a swatch image array of for the given geometries rendered with the symbols.

Enable or disable the map wrap around feature. The following following requirements must be satisfied before enabling wrap around: (1)The map's full envelope must cover the entire world; (2)The map's spatial reference must either be WGS84(WKID=4326) or Web Mercator(WKID=102113, 102100, or 3857) (3)Dynamic layers must be based on map services from ArcGIS Server 10.0 or higher.

Returns a callout window.

Returns the center of the MapView as an ArcGIS geometry Point. Use this Point object to obtain (x, y) coordinates, or spatial reference, and so on.

Creates a drawing cache of the map in the given extent.

Returns a polygon comprising of four corners of map in map coordinates. The first vertex in polygon represents top-left corner. The second vertex represents top-right corner. The third vertex represents bottom-right corner. The fourth vertex represents bottom-left corner.

Returns the Grid instance of the map which allows for the type and visibility of the grid to be controlled.

Gets a layer at the given index.

Gets a layer by its ID.

Gets a layer by its service URL.

Returns all child Layers that are added to the MapView. The Layer array will be a zero based array, meaning Layer[0] will give you the first Layer that is drawn by the MapView.

Returns the unique instance of the location service.

Returns the boundary extent of the map. The boundary extent imposes an restriction on the viewable area of the map. The center of the map can not go beyond boundary extent when you navigate the map.

Gets the maximum resolution of the MapView.

Gets the minimum resolution of the map. The map can not zoom beyond the resolution range determined by minimum resolution and maximum resolution.

Gets the OnLongPressListener of the MapView.

Gets the OnPanListener of the MapView.

Gets the OnPinchListener of the MapView.

Gets the onSingleTapListener of the MapView.

Gets the OnStatusChangedListener of the MapView.

Gets the OnZoomListener of the MapView.

Returns the resolution of the MapView.

Returns the current map rotation angle(in degree).

A convenience method for obtaining the current map scale .

Returns the spatial coordinate system being used by the MapView.

Returns true if the rotation by pinch is allowed.

Returns true if the MapView is initialized.

Returns true if the MapView has been recycled.

Pauses the map. Threads related to map rendering will hang until unpause is called. It is recommended that you call this method when your Activity goes to background(usually in Activity.onPause()) since map will burn less battery when it pauses.

Releases the resources referenced by the MapView so that they can be recycled.

Removes all child layers from the map.

Removes a child layer at the given index. See the addLayer(Layer, int) method for details on the index.

Removes the child Layer from the parent MapView.

Restores the center and resolution of the MapView from the given String that is typically setup in an Activity's onPause() method (see MapView's retainMapInfo() method for details). Use the SharedPReferences object to retrieve the preferences, which includes the center of the map and current the map resolution and pass that object into this method to restore the MapView's state. Typically, this method should be called when an Activity containing the MapView moves into the onResume state in the Activity's life cycle.

 // The onResume() method is being overridden for an Activity
 // The map object is of type MapView
 protected void onResume() {
   super.onResume();
   SharedPreferences prefs = getPreferences(0);
   map.restoreState(prefs.getString("my map state", ""));
 }
 

The MapView's state should be persisted using a String object. When calling this method , the center of the map and the current map resolution are returned as a String. Typically, this method should be called when an Activity containing the MapView moves into the onPause state in the Activity's life cycle.

The following example code illustrates the purpose of this method:

 
 // The onPause() method is being overridden for an Activity
 // The map object is of type MapView
 super.onPause();
 SharedPreferences.Editor editor = getPreferences(0).edit();
 editor.putString("my map status", map.retainState());
 editor.commit();
 

Allows/disallow pinch to rotate.

Turns on or off the ESRI logo.

Zooms into the given geometry so that geometry fits the bounds of the map. If padding is bigger than zero, a space between map bounds and geometry will be added so that the geometry does not touch any edge of the map. If geometry type is point, map will center at the given point and padding is ignored.

This method will zoom map into the given geometry and use its bound as current map extent. Internally it calls setExtent(Geometry, int) method with padding zero.

Sets the map background with color and grid.

Sets the maximum resolution of the MapView.

Sets the minimum resolution of the map.

Sets the OnLongPressListener of the MapView.

Sets the OnPanListener of the MapView.

Sets the onPinchListener of the MapView.

Sets the onSingleTapListener of the MapView.

Sets the OnStatusChangedListener of the MapView.

Sets the OnZoomListener of the MapView.

Sets the resolution of the MapView.

The method will rotate the map in the given angle(in degree) and re-center the map at a map point(x and y in map unit); if the given angle number is positive, map will rotate anti-clockwise. Otherwise it will rotate clockwise.

The method will rotate the map in the given angle(in degree) at a screen point(x and y in pixel); if the given angle number is positive, map will rotate anti-clockwise. Otherwise it will rotate clockwise.

The method will rotate the map in the given angle(in degree) at a screen point(x and y in pixel); if the given angle number is positive, map will rotate anti-clockwise. Otherwise it will rotate clockwise.

A convenience method for setting the map scale .

A convenience method that will convert a device's screen coordinates to an ArcGIS geometry Point that has the same spatial coordinate system as the MapView's.

A convenience method that will convert a device's screen coordinates into an ArcGIS geometry Point that has the same spatial coordinate system as the MapView's.

A convenience method that will convert an ArcGIS geometry Point from the MapView's spatial coordinate system into the device's screen coordinates. The return value is an ArcGIS geometry Point to make it easier for you to supply the Point as input for other methods in the ArcGIS API for Android.

Unpauses the map. Threads related to map rendering resume running. If you call pause when your Activity goes to background, you must call this method when your Activitiy is brought to front(usually in Activity.onResume()).

If the MapView is initialized, zooms the map by a factor to the given center point.

Centers the map on the given point and zoom into the given resolution level.

Centers the map on the given point and zoom into the given scale level.

Zooms in one level from current map resolution.

Zooms out one level from current map resolution.