使用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();
}
}
然后直接运行程序就可以看到地图了。