ArcGIS Runtime For Android

2,086 阅读7分钟

基本概念

  • 空间参考

GIS的空间参考,包含坐标系和其他相关空间属性 。空间参考是用于存储各要素类和栅格数据集,以及其他坐标属性(例如,x,y 坐标的坐标分辨率及可选的 z 坐标和测量 (m) 坐标)的坐标系。如果需要,可使用表示表面高程的 z 坐标为数据集定义一个垂直坐标系。

  • 地图控件

    <com.esri.android.map.MapView
         android:id="@+id/mapView"
         android:layout_width="match_parent"
         android:layout_height="match_parent"  />
    

MapView 是 ArcGIS Runtime SDK for Android 的核心组件,通过 MapView 可以呈现地图服务的数据,并且在 MapView 中定义了丰富的属性、方法和事件,用户通过 MapView 可以操作地图,默认 MapView 提供了缩放、ping'yi操作。MapView是Android中ViewGroup的子类,也是 ArcGIS Runtime SDK for Android 中的地图容器 。

MapView 可以添加一个或多个图层,图层又分很多种, 并且图层只有添加到 MapView 容器中才会显示。通过 MapView 可以设置地图的显示范围、是否允许被旋转、地图背景、地图的最大/最小分辨率及其指定当前显示的分辨率/比例尺。MapView还 提供了丰富的手势监听接口,通过这些监听器,可以监听各种手势动作,如点击、双击、移动或长按等操作。

  • 图层

图层是 GIS 中很重要的概念,图层是空间数据的载体,通过它可将各种类型的地图数据进行加载显示,是几何图形和其对应属性信息的集合。各种图层尤其自己的作用,下图是图层的继承关系图:

enter image description here

文章地址

地图图层加载

所有的图层都继承自Layer,地图控件为我们提供了addLayer()方法,所以需要添加图层的时候我们使用addLayer方法将图层添加到map中。

  • ArcGISLocalTiledLayer

    ArcGISLocalTiledLayer 是用来添加离线数据包的图层,该图层目前支持两种格式的离线数据:一个是紧凑型的缓存切片,另一个是打包的 tpk 格式的数据。

ArcGISLocalTiledLayer tileLayer = new ArcGISLocalTiledLayer("file://" + mapPath + "/" + fileName);//实例化图层
tileLayer.setVisible(false);//控制图层显示与否;
tileLayer.setName(fileName);//设置图层的名称
tileLayer.setOpacity();//设置图层的不透明度
mapView.addLayer(tileLayer);//添加图层到地图窗口中
  • ArcGISTiledMapServiceLayer

ArcGISTiledMapServiceLayer 图层用于显示 ArcGIS for Server 服务中的切片数据, 不能对图层中的数据进行更改,除非更新服务缓存。因为是使用服务切出来的PNG格式的图片数据,在 arcgis for android中,无法对此类型的数据查询,常用做底图使用。 因为是缓存数据,这个类型的图层是请求最快的图层之一。

 String url ="https://services.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer";
ArcGISTiledMapServiceLayer serviceLayer=new  ArcGISTiledMapServiceLayer(url );
mapView.addLayer(serviceLayer);//添加图层到地图窗口中
  • ArcGISDynamicMapServiceLayer

ArcGISDynamicMapServiceLayer 图层用于显示动态地图服务的数据,服务端根据移动设备的屏幕显示范围、地图比例尺返回请求数据,用法与 ArcGISTiledMapServiceLayer 图层相同。

ArcGISDynamicMapServiceLayer图层通常包含多个图层,这些图层由 server 根据请求来渲染并以图片形式返回。其功能特点是更新非常方便,并能及时呈现给用户,同时,图层的可视性和空间参考可以改变,可以给图层添加单独的 layer definition,ArcGIS Server 为每个 image 动态投影。而地图的空间参考是由第一个加载的图层决定。

性能特点:它的渲染时间取决于请求数据的数量和复杂度,因此一般都比 tiled map server 要慢,它适合数据经常发生改变、或者需要针对不同的用户呈现不同的数据,且要素信息不需要的情况。

String  tiledLayerAddress="http://10.200.3.210:6001/arcgis/rest/services/ranqimap/gw2016_3/MapServer";
ArcGISDynamicMapServiceLayer agsDMS =new ArcGISDynamicMapServiceLayer(tiledLayerAddress);
mapView.addLayer(tiledLayerAddress);//添加图层到地图窗口中
  • ArcGISImageServiceLayer

ArcGISImageServiceLayer 图层用于显示影像服务数据

String url="http://myserver/arcgis/rest/services/MyImage/ImageServer" 
ArcGISImageServiceLayer imgserviceLayer =new ArcGISImageServiceLayer(url,null);//option
mapView.addLayer(tiledLayerAddress);//添加图层到地图窗口中

  • BingMapLayer

ArcGIS Runtime for Android中也可以添加Bing地图服务,首先必须注册账户并获取Bing map的App ID,有了这个 ID 就有了使用 Bing 地图的权限,具体的账户申请和操作步骤可以参照以下地址: 地址:www.bingmapsportal.com/ 详细说明:msdn.microsoft.com/en-us/libra…

<com.esri.android.map.MapView
android:id="@+id/map"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
url="http://www.arcgis.com/home/item.html?id=2b571d8c079d46b4a14a67df42b1da6f"
appId=""> </com.esri.android.map.MapView>

