在应用开发中,地图开发是经常需要使用的“组件”,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、一定要在真机测试。
有无法定位的朋友,请按照上述错误原因来排查。希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持找一找教程网!