一.准备工作
1. 到高德地图官方网申请key: 我的应用 | 高德控制台
2. 申请key方法请参考:获取Key-创建工程-开发指南-Android 地图SDK | 高德地图API
3. 出现的问题:
其中有一个获取SHA1的问题:
E/AmapErr: 定位失败,7: KEY错误 请到/api/android-location-sdk/guide/utilities/errorcode/查看错误码说明,错误详细信息:auth
出现这类问题主要是SHA1不对,可以使用下面方法获取当前应用的SHA1,然后拿代码得到的SHA1和高德官网申请key填写的SHA比较是否正确.
public class SignSHA1Util {public static String sHA1(Context context){try {PackageInfo info = context.getPackageManager().getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);byte[] cert = info.signatures[0].toByteArray();MessageDigest md = MessageDigest.getInstance("SHA1");byte[] publicKey = md.digest(cert);StringBuffer hexString = new StringBuffer();for (int i = 0; i < publicKey.length; i++) {String appendString = Integer.toHexString(0xFF & publicKey[i]).toUpperCase(Locale.US);if (appendString.length() == 1)hexString.append("0");hexString.append(appendString);hexString.append(":");}String result = hexString.toString();return result.substring(0, result.length()-1);} catch (PackageManager.NameNotFoundException e) {e.printStackTrace();} catch (NoSuchAlgorithmException e) {e.printStackTrace();}return null;}
另外一个问题:
如出现上面此类错误,则需要在代码中添加以下2句代码来解决:
MapsInitializer.updatePrivacyShow(this, true, true);MapsInitializer.updatePrivacyAgree(this, true);
二.实现方式
1. 模拟使用android studio开发,在build.gradele中添加
//3D地图so及jar和导航 implementation 'com.amap.api:navi-3dmap:latest.integration' //定位功能 implementation 'com.amap.api:location:latest.integration' //搜索功能implementation 'com.amap.api:search:latest.integration'
2. 配置AndroidManifest.xml
首先,添加需要的权限
<!--地图包、搜索包需要的基础权限--><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" /><!--这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位--><uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /><!--这个权限用于允许程序在手机屏幕关闭后后台进程仍然运行--><uses-permission android:name="android.permission.WAKE_LOCK"/>
然后,设置高德key
<meta-data android:name="com.amap.api.v2.apikey" android:value="开发者申请的key"/>
最后,添加定位服务
<service android:name="com.amap.api.location.APSService"></service>
3.地图显示
首先,添加布局控件
<com.amap.api.maps.MapView android:id="@+id/mapView" android:layout_width="wrap_content" android:layout_height="match_parent" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintLeft_toLeftOf="parent" app:layout_constraintStart_toStartOf="parent"/>
然后,初始化地图显示就可以了
private void initMapView() {mapView = findViewById(R.id.mapView);mapView.onCreate(savedInstanceStateTemp);if (aMap == null) {aMap = mapView.getMap(); } }
4.实时定位
首先,初始化定位参数,设置监听
private void initLocation() {MyLocationStyle myLocationStyle = new MyLocationStyle();//设置连续定位模式下的定位间隔,只在连续定位模式下生效,单次定位模式下不会生效。单位为毫秒。myLocationStyle.interval(2000);//定位蓝点展现模式,默认是LOCATION_TYPE_LOCATION_ROTATEmyLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);//设置是否显示定位小蓝点,用于满足只想使用定位,不想使用定位小蓝点的场景,设置false以后图面上不再有定位蓝点的概念,但是会持续回调位置信息。myLocationStyle.showMyLocation(true);//设置定位蓝点的StyleaMap.setMyLocationStyle(myLocationStyle);// 设置定位监听aMap.setLocationSource(this);//设置为true表示启动显示定位蓝点,false表示隐藏定位蓝点并不进行定位,默认是false。aMap.setMyLocationEnabled(true);// 设置地图模式,aMap是地图控制器对象。1.MAP_TYPE_NAVI:导航地图 2.MAP_TYPE_NIGHT:夜景地图 3.MAP_TYPE_NORMAL:白昼地图(即普通地图) 4.MAP_TYPE_SATELLITE:卫星图aMap.setMapType(AMap.MAP_TYPE_NORMAL);//设置默认定位按钮是否显示,非必需设置。aMap.getUiSettings().setMyLocationButtonEnabled(true);//控制比例尺控件是否显示,非必须设置。aMap.getUiSettings().setScaleControlsEnabled(true);}
接着,实现AMap.setLocationSource监听器后,并且回调activate()和deactivate()两个方法。activate()方法是在**定位的时候触发,需要在里面初始化定位参数,并开始定位。deactivate()方法是在定位停止的时候触发,需要在方法里停止定位,避免不必要的资源浪费.
/*** **定位*/@Overridepublic void activate(LocationSource.OnLocationChangedListener onLocationChangedListener) {mListener = onLocationChangedListener;if (aMapLocationClient == null) {//初始化定位try {aMapLocationClient = new AMapLocationClient(this);//初始化定位参数aMapLocationClientOption = new AMapLocationClientOption();//设置定位回调监听aMapLocationClient.setLocationListener(this);//设置为高精度定位模式aMapLocationClientOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);//设置定位参数aMapLocationClient.setLocationOption(aMapLocationClientOption);//启动定位aMapLocationClient.startLocation();} catch (Exception e) {e.printStackTrace();}}}/*** 停止定位*/@Overridepublic void deactivate() {mListener = null;if (aMapLocationClient != null) {aMapLocationClient.stopLocation();aMapLocationClient.onDestroy();}aMapLocationClient = null;}
最后,在定位回调中设置显示定位小蓝点,isFirstLocationn的作用是防止拖动地图后,定位小蓝点老是返回到屏幕的中心位置。
@Overridepublic void onLocationChanged(AMapLocation aMapLocation) {if (mListener != null && aMapLocation != null) {this.aMapLocation = aMapLocation;if (aMapLocation.getErrorCode() == 0) {if (isFirstLocation) {aMap.moveCamera(CameraUpdateFactory.changeLatLng(new LatLng(aMapLocation.getLatitude(), aMapLocation.getLongitude())));mListener.onLocationChanged(aMapLocation);// 显示系统小蓝点isFirstLocation = false;}} else {Log.e("TAG", "定位失败!!!");}}}
5.模拟导航
首先,添加模拟导航布局控件
<com.amap.api.navi.AMapNaviViewandroid:id="@+id/naviView"android:layout_width="wrap_content"android:layout_height="match_parent"android:visibility="gone"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintLeft_toLeftOf="parent"app:layout_constraintStart_toStartOf="parent"></com.amap.api.navi.AMapNaviView>
接着,初始化模拟导航对象,并设置监听
private void initMapNaviView() {aMapNaviView = findViewById(R.id.naviView);mapView.setVisibility(View.GONE);aMapNaviView.setVisibility(View.VISIBLE);aMapNaviView.onCreate(savedInstanceStateTemp);aMapNaviView.setAMapNaviViewListener(SceneThirdActivity.this);//获取AMapNavi实例try {aMapNavi = AMapNavi.getInstance(SceneThirdActivity.this);} catch (AMapException e) {e.printStackTrace();}//添加监听回调,用于处理算路成功aMapNavi.addAMapNaviListener(SceneThirdActivity.this);aMapNavi.addParallelRoadListener(SceneThirdActivity.this);}
然后,计算步行规划路线,AMapNavi对象初始化成功后,会触发onInitNaviSuccess方法
@Overridepublic void onInitNaviSuccess() {LogUtil.d(TAG, "*****#####onInitNaviSuccess================");int strategy = 0;try {//再次强调,最后一个参数为true时代表多路径,否则代表单路径strategy = aMapNavi.strategyConvert(true, false, false, false, false);} catch (Exception e) {e.printStackTrace();}//设置模拟导航的行车速度aMapNavi.setEmulatorNaviSpeed(75);sList.add(mStartLatlng);eList.add(mEndLatlng);mWayPointList.add(new NaviLatLng(39.925846, 116.442765));aMapNavi.calculateDriveRoute(sList, eList, mWayPointList, strategy);}@Overridepublic void onCalculateRouteSuccess(AMapCalcRouteResult aMapCalcRouteResult) {LogUtil.d(TAG, "*****#####onCalculateRouteSuccess================");aMapNavi.startNavi(NaviType.EMULATOR);}
需要注意点:Activity销毁的时候调用AMapNavi的stopNavi()和destory()方法,来停止导航,否则再次导航时会出现AMapNavi初始化失败的问题!
@Overrideprotected void onResume() {super.onResume();aMapNaviView.onResume();}@Overrideprotected void onPause() {super.onPause();aMapNaviView.onPause();}protected void onDestroy() {super.onDestroy();mapView.onDestroy();aMapNaviView.onDestroy();//since 1.6.0 不再在naviview destroy的时候自动执行AMapNavi.stopNavi();请自行执行aMapNavi.stopNavi();aMapNavi.destroy();}
如果需要导航语音的话,调用SETUSEINNERVOICE()方法即可实现。
aMapNavi.setUseInnerVoice(true);