ArcGIS Runtime For Android

基本概念

• 空间参考

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 中很重要的概念，图层是空间数据的载体，经过它可将各类类型的地图数据进行加载显示，是几何图形和其对应属性信息的集合。各类图层尤为本身的做用，下图是图层的继承关系图：

文章地址

地图图层加载

全部的图层都继承自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);
}
}
复制代码

文章地址

图形绘制

绘制的逻辑：

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