示例中心
功能在线体验
控制台
您现在的位置: 开发 > Android 地图SDK > 入门指南 >

高德 开发 Android 地图SDK 入门指南

更新时间:2017年04月05日

本指南是向 Android 应用添加地图的快速入门指南。

第 1 步:下载并安装 Android Studio

按照指南下载安装 Android Studio。(注:下载地址为Google官方网站)

第 2 步:获取高德Key

点我获取Key>>

点我查看Key注册时必要数据SHA1和包名的获取方法>>

第 3 步:创建项目

按以下步骤新建一个 Empty Activity 的应用项目。

  1. 启动 Android Studio。如果您看到 Welcome to Android Studio 对话框,请选择 Start a new Android Studio project,否则,请点击 Android Studio 菜单栏中的 File,然后点击 New->New Project,按提示输入您的应用名称、公司域和项目位置。 然后点击 Next。
  2. 选择您的应用所需的机型。 如果您不能确定自己的需要,只需选择 Phone and Tablet。然后点击 Next。
  3. 在“Add an activity to Mobile”对话框中选择 Empty Activity。 然后点击 Next。
  4. 按提示输入 Activity 名称、布局名称和标题。 使用默认值即可。 然后点击 Finish。

第 4 步:下载并安装地图开发包

官网下载按照需求下载开发包并解压。

以3.3.3版本的地图功能为例,解压后,得到一个 AMap3DMap_3.3.3_20160726.jar 文件和一个 armeabi 文件夹(文件夹中包含:libgdinamapv4sdk752.so、libgdinamapv4sdk752ex.so、libtbt3631.so、libwtbt144.so 四个so文件)。

操作步骤具体请参考 开发指南中的 Android Stuido 的jar和so文件安装步骤。

第 5 步:Hello AMap 查看代码

请查看 Android Studio 项目中的下列文件。

1.配置 AndroidManifest.xml 文件

在AndroidManifest.xml的application标签中配置Key:

<meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="您的Key"/>

在AndroidManifest.xml中配置权限:

//地图包、搜索包需要的基础权限
     
<!--允许程序打开网络套接字-->
<uses-permission android:name="android.permission.INTERNET" />  
<!--允许程序设置内置sd卡的写权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    
<!--允许程序获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
<!--允许程序访问WiFi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
<!--允许程序读写手机状态和身份-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />     
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

2.配置XML布局文件  在布局xml文件中添加地图控件;

<com.amap.api.maps.MapView
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
</com.amap.api.maps.MapView>

3.地图展示

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.basicmap_activity);//设置对应的XML布局文件
    
    MapView mapView = (MapView) findViewById(R.id.map);
    mapView.onCreate(savedInstanceState);// 此方法必须重写
    AMap aMap = mapView.getMap();
    
}

第 6 步:连接 Android 设备

了解您的应用实际运行情况的最简单方法是将 Android 设备与计算机相连。 按照说明在您的 Android 设备上启用开发者选项,并配置您的应用和系统以检测设备。

此外,您也可以使用 Android 模拟器来运行您的应用。 使用 Android Virtual Device (AVD) Manager 来配置一台或多台虚拟设备,您可以将设备与 Android 模拟器联用来构建和运行您的应用。

第 7 步:构建和运行您的应用

在 Android Studio 中,点击 Run 菜单选项(或 play 按钮图标)运行您的应用。

提示您选择设备时,选择下列选项之一:

选择与您的计算机相连的 Android 设备 此外,还可以选择 Launch emulator 单选按钮,然后选择您之前配置过的虚拟设备 点击 OK。 Android Studio 将调用 Gradle 构建您的应用,然后在设备或模拟器上显示结果。应用打开可能需要几分钟的时间。

您可以看到在您的项目里有地图展示。如果您未看到地图,那请检查您是否联网,如果您看到了地图,但是不能使用POI搜索和路径规划等相关功能,请确认是否在AndroidManifest.xml中添加了您的高德Key。

后续步骤

您可能想观摩一些示例代码,可以前往相关下载下载官方示例Demo。

示例中心 功能
在线体验
常见问题