高德地图官方有API,有文档,但是大家懂的,有些东西并没有说明。所以,我打算将自己实现对高德地图展示、定位以及导航的功能步骤做一个总结,分享给大家。本文作为总结高德地图使用,首先总结自己对于拾取地点这样的功能的实现。
第一步,准备工作:
首先,我们需要去高德地图获取key,然后下载sdk(包括jar包和so文件),本项目需要的sdk,如图:
当我们将key下载好以后,并且将jar包和so文件放好——建议直接将jar包放在libs文件夹,然后将so文件放在jinLibs文件夹下面,当然,我们也可以将so文件也放到libs,然后将Module的build.gradle文件修改如图:
接下来就是修改文件清单,这些我们可以直接将API的代码复制过来了:
//地图包、搜索包、定位包、导航包需要的基础权限
<!--允许程序打开网络套接字-->
<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" />
<!--用于访问GPS定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!--这个权限用于允许程序在手机屏幕关闭后后台进程仍然运行-->
<user-permission android:name="android.permission.WAKE_LOCK"/>
<application
android:icon="@drawable/icon"
android:label="@string/app_name" >
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="e969e70f8daf003d370ab982e6ba656d"/>
……
<service android:name="com.amap.api.location.APSService"></service>
</application>
准备工作的最后一步只需要执行sync project with gradle files就完成整个项目的准备工作了!
准备工作完成了,我们接下来就执行第二步,展示地图:
首先,我们需要布局中有一个地图的布局,代码如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.amap.api.maps.MapView
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</LinearLayout>
接下来就是对于地图的调用,这个非常简单,API里面都是现成的,代码如下:
public class PiclocationActivity extends Activity {
private MapView mMapView = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_piclocation);
ActionBar actionBar = getActionBar();
if(actionBar!=null)actionBar.hide();
mMapView = (MapView) findViewById(R.id.map);
mMapView.onCreate(savedInstanceState);// 此方法必须重写
}
@Override
protected void onDestroy() {
super.onDestroy();
//在activity执行onDestroy时执行mMapView.onDestroy(),销毁地图
mMapView.onDestroy();
}
@Override
protected void onResume() {
super.onResume();
//在activity执行onResume时执行mMapView.onResume (),重新绘制加载地图
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
//在activity执行onPause时执行mMapView.onPause (),暂停地图的绘制
mMapView.onPause();
}
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
//在activity执行onSaveInstanceState时执行mMapView.onSaveInstanceState (outState),保存地图当前的状态
mMapView.onSaveInstanceState(outState);
}
}
于是地图就展示出来了。
当然,如果你是你现在看到的地图是没有中间的图标,位置也应该是北京为中心点的地图。而我们今天需要实现的是拾取坐标点,所以必须要显示当前定位的。而关于地图展示的相关方法,接下来还会用的到。所以,我们接下来就实现上面的效果吧!
第二步,开始定位:
其实,这个也代码量也非常简单,如下:
private AMap amap;
private OnLocationChangedListener mListener;
private AMapLocationClient mlocationClient;
private AMapLocationClientOption mLocationOption;
@Override
protected void onCreate(Bundle savedInstanceState) {
...
initMap();
}
/**
* 地图实例化
*/
private void initMap() {
if (amap == null) {
amap = mMapView.getMap();
amap.setLocationSource(this);//设置了定位的监听,这里要实现LocationSource接口
amap.getUiSettings().setMyLocationButtonEnabled(true); // 是否显示定位按钮
amap.setMyLocationEnabled(true);//显示定位层并且可以触发定位,默认是flase
}
/**
* 激活定位
*/
@Override
public void activate(OnLocationChangedListener listener) {
mListener = listener;
if (mlocationClient == null) {
//初始化定位
mlocationClient = new AMapLocationClient(this);
//初始化定位参数
mLocationOption = new AMapLocationClientOption();
//设置定位回调监听
mlocationClient.setLocationListener(this);
//设置为高精度定位模式
mLocationOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
//设置为定位一次
// mLocationOption.setOnceLocation(true);
//设置定位参数
mlocationClient.setLocationOption(mLocationOption);
// 此方法为每隔固定时间会发起一次定位请求,为了减少电量消耗或网络流量消耗,
// 注意设置合适的定位时间的间隔(最小间隔支持为2000ms),并且在合适时间调用stopLocation()方法来取消定位请求
// 在定位结束后,在合适的生命周期调用onDestroy()方法
// 在单次定位情况下,定位无论成功与否,都无需调用stopLocation()方法移除请求,定位sdk内部会移除
mlocationClient.startLocation();//启动定位
}
}
/**
* 注销定位
*/
@Override
public void deactivate() {
mListener = null;
if (mlocationClient != null) {
mlocationClient.stopLocation();
mlocationClient.onDestroy();
}
mlocationClient = null;
}
/**
* 实现定位
* @param amapLocation
*/
@Override
public void onLocationChanged(AMapLocation amapLocation) {
if (mListener != null && amapLocation != null) {
if (amapLocation != null
&&amapLocation.getErrorCode() == 0) {
String location = "当前地点:"+amapLocation.getProvider()+amapLocation.getCity()+amapLocation.getStreet()+amapLocation.getStreetNum();
Log.d(TAG, "onLocationChanged: ");
} else {
String errText = "定位失败," + amapLocation.getErrorCode()+ ": " + amapLocation.getErrorInfo();
Log.e("AmapErr",errText);
}
}
}
接下来我们看看这个效果,首先看看日志:
04-29 23:53:04.267 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:06.268 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:08.270 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:10.277 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:12.327 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:14.281 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:16.282 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:18.288 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:20.297 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:22.291 18491-18491/cn.com.vicent.mymap D/PiclocationActivity: onLocationChanged: 当前地点:lbs成都市剑南大道南段712号
04-29 23:53:24.640 18491-18491/cn.com