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

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

更新时间:2017年04月12日

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

第 1 步:下载并安装 Android Studio

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

第 2 步:获取高德Key

点我获取Key>>

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

第 3 步:申请室内地图数据

室内地图数据访问权限与开发者key绑定,需要申请开通访问权限!

请前往 室内地图数据申请 申请室内地图数据。烦请务必提供您所申请的开发者key!

第 4 步:创建项目

按以下步骤新建一个 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。

第 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 项目中的下列文件。

 

  1. 配置 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更多功能的演示。

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