高德地图 API 简易使用

作者: _Binguner | 来源:发表于2017-04-05 19:19 被阅读333次

    1.注册个人开发者

    http://lbs.amap.com/ 注册个人开发者,创建新应用,申请 Key
    SHA1获取方式:
    双击 signingReport

    获取 SHA1
    在 Android Studio 下方控制台中找到 SHAI
    获取 SHA1
    在这里为了方便可以将 发布版安全码 和 测试版安全码 填同一个 SHA1。
    获取 PackageName
    在 build.gradle 中找到 applicationId 即是 包名

    2.下载相应的 SDK

    下载SDK
    在这里只下载 地图SDK 和 定位SDK
    在相关下载页面中均选择一键下载

    3.下载好压缩包后 解压所需文件

    下载好的压缩包

    定位SDK 只需要解压其中的一个 jar 包


    定位SDK中所需的文件

    地图SDK 需解压以下文件


    定位SDK中所需要的文件

    将解压好的两个 jar 包导入工程目录下的 libs 目录下,选择 add as library 或 Sync Now
    在 main 目录下创建文件夹 jniLibs (如果有就不需要创建了),将以下文件导入文件夹中

    需要导入 jniLibs 的文件

    4.配置 AndroidManifest.xml

        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>   <!--用于网络定位-->
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />  <!--用于 GPS 定位-->
        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>   <!--用于获取运营商信息,用于支持提供运营商信息相关的接口-->
        <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>  <!--用于访问wifi网络信息,wifi信息会用于进行网络定位-->
        <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>  <!--用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
        <uses-permission android:name="android.permission.INTERNET"/><!--允许程序打开网络套接字-->
        <uses-permission android:name="android.permission.READ_PHONE_STATE"/>   <!-- 用于读取手机当前的状态 -->
        <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>     <!--用于写入缓存数据到扩展存储卡-->
        <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/><!--用于申请调用A-GPS模块-->
        <uses-permission android:name="android.permission.BLUETOOTH"/> <!-- 用于申请获取蓝牙信息进行室内定位-->
    

    然后,设置刚获取的 Key
    在 application 标签中加入如下内容:

    <meta-data android:name="com.amap.api.v2.apikey" android:value="key">
    //开发者申请的key  
    </meta-data>
    

    5.初始化地图容器

    MapView 是 AndroidView 类的一个子类, 用于在 AndroidView 中放置地图。 MapView 是地图容器。用 MapView 加载地图的方法与 Android 提供的其他 View 一样.
    在布局xml文件中添加地图控件:

    <com.amap.api.maps.MapView
    
        android:id="@+id/map"
    
        android:layout_width="match_parent"
    
        android:layout_height="match_parent"/>
    

    在 MainActivity 中声明一个 MapView

    MapView mMapView = null;
    

    在 onCreate 中实例化:

    mMapView = (MapView) findViewById(R.id.map);
     //在activity执行onCreate时执行mMapView.onCreate(savedInstanceState),创建地图
    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);
      } 
    }
    

    显示地图

    //初始化地图控制器对象
    AMap aMap;
    if (aMap == null) {
        aMap = mapView.getMap();        
    }
    

    6.显示定位蓝点

    MyLocationStyle myLocationStyle;
    myLocationStyle = new MyLocationStyle();//初始化定位蓝点样式类
    myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);//连续定位、且将视角移动到地图中心点,定位点依照设备方向旋转,并且会跟随设备移动。(1秒1次定位)如果不设置myLocationType,默认也会执行此种模式。
    myLocationStyle.interval(2000); //设置连续定位模式下的定位间隔,只在连续定位模式下生效,单次定位模式下不会生效。单位为毫秒。
    
    //MyLocationStyle myLocationIcon(BitmapDescriptor myLocationIcon);//设置定位蓝点的icon图标方法,需要用到BitmapDescriptor类对象作为参数。
    MyLocationStyle strokeColor(0);//设置定位蓝点精度圆圈的边框颜色的方法。
    MyLocationStyle radiusFillColor(0);//设置定位蓝点精度圆圈的填充颜色的方法。
    
    aMap.setMyLocationStyle(myLocationStyle);//设置定位蓝点的Style
            //aMap.getUiSettings().setMyLocationButtonEnabled(true);设置默认定位按钮是否显示,非必需设置。
    aMap.setMyLocationEnabled(true);// 设置为true表示启动显示定位蓝点,false表示隐藏定位蓝点并不进行定位,默认是false。
            //将定位风格设置传给地图控制器
    aMap.setMyLocationStyle(myLocationStyle);aMap.setMyLocationEnabled(true);
    aMap.moveCamera(CameraUpdateFactory.zoomTo(17)); //设置缩放级别为17
    aMap.showIndoorMap(true); //显示室内地图
    
    
    

    定位蓝点提供5种模式:

    myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_SHOW);//只定位一次。
    myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATE) ;//定位一次,且将视角移动到地图中心点。
    myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_FOLLOW) ;//连续定位、且将视角移动到地图中心点,定位蓝点跟随设备移动。(1秒1次定位)
    myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_MAP_ROTATE);//连续定位、且将视角移动到地图中心点,地图依照设备方向旋转,定位点会跟随设备移动。(1秒1次定位)
    myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);//连续定位、且将视角移动到地图中心点,定位点依照设备方向旋转,并且会跟随设备移动。(1秒1次定位)默认执行此种模式。
    

    设置定位刷新事件
    new 一个 Button,并添加刷新事件:

    private void Refresh(){
            mLocationClient = new AMapLocationClient(getApplicationContext());
            mLocationOption = new AMapLocationClientOption();
            mLocationOption.setOnceLocation(true); //设置为单次定位模式
            mLocationOption.setNeedAddress(true); //返回地址描述
            mLocationOption.setHttpTimeOut(10000); //设置请求超时时间
            mLocationClient.setLocationOption(mLocationOption);
    
            //设置定位回调监听器
            mLocationClient.setLocationListener(new AMapLocationListener() {
                @Override
                public void onLocationChanged(AMapLocation aMapLocation) {
                    if(aMapLocation != null){
                        LatLng latLng = new LatLng(aMapLocation.getLatitude(), aMapLocation.getLongitude());
                        if(locationMarker == null){
                            locationMarker = aMap.addMarker(new MarkerOptions()
                                    .position(latLng)
                                    .icon(BitmapDescriptorFactory.fromResource(R.drawable.center_marker2)));
                        }else{
                            locationMarker.setPosition(latLng);
                        }
                        //将标记移动到定位点,使用animateCamera就有动画效果
                        aMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng, 17));
                    }else{
                        Toast.makeText(MainActivity.this, "定位失败", Toast.LENGTH_SHORT).show();
                    }
                }
            });
    }
    

    设置地图内的指南针或者缩放按钮等

    private UiSettings mUiSettings;
    mUiSettings = aMap.getUiSettings();
    mUiSettings.setZoomControlsEnabled(false); //缩放按钮的显示与隐藏
    mUiSettings.setCompassEnabled(false); //指南针的显示与隐藏
    mUiSettings.setScaleControlsEnabled(false); //比例尺的显示与隐藏
    mUiSettings.setLogoPosition(AMapOptions.LOGO_POSITION_BOTTOM_LEFT); //         设置LOGO位置
    mUiSettings.setRotateGesturesEnabled(false); //禁止旋转
    

    相关文章

      网友评论

      本文标题:高德地图 API 简易使用

      本文链接:https://www.haomeiwen.com/subject/nfexattx.html