Android开发之高德地图实现定位

在应用开发中，地图开发是经常需要使用的“组件”，Google Map虽然有官方教程，无奈用不起来，原因你懂的~~那么国内比较出名的是就是百度地图和高德地图，由于个人喜好，所以选择了高德地图LBS，废话不说，上干货。

1、注册开发者，创建应用

这个几乎是所有开放平台都通用的做法，无外乎注册帐号，成为开发者，然后创建一个Android应用，会为你分配一个key绑定你的服务。

注册key.PNG

2、下载SDK，导入jar包，add to library

jar包.PNG

第一个是2D地图的jar包，因为最后定位以后我要在地图上标出来位置

第二个是用于定位的jar包

注意：如果使用的是3D地图，那么地图SDK和导航SDK需要引入so库文件，先在app/src/main/目录下新建一个jniLibs目录，将so放到此目录下

3、配置AndroidMainfest.xml文件

<!-- 申请必要的权限-->
<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.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<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" />

<application
  android:icon="@mipmap/ic_launcher"
  android:label="@string/app_name"
  android:theme="@style/AppTheme"

  >
  <!--设置key-->
  <meta-data
   android:name="com.amap.api.v2.apikey"
   android:value="这里填写第一步你申请的那个key" />
  <!--声明定位service-->
  <service android:name="com.amap.api.location.APSService"></service>
</application>

4、Activity的布局文件

<com.amap.api.maps2d.MapView
 xmlns:android="http://schemas.android.com/apk/res/android"
 android:id="@+id/map"
 android:layout_width="fill_parent"
 android:layout_height="fill_parent" />

很简单，就一个2D的地图

5、Activity，注释非常详细

//监听定位和定位变化
public class MainActivity extends AppCompatActivity implements LocationSource, AMapLocationListener {

 //显示地图需要的变量
 private MapView mapView;//地图控件
 private AMap aMap;//地图对象

 //定位需要的声明
 private AMapLocationClient mLocationClient = null;//定位发起端
 private AMapLocationClientOption mLocationOption = null;//定位参数
 private OnLocationChangedListener mListener = null;//定位监听器

 //标识，用于判断是否只显示一次定位信息和用户重新定位
 private boolean isFirstLoc = true;

 @Override
 protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_main);

  //显示地图
  mapView = (MapView) findViewById(R.id.map);
  //必须要写
  mapView.onCreate(savedInstanceState);
  //获取地图对象
  aMap = mapView.getMap();

  //设置显示定位按钮 并且可以点击
  UiSettings settings = aMap.getUiSettings();
  //设置定位监听
  aMap.setLocationSource(this);
  // 是否显示定位按钮
  settings.setMyLocationButtonEnabled(true);
  // 是否可触发定位并显示定位层
  aMap.setMyLocationEnabled(true);

  //定位的小图标 默认是蓝点 这里自定义一团火，其实就是一张图片
  MyLocationStyle myLocationStyle = new MyLocationStyle();
  myLocationStyle.myLocationIcon(BitmapDescriptorFactory.fromResource(R.mipmap.firetwo));
  myLocationStyle.radiusFillColor(android.R.color.transparent);
  myLocationStyle.strokeColor(android.R.color.transparent);
  aMap.setMyLocationStyle(myLocationStyle);
  //开始定位
  initLoc();
 }
 //定位
 private void initLoc() {
  //初始化定位
  mLocationClient = new AMapLocationClient(getApplicationContext());
  //设置定位回调监听
  mLocationClient.setLocationListener(this);
  //初始化定位参数
  mLocationOption = new AMapLocationClientOption();
  //设置定位模式为高精度模式，Battery_Saving为低功耗模式，Device_Sensors是仅设备模式
  mLocationOption.setLocationMode(AMapLocationClientOption.AMapLocationMode.Hight_Accuracy);
  //设置是否返回地址信息（默认返回地址信息）
  mLocationOption.setNeedAddress(true);
  //设置是否只定位一次,默认为false
  mLocationOption.setOnceLocation(false);
  //设置是否强制刷新WIFI，默认为强制刷新
  mLocationOption.setWifiActiveScan(true);
  //设置是否允许模拟位置,默认为false，不允许模拟位置
  mLocationOption.setMockEnable(false);
  //设置定位间隔,单位毫秒,默认为2000ms
  mLocationOption.setInterval(2000);
  //给定位客户端对象设置定位参数
  mLocationClient.setLocationOption(mLocationOption);
  //启动定位
  mLocationClient.startLocation();
 }

 //定位回调函数
 @Override
 public void onLocationChanged(AMapLocation amapLocation) {
  if (amapLocation != null) {
   if (amapLocation.getErrorCode() == 0) {
    //定位成功回调信息，设置相关消息
    amapLocation.getLocationType();//获取当前定位结果来源，如网络定位结果，详见官方定位类型表
    amapLocation.getLatitude();//获取纬度
    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中设置isNeedAddress为false，则没有此结果，网络定位结果中会有地址信息，GPS定位不返回地址信息。
    amapLocation.getCountry();//国家信息
    amapLocation.getProvince();//省信息
    amapLocation.getCity();//城市信息
    amapLocation.getDistrict();//城区信息
    amapLocation.getStreet();//街道信息
    amapLocation.getStreetNum();//街道门牌号信息
    amapLocation.getCityCode();//城市编码
    amapLocation.getAdCode();//地区编码

    // 如果不设置标志位，此时再拖动地图时，它会不断将地图移动到当前的位置
    if (isFirstLoc) {
     //设置缩放级别
     aMap.moveCamera(CameraUpdateFactory.zoomTo(17));
     //将地图移动到定位点
     aMap.moveCamera(CameraUpdateFactory.changeLatLng(new LatLng(amapLocation.getLatitude(), amapLocation.getLongitude())));
     //点击定位按钮 能够将地图的中心移动到定位点
     mListener.onLocationChanged(amapLocation);
     //添加图钉
     aMap.addMarker(getMarkerOptions(amapLocation));
     //获取定位信息
     StringBuffer buffer = new StringBuffer();
     buffer.append(amapLocation.getCountry() + "" + amapLocation.getProvince() + "" + amapLocation.getCity() + "" + amapLocation.getProvince() + "" + amapLocation.getDistrict() + "" + amapLocation.getStreet() + "" + amapLocation.getStreetNum());
     Toast.makeText(getApplicationContext(), buffer.toString(), Toast.LENGTH_LONG).show();
     isFirstLoc = false;
    }

   } else {
    //显示错误信息ErrCode是错误码，errInfo是错误信息，详见错误码表。
    Log.e("AmapError", "location Error, ErrCode:"
      + amapLocation.getErrorCode() + ", errInfo:"
      + amapLocation.getErrorInfo());

    Toast.makeText(getApplicationContext(), "定位失败", Toast.LENGTH_LONG).show();
   }
  }
 }

 //自定义一个图钉，并且设置图标，当我们点击图钉时，显示设置的信息
 private MarkerOptions getMarkerOptions(AMapLocation amapLocation) {
   //设置图钉选项
  MarkerOptions options = new MarkerOptions();
  //图标
  options.icon(BitmapDescriptorFactory.fromResource(R.mipmap.fire));
  //位置
  options.position(new LatLng(amapLocation.getLatitude(), amapLocation.getLongitude()));
  StringBuffer buffer = new StringBuffer();
  buffer.append(amapLocation.getCountry() + "" + amapLocation.getProvince() + "" + amapLocation.getCity() + "" + amapLocation.getDistrict() + "" + amapLocation.getStreet() + "" + amapLocation.getStreetNum());
  //标题
  options.title(buffer.toString());
  //子标题
  options.snippet("这里好火");
  //设置多少帧刷新一次图片资源
  options.period(60);
  return options;

 }
 //激活定位
 @Override
 public void activate(OnLocationChangedListener listener) {
  mListener = listener;
 }

 //停止定位
 @Override
 public void deactivate() {
  mListener = null;
 }

 /**
  * 方法必须重写
  */
 @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();
 }
}

