ArcGis for android - Build a simple map app with java

使用Arcgis Runtime SDK for android创建一个简单的地图应用。

1. 开发环境 

Android Studio 3.1.1

首先新建一个andoid的应用程序. 因为使用的是Arcgis Runtime SDK 100.2.1，所以minSdk 要求 16（android4.1） 及以上。

2. 添加ArcGIS Runtime SDK依赖

1）在项目的build.gradle中添加arcgis的maven地址：

allprojects {
  repositories {
    google()
    jcenter()
    
    // Add the Esri public Bintray Maven repository
    maven {
        url 'https://esri.bintray.com/arcgis'
    }
  }
}

2）在Module的build.gradle中加入依赖

dependencies { 
  implementation 'com.esri.arcgisruntime:arcgis-android:100.2.1' 
  implementation fileTree(dir: 'libs', include: ['*.jar'])
  ...
}

3. 添加权限

在AndroidManifest.xml中编辑如下：

<uses-permission android:name="android.permission.INTERNET" /> 
<!-- 应用程序需要OpenGL 2.0版本的软件功能才能运行和显示地图视图。大多数你用ArcGISRuntimeSDK为Android开发的应用程序都需要这个特性 -->
<uses-feature android:glEsVersion="0x00020000" android:required="true" />

4. 使用Java8语言特性

在Module的build.gradle中android板块里编辑如下：

android {
  [...]
  // Add below lines to set compatibility with Java 8 language features for an Android app module.
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

5. 将MapView添加到布局文件中

前面的都是准备工作，现在进入正题，创建android项目时，默认创建了MainActivity及其布局文件activity_main.xml，在activity_main.xml中加入arcgis的MapView。

activity_main.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

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

</LinearLayout>

6. 设置显示的地图

默认情况下，这个MapView是不显示任何东西的，所以下面要定义一张用于显示的地图。你可以指定该地图显示来自ArcGIS在线的全球地形图，由于应用程序最初显示特定区域而不是显示整个区域通常更有用，因此您还可以将地图设置为放大到特定的中心点。

MainActivity.java文件：

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;

import com.esri.arcgisruntime.mapping.ArcGISMap;
import com.esri.arcgisruntime.mapping.Basemap;
import com.esri.arcgisruntime.mapping.view.MapView;

public class MainActivity extends AppCompatActivity {

    private MapView mMapView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mMapView = findViewById(R.id.mapView);
        // 显示北京天安门 东经：116°23′17〃，北纬：39°54′27
        ArcGISMap arcGISMap = new ArcGISMap(Basemap.Type.TOPOGRAPHIC, 39.9775, 116.38805, 16);
        mMapView.setMap(arcGISMap);
    }

    @Override
    protected void onPause() {
        mMapView.pause();
        super.onPause();
    }

    @Override
    protected void onResume() {
        super.onResume();
        mMapView.resume();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mMapView.dispose();
    }
}

然后直接运行程序就可以看到地图了。