在高德地圖定位SDK
的使用過程中悲伶,記錄下些細(xì)節(jié)處理莺丑。方便以后整理掘宪。
此文是整理在能夠顯示高德地圖的前提下的寇钉。
1. 配置AndroidManifest文件
在application
標(biāo)簽中聲明service
組件,每個app擁有自己單獨的定位service搏恤。
<service android:name="com.amap.api.location.APSService"></service>
2. 啟動定位服務(wù)
2.1 初始化定位客戶端违寿,設(shè)置監(jiān)聽
//定位服務(wù)類。此類提供單次定位熟空、持續(xù)定位藤巢、地理圍欄、最后位置相關(guān)功能
private AMapLocationClient aMapLocationClient;
//聲明定位回調(diào)監(jiān)聽器
private OnLocationChangedListener listener;
//初始化定位
aMapLocationClient = new AMapLocationClient(getApplicationContext());
//設(shè)置定位回調(diào)監(jiān)聽
aMapLocationClient.setLocationListener(this);
2.2 配置定位參數(shù)息罗,啟動定位
//定位參數(shù)設(shè)置
private AMapLocationClientOption aMapLocationClientOption;
//初始化定位參數(shù)
aMapLocationClientOption = new AMapLocationClientOption();
//設(shè)置定位模式為高精度模式掂咒,Battery_Saving為低功耗模式,Device_Sensors是僅設(shè)備模式
aMapLocationClientOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
//設(shè)置是否返回地址信息(默認(rèn)返回地址信息)
aMapLocationClientOption.setNeedAddress(true);
//設(shè)置是否只定位一次,默認(rèn)為false
aMapLocationClientOption.setOnceLocation(false);
//設(shè)置是否強(qiáng)制刷新WIFI迈喉,默認(rèn)為強(qiáng)制刷新
aMapLocationClientOption.setWifiActiveScan(true);
//設(shè)置是否允許模擬位置,默認(rèn)為false绍刮,不允許模擬位置
aMapLocationClientOption.setMockEnable(false);
//設(shè)置定位間隔,單位毫秒,默認(rèn)為2000ms
aMapLocationClientOption.setInterval(2000);
//給定位客戶端對象設(shè)置定位參數(shù)
aMapLocationClient.setLocationOption(aMapLocationClientOption);
//啟動定位
aMapLocationClient.startLocation();
3. 添加定位接口
4. 添加監(jiān)聽
// 設(shè)置定位監(jiān)聽
aMap.setLocationSource(this);
//設(shè)置默認(rèn)定位按鈕是否顯示
aMap.getUiSettings().setMyLocationButtonEnabled(true);
// 設(shè)置為true表示顯示定位層并可觸發(fā)定位,false表示隱藏定位層并不可觸發(fā)定位弊添,默認(rèn)是false
aMap.setMyLocationEnabled(true);
// 設(shè)置定位的類型為定位模式录淡,參見類AMap。
aMap.setMyLocationType(AMap.LOCATION_TYPE_LOCATE);
// 設(shè)置為true表示系統(tǒng)定位按鈕顯示并響應(yīng)點擊油坝,false表示隱藏嫉戚,默認(rèn)是false
aMap.setMyLocationEnabled(true);
其中locationSource接口
是一個提供位置數(shù)據(jù)的接口。實現(xiàn)該接口需復(fù)寫其中的方法activate
澈圈,該方法的具體解釋如下:
在此方法中激活定位回調(diào)監(jiān)聽器listener
彬檀。否則接收不到定位。
@Override
public void activate(OnLocationChangedListener onLocationChangedListener) {
listener = onLocationChangedListener;
}
5. 獲取定位結(jié)果
復(fù)寫定位回調(diào)接口AMapLocationListener
中的方法瞬女,獲取定位后的結(jié)果窍帝。
/**
* 定位回調(diào)監(jiān)聽,當(dāng)定位完成后調(diào)用此方法
* @param aMapLocation
*/
@Override
public void onLocationChanged(AMapLocation aMapLocation) {
if(listener!=null && aMapLocation!=null) {
listener.onLocationChanged(aMapLocation);// 顯示系統(tǒng)小藍(lán)點
if (aMapLocation.getErrorCode() == 0) {
//定位成功回調(diào)信息诽偷,設(shè)置相關(guān)消息
aMapLocation.getLocationType();//獲取當(dāng)前定位結(jié)果來源坤学,如網(wǎng)絡(luò)定位結(jié)果,詳見定位類型表
aMapLocation.getLatitude();//獲取經(jīng)度
aMapLocation.getLongitude();//獲取緯度;
aMapLocation.getAccuracy();//獲取精度信息
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date date = new Date(aMapLocation.getTime());
df.format(date);//定位時間
aMapLocation.getAddress();//地址报慕,如果option中設(shè)置isNeedAddress為false深浮,則沒有此結(jié)果
aMapLocation.getCountry();//國家信息
aMapLocation.getProvince();//省信息
aMapLocation.getCity();//城市信息
aMapLocation.getDistrict();//城區(qū)信息
aMapLocation.getRoad();//街道信息
aMapLocation.getCityCode();//城市編碼
aMapLocation.getAdCode();//地區(qū)編碼
} else {
//顯示錯誤信息ErrCode是錯誤碼,errInfo是錯誤信息眠冈,詳見錯誤碼表飞苇。
Log.e("Tomato","location Error, ErrCode:"
+ aMapLocation.getErrorCode() + ", errInfo:"
+ aMapLocation.getErrorInfo());
}
}
}
其中錯誤碼
為0的情況定位正常。
6. 停止定位
@Override
protected void onDestroy() {
super.onDestroy();
mapView.onDestroy();
//銷毀定位客戶端
if(aMapLocationClient!=null){
aMapLocationClient.onDestroy();
aMapLocationClient = null;
aMapLocationClientOption = null;
}
}
7. 源代碼
package com.tomato.lbsdemo;
import android.graphics.Color;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import android.util.Log;
import android.widget.CompoundButton;
import com.amap.api.location.AMapLocation;
import com.amap.api.location.AMapLocationClient;
import com.amap.api.location.AMapLocationClientOption;
import com.amap.api.location.AMapLocationListener;
import com.amap.api.maps.AMap;
import com.amap.api.maps.LocationSource;
import com.amap.api.maps.MapView;
import com.amap.api.maps.model.BitmapDescriptorFactory;
import com.amap.api.maps.model.MyLocationStyle;
import java.text.SimpleDateFormat;
import java.util.Date;
public class MainActivity extends AppCompatActivity implements CompoundButton.OnCheckedChangeListener
,AMapLocationListener,LocationSource {
private MapView mapView;
private AMap aMap;
//定位服務(wù)類。此類提供單次定位布卡、持續(xù)定位雨让、地理圍欄、最后位置相關(guān)功能
private AMapLocationClient aMapLocationClient;
private OnLocationChangedListener listener;
//定位參數(shù)設(shè)置
private AMapLocationClientOption aMapLocationClientOption;
@Override
protected void onCreate (Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
mapView = (MapView)findViewById(R.id.map);
mapView.onCreate(savedInstanceState); //必須寫
aMap = mapView.getMap();
//設(shè)置地圖類型
aMap.setMapType(AMap.MAP_TYPE_NORMAL);
MyLocationStyle locationStyle = new MyLocationStyle();
locationStyle.myLocationIcon(BitmapDescriptorFactory.fromResource(R.drawable.start));
locationStyle.strokeColor(Color.BLUE);
locationStyle.strokeWidth(5);
aMap.setMyLocationStyle(locationStyle);
// 設(shè)置定位監(jiān)聽
aMap.setLocationSource(this);
aMap.getUiSettings().setMyLocationButtonEnabled(true);//設(shè)置默認(rèn)定位按鈕是否顯示
aMap.setMyLocationEnabled(true);// 設(shè)置為true表示顯示定位層并可觸發(fā)定位忿等,false表示隱藏定位層并不可觸發(fā)定位栖忠,默認(rèn)是false
// 設(shè)置定位的類型為定位模式,參見類AMap贸街。
aMap.setMyLocationType(AMap.LOCATION_TYPE_LOCATE);
// 設(shè)置為true表示系統(tǒng)定位按鈕顯示并響應(yīng)點擊娃闲,false表示隱藏,默認(rèn)是false
aMap.setMyLocationEnabled(true);
aMapLocationClient = new AMapLocationClient(getApplicationContext());
aMapLocationClient.setLocationListener(this);
//初始化定位參數(shù)
aMapLocationClientOption = new AMapLocationClientOption();
//設(shè)置定位模式為高精度模式匾浪,Battery_Saving為低功耗模式,Device_Sensors是僅設(shè)備模式
aMapLocationClientOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
//設(shè)置是否返回地址信息(默認(rèn)返回地址信息)
aMapLocationClientOption.setNeedAddress(true);
//設(shè)置是否只定位一次,默認(rèn)為false
aMapLocationClientOption.setOnceLocation(false);
//設(shè)置是否強(qiáng)制刷新WIFI卷哩,默認(rèn)為強(qiáng)制刷新
aMapLocationClientOption.setWifiActiveScan(true);
//設(shè)置是否允許模擬位置,默認(rèn)為false蛋辈,不允許模擬位置
aMapLocationClientOption.setMockEnable(false);
//設(shè)置定位間隔,單位毫秒,默認(rèn)為2000ms
aMapLocationClientOption.setInterval(2000);
//給定位客戶端對象設(shè)置定位參數(shù)
aMapLocationClient.setLocationOption(aMapLocationClientOption);
//啟動定位
aMapLocationClient.startLocation();
}
/**
* 定位回調(diào)監(jiān)聽,當(dāng)定位完成后調(diào)用此方法
* @param aMapLocation
*/
@Override
public void onLocationChanged(AMapLocation aMapLocation) {
if(listener!=null && aMapLocation!=null) {
listener.onLocationChanged(aMapLocation);// 顯示系統(tǒng)小藍(lán)點
if (aMapLocation.getErrorCode() == 0) {
//定位成功回調(diào)信息将谊,設(shè)置相關(guān)消息
aMapLocation.getLocationType();//獲取當(dāng)前定位結(jié)果來源冷溶,如網(wǎng)絡(luò)定位結(jié)果,詳見定位類型表
aMapLocation.getLatitude();//獲取經(jīng)度
aMapLocation.getLongitude();//獲取緯度;
aMapLocation.getAccuracy();//獲取精度信息
SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date date = new Date(aMapLocation.getTime());
df.format(date);//定位時間
aMapLocation.getAddress();//地址尊浓,如果option中設(shè)置isNeedAddress為false逞频,則沒有此結(jié)果
aMapLocation.getCountry();//國家信息
aMapLocation.getProvince();//省信息
aMapLocation.getCity();//城市信息
aMapLocation.getDistrict();//城區(qū)信息
aMapLocation.getRoad();//街道信息
aMapLocation.getCityCode();//城市編碼
aMapLocation.getAdCode();//地區(qū)編碼
} else {
//顯示錯誤信息ErrCode是錯誤碼,errInfo是錯誤信息栋齿,詳見錯誤碼表苗胀。
Log.e("Tomato","location Error, ErrCode:"
+ aMapLocation.getErrorCode() + ", errInfo:"
+ aMapLocation.getErrorInfo());
}
}
}
@Override
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
}
@Override
public void activate(OnLocationChangedListener onLocationChangedListener) {
listener = onLocationChangedListener;
}
@Override
public void deactivate() {
}
/**
* 方法必須重寫
*/
@Override
protected void onResume() {
super.onResume();
mapView.onResume();
}
/**
* 方法必須重寫
*/
@Override
protected void onPause() {
super.onPause();
mapView.onPause();
}
/**
* 方法必須重寫
*/
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
mapView.onSaveInstanceState(outState);
}
/**
* 方法必須重寫
*/
@Override
protected void onDestroy() {
super.onDestroy();
mapView.onDestroy();
//銷毀定位客戶端
if(aMapLocationClient!=null){
aMapLocationClient.onDestroy();
aMapLocationClient = null;
aMapLocationClientOption = null;
}
}
}
對AndroidMainfest.xml
配置
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.tomato.lbsdemo" >
<!--地圖包、搜索包需要的基礎(chǔ)權(quán)限-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<permission android:name="android.permission.WRITE_APN_SETTINGS" />
<!--定位包瓦堵、導(dǎo)航包需要的額外權(quán)限(注:基礎(chǔ)權(quán)限也需要)-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<!--<uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-sdk
android:minSdkVersion="15"
android:targetSdkVersion="23" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="LBS上申請的Key">
</meta-data>
<service android:name="com.amap.api.location.APSService"></service>
<activity
android:name=".MainActivity"
android:label="@string/app_name"
android:theme="@style/AppTheme.NoActionBar" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
8. 自定義定位圖標(biāo)
使用定位(當(dāng)前位置)的繪制樣式類MyLocationStyle
基协,對定位圖標(biāo)進(jìn)行自定義。
MyLocationStyle locationStyle = new MyLocationStyle();
locationStyle.myLocationIcon(BitmapDescriptorFactory.fromResource(R.drawable.start));
locationStyle.strokeColor(Color.BLUE);
locationStyle.strokeWidth(5);
aMap.setMyLocationStyle(locationStyle);