6、运行程序，点击自定义的 “火” 图钉，效果图如下：

Location Result.png

7、长按地图截图并保存图片

Activity实现AMap.OnMapLongClickListener和AMap.OnMapLongClickListener接口，

然后Activity的声明变为：

public class MainActivity extends AppCompatActivity implements AMap.OnMapLongClickListener, AMap.OnMapScreenShotListener, LocationSource, AMapLocationListener

分别实现下列两个的方法

 /**
  * 长按地图进行截屏
  *
  * @param latLng
  */
 @Override
 public void onMapLongClick(LatLng latLng) {

  // 设置截屏监听接口，截取地图可视区域
  // 需要传入一个 AMap.OnMapLongClickListener 接口的实现者
  aMap.getMapScreenShot(this);
 }
 /**
  * 截屏回调方法 保存截图
  */

 @Override
 public void onMapScreenShot(Bitmap bitmap) {
  SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
  try {
   // 保存在SD卡根目录下，图片为png格式。
   FileOutputStream fos = new FileOutputStream(
     Environment.getExternalStorageDirectory() + "/test_"
       + sdf.format(new Date()) + ".png");
   boolean b = bitmap.compress(Bitmap.CompressFormat.PNG, 100, fos);
   try {
    fos.flush();
   } catch (IOException e) {
    e.printStackTrace();
   }
   try {
    fos.close();
   } catch (IOException e) {
    e.printStackTrace();
   }
   if (b)

    Toast.makeText(MainActivity.this, "截屏成功", Toast.LENGTH_LONG).show();
   else {
    Toast.makeText(MainActivity.this, "截屏失败", Toast.LENGTH_LONG).show();
   }
  } catch (FileNotFoundException e) {
   e.printStackTrace();
  }
 }

2016.8.26 补充

有很多简友按照如上过程走下来，发现实现不了我的效果，因此我总结了可能的原因：

1、AndroidMainfest.xml 里一定要将自己申请的key放进去；

2、申请key时有个SHA-1的，千万不能错，错了也不能定位，因为一旦错了，就无法识别是你当前的应用了；

3、如果你使用的是3D的图，务必要将3D的库导进项目，我的案例是2D的；

4、一定要在真机测试。

有无法定位的朋友，请按照上述错误原因来排查。希望本文的内容对大家的学习或者工作能带来一定的帮助，同时也希望多多支持我们！