ArcGIS Runtime for Android开发教程V2.0(4)基础篇---MapView

时间:2022-02-19 07:09:38

原文地址:

ArcGIS Runtime for Android开发教程V2.0(4)基础篇---MapView - ArcGIS_Mobile的专栏 - 博客频道 - CSDN.NET
http://blog.csdn.net/arcgis_mobile/article/details/8147328

MapView是ArcGIS Runtime SDK forAndroid的核心组件,通过MapView可以呈现地图服务的数据,并且在MapView中定义了丰富的属性、方法和事件,用户通过MapView可以操作设备的触摸屏,默认MapView可以响应用户的各类手势的操作,在GIS的开发中,什么时候都少不了地图操作。MapView是Android中ViewGroup的子类,也是ArcGIS Runtime SDK for Android中的地图容器,与很多ArcGIS API中的Map、MapControl类作用是一样的。

1、 MapView功能介绍

       MapView的强大不仅仅是因为它是呈现地图数据的容器,MapView为我们提供丰富的功能,下面来分析MapView为我们提供哪些功能。

     首先,MapView具有呈现地图能力,MapView可以添加一个或多个图层,图层又分很多种,如:切片图层、动态图层、本地图层等等,图层只有添加到MapView容器中才能进行显示。

       其次,通过MapView我们可以设置地图的显示范围、是否允许被旋转、地图背景、地图的最大/最小分辨率及其指定当前显示的分辨率/比例尺。

最后,我们来看一下MapView提供的丰富手势监听接口,通过这些监听器,可以监听我们各种手势动作,如:点击、双击、移动或长按等等操作。

2、 MapView添加方式

      我们有两种方式可以将MapView添加到我们的应用当中:一个是XML方式,另一个是硬编码方式;我们多采用XML方式,方便调整布局及其属性的相关设置。

l XML方式:

<com.esri.android.map.MapView

        android:id="@+id/map"

        android:layout_width="fill_parent"

        android:layout_height="match_parent">

</com.esri.android.map.MapView>

l 硬编码方式:

MapView map = new MapView(this);

map.setLayoutParams(new LayoutParams(LayoutParams.FILL_PARENT, LayoutParams.FILL_PARENT));

tileLayer = new ArcGISTiledMapServiceLayer("http://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer");

map.addLayer(tileLayer);

setContentView(map );

3、地图缩放、旋转和坐标转换

         地图缩放,是地图中最基本的功能,我们可以是使用MapView进行地图的缩放,MapView提供了多种地图缩放的方式,如代码所示:

mMapView.zoomin();

        mMapView.zoomout();

        mMapView.zoomToResolution(centerPt,res);

        mMapView.zoomToScale(centerPt,scale);

对于上面的几种缩放方式前两种主要的功能是逐级缩放,也就是说当我们调用一次zoomin()方法地图将放大一级,调用一次zoomout()方法地图将缩小一级。

而对于后两种缩放,它们是按照不同的分辨率或比例尺进行缩放的,调用zoomToResolution(centerPt, res)方法进行缩放时,我们需要传入两个参数,第一参数centerPt为我们要按照哪个中心点进行缩放,因此我们需要传入一个Point对象才行,第二个参数为要缩放到的分辨率;对于zoomToScale(centerPt, scale)来说,和zoomToResolution(centerPt, res)很类似,两个方法第一个参数是相同的,而第二个参数不再是分辨率,是要传入地图的比例尺。

这里的分辨率或比例尺值与我们的发布的服务密切相关,发布的地图服务如果生成了缓存切片,在服务中我可以看到不同级别对应的比例尺和分辨率,如图:

ArcGIS Runtime for Android开发教程V2.0(4)基础篇---MapView

服务地址:http://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer

MapView还可以设置地图的显示范围、比例尺、分辨率、旋转角度和地图背景色,如:

map = (MapView)findViewById(R.id.map);

……

Envelope env = new Envelope(12957628.58241, 4864247.2803126, 12958114.4225065, 4864490.20036087);//范围

map. setExtent(env)//设置地图显示范围

map. setScale(295828763);//当前显示的比例尺

map. setResolution(9783.93962049996);//设置当前显示的分辨率

//上面三个方法都可以改变地图的显示范围,在代码中是不会同时使用的

map.setMapBackground(0xffffffff, Color.TRANSPARENT, 0, 0);//设置地图背景

map.setAllowRotationByPinch(true);//是否允许使用Pinch方式旋转地图map.setRotationAngle(15.0); //初始化时将地图旋转15度,参数为正时按逆时针方向旋转。

除了上面的功能,MapView还有一主要的功能:“坐标转换”,这里所说的坐标转换是指,怎样把屏幕坐标转换成空间坐标或将空间坐标转换成屏幕坐标,如:

//给地图添加一个点击事件监听

map.setOnSingleTapListener(newOnSingleTapListener() {

            publicvoid onSingleTap(float x, float y) {

                // TODO Auto-generated method stub

Point pt = map.toMapPoint(x,y);//屏幕坐标转换成空间坐标

Point screenPoint = map. toScreenPoint(pt);//转换成屏幕坐标对象

            }

});

 

4 、地图监听器

       对于移动端手势的监听是一个比较重要的环节,对于地图的手势操作也是由MapView来管理的,主要有以下几种监听:

l 地图单击监听:OnSingleTapListener

l 平移监听:OnPanListener

l 长按监听:OnLongPressListener

l 缩放监听:OnZoomListener

l 状态监听:OnStatusChangedListener

l pinch监听:OnPinchListener

       有了这些监听我们就可以对地图无所以为操作,对于这些监听在此不过多解释,如果想详细了解这些监听的用法可查看3.4节(地图事件)。

       到此,所有关于MapView的介绍告一段落,下面进入Layer世界。