入门指南 最后更新时间: 2021年01月22日
本指南是向 Android 应用添加室内地图的快速入门指南。
第 1 步：下载并安装 Android Studio
按照指南下载并安装 Android Studio。（注：下载地址为Google官方网站）
第 2 步：获取高德Key
第 3 步：申请室内地图数据
室内地图数据访问权限与开发者key绑定，需要申请开通访问权限！
请前往 室内地图数据申请 申请室内地图数据。烦请务必提供您所申请的开发者key！
第 4 步：创建项目
按以下步骤新建一个 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。
第 5 步：下载并安装地图开发包
从官网下载按照需求下载开发包并解压。
以2.2.0 Beta版本的地图功能为例，解压后，得到一个 IndoorMapSDK2.0.0.aar 文件和一个 armeabi 文件夹和一个armeabi-v7a文件夹（文件夹中都包含：libIndoorMapSDK2.0.0.so文件）。
操作步骤具体请参考 开发指南中的 Android Stuido 的aar和so文件安装步骤以及Demo中的配制方法。
第 6 步：Hello AMap 查看代码
请查看 Android Studio 项目中的下列文件。
- 配置 AndroidManifest.xml 文件
在AndroidManifest.xml的application标签中配置Key：
<meta-data android:name="indoormap3d_key" android:value="您的Key">
</meta-data>在AndroidManifest.xml中配置权限:
//地图包、搜索包需要的基础权限
<!--允许程序打开网络套接字-->
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<!--允许程序设置内置sd卡的写权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<!--允许程序设置内置sd卡的读权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<!--允许程序获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<!--允许程序访问WiFi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<!--允许程序读写手机状态和身份-->
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
<!--允许程序连接蓝牙-->
<uses-permission android:name="android.permission.BLUETOOTH"></uses-permission>
<!--允许程序发现蓝牙配对-->
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN "></uses-permission>
<!--允许程序获取精确的位置-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
2.配置XML布局文件 在布局xml文件中添加地图控件；
<relativelayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent">
<fragment android:id="@+id/indoor_main_map_view" android:name="com.amap.api.im.view.IMIndoorMapFragment" android:layout_width="match_parent" android:layout_height="match_parent"></fragment>
/>
</relativelayout>3.地图展示
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.indoor_main_map_view);//设置对应的XML布局文件
IMIndoorMapFragment mIndoorMapFragment = (IMIndoorMapFragment) getSupportFragmentManager()
.findFragmentById(R.id.indoor_main_map_view);
}
第 7 步：连接 Android 设备
了解您的应用实际运行情况的最简单方法是将 Android 设备与计算机相连。 按照说明在您的 Android 设备上启用开发者选项，安装设备驱动，并配置您的应用和系统以检测设备。
第 8 步：构建和运行您的应用
在 Android Studio 中，点击 Run 菜单选项（或 play 按钮图标）运行您的应用。
提示您选择设备时，选择下列选项之一：
选择与您的计算机相连的 Android 设备 此外，还可以选择 Launch emulator 单选按钮，然后选择您之前配置过的虚拟设备 点击 OK。 Android Studio 将调用 Gradle 构建您的应用，然后在设备或模拟器上显示结果。应用打开可能需要几分钟的时间。
直接运行后，您可以看到在您的项目里有室内地图展示。如果您未看到地图或者不能使用路径规划等功能，那请检查您是否联网以及Demo程序的权限设置，然后再确认是否在AndroidManifest.xml中添加了您的高德Key以及您编译环境的keystore SHA1码是否正确。
后续步骤
您可能想观摩一些示例代码，可以前往相关下载下载官方示例Demo。点击Demo中的设置—指定接口测试 ，看到关于SDK更多功能的演示。
