Arcgis for Android 10.2.9（1）

之前做的地图项目都是基于百度地图或者高德地图，这次项目里用到的是Arcgis，自然要学习起来了。
推荐看官方的文档入门：官方文档，下载需要注册，不过我已经下载好了下载链接。以上都是基于10.2.9版本的。github上也有官方示例代码链接，需要10.2.9版本的话可以在Branch中选择Tags为10.2.9的，直接点击Download ZIP下载。

1.引入

首先在Project的gradle配置中引入maven仓库地址：

repositories {
        google()
        jcenter()
        maven {
            url 'https://esri.bintray.com/arcgis'
        }
    }

然后在Module的gradle配置中添加依赖：

dependencies {
     ......
    compile 'com.esri.arcgis.android:arcgis-android:10.2.9'
}

可能会遇到Duplicate files copied in APK META-INF/LICENSE等重复文件问题
在APP的gradle文件里添加：

packagingOptions {
        exclude 'META-INF/LGPL2.1'
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/NOTICE'
    }

在Manifest文件中加入：

    <uses-feature
        android:glEsVersion="0x00020000"
        android:required="true"/>

    <uses-permission android:name="android.permission.INTERNET"/>

2.显示地图

在XML文件中加入MapView控件：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools">

    <android.support.constraint.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context="com.map.arcgistest.MainActivity">

        <com.esri.android.map.MapView
            android:id="@+id/mapView"
            mapoptions.MapType="SATELLITE"
            mapoptions.ZoomLevel="16"
            mapoptions.center="30.2872234998, 120.0115407685"
            android:layout_width="match_parent"
            android:layout_height="400dp" />

    </android.support.constraint.ConstraintLayout>
</layout>

我因为用了DataBinding所以最外层是<layout>
这样地图就显示出来了，注意MapView控件中还有3个mapoptins属性

//地图类型：卫星图，还有其他如STREETS 街道图、OCEAN海洋图等
//可以在MapOptions.MapType中看到
mapoptions.MapType="SATELLITE"
//缩放比例
mapoptions.ZoomLevel="16"
//地图中心纬经度，注意“,”后还有1个空格
mapoptions.center="30.2872234998, 120.0115407685"

如果你不加mapoptions.MapType属性，那么地图显示的是一片黑色，即使你用代码设置也没用

MapOptions mapOptions = new MapOptions(MapOptions.MapType.SATELLITE);
mapOptions.setCenter(30.2872234998,120.0115407685);
mapOptions.setZoom(10);
mActivityMainBinding.mapView.setMapOptions(mapOptions);

因为MapView只是一个容器，具体的内容需要你加，这里就涉及到图层Layer的概念，你需要添加一个图层：

private static final String DEFAULT_BASEMAP_SERVICE_URL = "http://services.arcgisonline.com/ArcGIS/rest/services/ESRI_StreetMap_World_2D/MapServer";
mapView.addLayer(new ArcGISDynamicMapServiceLayer( DEFAULT_BASEMAP_SERVICE_URL));

我这里加了一个官方的图层，XML里mapoptions.MapType属性可能在MapView构造函数中加了图层

3.Layer图层

图层有点像ps里的图层，一层一层添加在MapView中显示。一个MapView至少需要1个图层
图层分为4种：

例如
− ArcGISTiledMapServiceLayer 用于显示缓存服务，瓦片地图。
− ArcGISDynamicMapServiceLayer 用于显示动态服务。
− ArcGISFeatureLayer 用于显示和操作要素图层。
− GraphicsLayer 用来在地图上显示一些额外的，或者临时的元素。

4.点线面的编辑

点线面的编辑主要在GraphicsLayer图层上操作，首先给MapView添加1个GraphicsLayer图层：

mGraphicsLayer = new GraphicsLayer();
mapView.addLayer(mGraphicsLayer);

然后要给MapView设置一个点击事件的监听：

mActivityMainBinding.mapView.setOnSingleTapListener(new OnSingleTapListener() {
            @Override
            public void onSingleTap(float x, float y) {
                //x,y就是屏幕上点击的坐标
            }
        });

4.1 Point点

添加点：

//把屏幕坐标转化为地图上的坐标点
Point point = mapView.toMapPoint(x, y);
//点的样式
SimpleMarkerSymbol sms = new SimpleMarkerSymbol(Color.RED, 16, SimpleMarkerSymbol.STYLE.CIRCLE);
//把点和样式组合成一个Graphic，显示图形的载体
Graphic graphic = new Graphic(point, sms);
//添加到图层上显示
mGraphicsLayer.addGraphic(graphic)
//mGraphicsLayer.addGraphic(graphic)返回的是一个int id值，表示操作的ID，删除Graphic需要用到 
//int id = mGraphicsLayer.addGraphic(graphic)
//删除相应的addGraphic操作
//mGraphicsLayer.removeGraphic（int id）

4.2 Polyline线

线就是多个点连成的线，有个起点
添加线：

//是否设置了起点
private boolean mIsSetStart;
Point point = mActivityMainBinding.mapView.toMapPoint(x, y);
Polyline polyline = new Polyline();
  if (!mIsSetStart) {
      polyline.startPath(point);
      mIsSetStart = true;
  } else {
      polyline.lineTo(point);
  }
SimpleLineSymbol sms = new SimpleLineSymbol(Color.BLUE, 16, SimpleLineSymbol.STYLE.SOLID);
Graphic graphic = new Graphic(polyline, sms);
mGraphicsLayer.addGraphic(graphic);

4.3 Polygon面

面和线类似，也有起点。

//是否设置了起点
private boolean mIsSetStart;
Polygon polygon = new Polygon();
Point point = mActivityMainBinding.mapView.toMapPoint(x, y);
if (!mIsSetStart) {
      polygon.startPath(point);
      mIsSetStart = true;
} else {
      polygon.lineTo(point);
}
SimpleFillSymbol sms = new SimpleFillSymbol(Color.BLUE, SimpleFillSymbol.STYLE.SOLID);
Graphic graphic = new Graphic(polygon, sms);
mGraphicsIds.add(mGraphicsLayer.addGraphic(graphic));

4.4 Graphic

大家可能都发现了，点线面3者流程上都一样，不同的是构成Graphic参数的不同。
Graphic有3个属性：

1. Geometry：图形的地理位置信息
   点—Point、线—Polyline、面——Polygon
2. Symbol：图形的样式
   点— SimpleMarkerSymbol、线—SimpleLineSymbol、面—— SimpleFillSymbol
3. attributes（可选）：图形储存的信息，以Map键值对的方式储存

这篇文章记录的就这么多，很基本的内容。接下来会记录一些具体的操作，比如Task类种的各种查询任务等。