也可以通过代码的方式动态添加图层:

BingMapsLayer blyr=new BingMapsLayer("你的Bingmap ID",地图风格); 
mapView.addLayer(blyr);//添加图层到地图窗口中

地图风格有如下几种:

AERIAL("Aerial"),
AERIAL_WITH_LABELS("AerialWithLabels"),
ROAD("Road");
  • GraphicsLayer

Graphic 是 ArcGIS Runtime for Android 中比较重要的图层类型,也是使用最为频繁的一个。GraphicsLayer 可以包含一个或多个 Graphic 对象,查询的返回结果和动态标绘的 Graphic 数据都要通过它呈现。建议在 MapView 中添加图层时不要第一个添加该类型的图层,因为 MapView 加载图层时先要初始化一些地图参数,而该图层不具备这些参数。

除了可以呈现 Graphic 对象外,它还具备了一些其他有用的功能,如要素更新与要素获取等等,由类 GraphicsLayer 处理,GraphicsLayer 是由应用程序来定义的图层,专门用来绘制有空间参考的要素,并不适合绘制 non-geographical 要素,如指北针或 copyright text。可以用屏幕坐标来查询图层中的要素并且使getGraphics()方法返回要素,并且支持设置图层比例尺。

不推荐在 graphics layer 中存放太多的要素,但是,它有着不错的性能,并且是 feature layer class的基类,如果必须要处理大量的要素,建议使用 feature collection 来存储在 feature layer 中。

 GraphicsLayer graphicsLayer=new GraphicsLayer();
mapView.addLayers(graphicsLayer);
  • ArcGISFeatureLayer

ArcGISFeatureLayer 显示Feature Service提供的数据,与其它图层类型相比具有最丰富的功能,其中的每个要素都能被查询,和SQL 语句过滤,继承自 GraphicsLayer。

该图层可以是空间图层,也可以是非空间的表,它包含了很多要素的信息,每个要素单独渲染,从 ArcGIS Server Feature Service 或者 map service(此种 feature layer 不能编辑)中请求要素,并返回 JSON 格式的数据并绘制。加载速度就相对较慢。

只有 Feature Service 才可以具备在线数据编辑功能,如果想要对某个数据进行在线编辑或同步,需要将其发布成 Feature Service,并在移动端新建一个 ArcGISFeatureLayer 图层以加载该服务。该图层有一些设定,这些设定能影响图层的性能,包括请求时间,返回大小、处理和响应时间等(设置需要在图层initialized 完成之后进行)。 ArcGISFeatureLayer 在可以设置 3 种模式(mode),不同模式返回数据的方式和执行的效率不同

String url = "https://servicesbeta.esri.com/ArcGIS/rest/services/SanJuan/TrailConditions/FeatureServer/0"; 
MapView mv = new MapView(this); 
mv.addLayer(new ArcGISFeatureLayer(url,MODE.SNAPSHOT));//按照快照方式 
  • 本地矢量数据

FeatureLayer支持两种格式的矢量图层数据(Shp,geodatabase),通用的SHP文件直接可以在里边加载,另外使用ArcMap发布的geodabase数据库文件数据也可以直接打开。我们推荐使用geodatabase数据库文件的数据进行地图的浏览,因为geodatabase数据库数据中包含了简单的符号化。

  • 加载SHP文件数据
ShapefileFeatureTable fTab = new ShapefileFeatureTable(dataFile.getAbsolutePath()); 
FeatureLayer fLayer = new FeatureLayer(fTab); // 
SimpleFillSymbol fillSymbolRender = new SimpleFillSymbol(Color.parseColor("#"));
Renderer renderer = new SimpleRenderer(fillSymbolRender);
fLayer.setRenderer(renderer);//图层符号化;
mapView.addLayer(fLayer);
  • 加载geodataabase数据文件
Geodatabase dataBase = new Geodatabase(dataFile.getAbsolutePath());
List<GeodatabaseFeatureTable> gfts = dataBase.getGeodatabaseTables();
if (gfts.size() > 0) {
 int lyrCnt = gfts.size();
 for (int j = lyrCnt - 1; j > -1; j--) {
     GeodatabaseFeatureTable gft = gfts.get(j);
     // String layerName = gft.getFeatureServiceLayerName();
     FeatureTable tab = (FeatureTable) gft;
     //featurecount += tab.getNumberOfFeatures();
     FeatureLayer featureLayer = new FeatureLayer(tab);
     featureLayer.setName(tab.getTableName());
     featureLayer.setVisible(false);
     featureLayer.setEnableLabels(true);
     //Log.i("TabeName",tab.getTableName());
    Geometry.Type geoType = featureLayer.getGeometryType();
    //Log.i("GeoType", geoType.toString());
    //mMapView.addLayer(featureLayer);
    mapView.addLayer(featureLayer);
}
}

文章地址

图形绘制

绘制的逻辑:

enter image description here
地图中应该包含绘制层---------->GraphicsLayer 在界面上,点击按钮向系统发送命令-------->需要一个枚举类,存放命令 地图需要监听点击事件 ---------->OnSingleTapListener 每个图形需要一个默认的符号------>Symbol 图形是根据点来绘制的,所以需要保存图形的点数据------->List