高德android api 开发指南

API 简介

什么是高德地图Android API？

高德地图Android API 版是一套基于Android 1.6 及以上设备的应用程序接口，通过该接口，用户可以轻松访问高德地图服务和数据，构建功能丰富、交互性强的地图应用程序。高德地图Android API 不仅包含构建地图的基本接口，还提供了诸如矢量地图、栅格地图、地图定位（GPS、基站、WiFi）、本地搜索、路线规划等数据服务，用户可以根据自己的需要进行选择。

面向的读者

本API 是提供给具有一定Android 编程经验和了解面向对象概念的读者使用的。此外，读者还应该对地图产品有一定的了解。用户在使用中遇到任何问题，可以通过问答社区反馈给我们。

兼容性

系统：支持Android 1.6 及以上系统。

注意事项

下面介绍在程序开发中需注意的问题：必须在manifest 中设置相应的权限，代码如下：

源码复制打印关于

1

2android:name="android.permission.ACCESS_COARSE_LOCATION">

3

4android:name="android.permission.ACCESS_FINE_LOCATION">

5

6android:name="android.permission.INTERNET">

7

8android:name="android.permission.ACCESS_NETWORK_STATE">

9

10android:name="android.permission.WRITE_EXTERNAL_STORAGE">

11

12android:name="android.permission.READ_PHONE_STATE"> 13

14android:name="android.permission.CHANGE_WIFI_STATE"> 15

16android:name="android.permission.ACCESS_WIFI_STATE"> 地图显示

如何把API 添加到我的Android 工程中？

首先创建工程，并在工程Build Path>Configure Build Path…>libraries 中选择“Add Externel JARs…”，选定MapApi.jar，点击OK，这样就可以将高德地图Android API 库文件引入。然后在工程Build Path>Configure Build Path…>Order and Export 中将引入的库文件MapApi.jar 选中，点击OK，这样您就可以在您的程序中使用高德地图API 了。

栅格地图显示

MapActivity 是一个抽象类，任何想要显示MapView 的activity 都需要派生自MapActivity。并且在其派生类的onCreate() 中，都要创建一个MapView 实例。

源码复制打印关于

17public class GridMapView extends MapActivity{

18private MapView mMapView;

19private MapController mMapController;

20private GeoPoint point;

21@Override

22/**

23*显示栅格地图，启用内置缩放控件，并用MapController 控制地图的中心点及Zoom 级别24*/

25protected void onCreate(Bundle savedInstanceState) {

26// TODO Auto-generated method stub

27super.onCreate(savedInstanceState);

28setContentView(yout.mapview);

29mMapView = (MapView) findViewById(R.id.mapView);

30mMapView.setBuiltInZoomControls(true); //设置启用内置的缩放控件

31mMapController = mMapView.getController(); // 得到mMapView 的控制权,可以用它控制和驱动平移和缩放

32point = new GeoPoint((int) (39.982378 * 1E6),

33(int) (116.304923 * 1E6)); //用给定的经纬度构造一个GeoPoint，单位是微度(度* 1E6)

34mMapController.setCenter(point); //设置地图中心点

35mMapController.setZoom(12); //设置地图zoom 级别

36}

37}

在布局xml 中添加地图控件：

源码复制打印关于

38

39

xmlns:android="/apk/res/android"

40xmlns:autonavi="/apk/res/com.AMap"

41android:orientation="vertical" android:layout_width="fill_parent"

42android:layout_height="fill_parent">

43

44android:layout_width="fill_parent" android:layout_height="fill_parent"

45android:clickable="true"

46/>

47

结果见图3-1 栅格地图显示效果图：

图3-1 栅格地图显示效果图

矢量地图显示

将libminimapv320.so 复制到工程目录下的libs\armeabi，目录结构见图3-2 工程目录结构图：

图3-2 工程目录结构图

代码如下：

源码复制打印关于48public class VectorMapView extends MapActivity{

49private MapView mMapView;

50private MapController mMapController;