入门指南最后更新时间: 2023年12月15日

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

第 1 步：下载并安装 Android Studio

按照指南下载并安装 Android Studio。（注：下载地址为Google官方网站）

第 2 步：获取高德Key

点我获取Key>>

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

第 3 步：创建项目

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

启动 Android Studio。如果您看到 Welcome to Android Studio 对话框，请选择 Start a new Android Studio project，否则，请点击 Android Studio 菜单栏中的 File，然后点击 New->New Project，按提示输入您的应用名称、公司域和项目位置。然后点击 Next。
选择您的应用所需的机型。如果您不能确定自己的需要，只需选择 Phone and Tablet。然后点击 Next。
在“Add an activity to Mobile”对话框中选择 Empty Activity。然后点击 Next。
按提示输入 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：

XML

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

在AndroidManifest.xml中配置权限:

地图SDK：

XML

<!--允许访问网络，必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  

<!--允许获取粗略位置，若用GPS实现定位小蓝点功能则必选-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 
  
<!--允许获取网络状态，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    

<!--允许获取wifi网络信息，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 

<!--允许获取wifi状态改变，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> 

<!--允许写入扩展存储，用于数据缓存，若无此权限则写到私有目录-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!--允许写设备缓存，用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许读设备等信息，用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

搜索SDK：

XML

<!--允许访问网络，必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  
 
<!--允许获取网络状态-->
<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.WRITE_EXTERNAL_STORAGE" /> 

<!--允许写设备缓存，用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许读设备等信息，用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

2.配置XML布局文件在布局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.地图展示

Java

@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。

入门指南 最后更新时间: 2023年12月15日