Android编程——高德API使用心得（一）之定位功能的实现

最新推荐文章于 2025-07-01 16:10:46 发布

原创最新推荐文章于 2025-07-01 16:10:46 发布 · 3k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#android #高德 #编程 #java

android编程学专栏收录该内容

1 篇文章

订阅专栏

本文介绍了使用高德API在Android应用中实现定位功能的步骤，包括下载API、注册账号、申请API key以及在AndroidManifest中配置key。在实现定位功能时，需要注意权限申请和代码中的细节处理，避免出现key错误。文章提供了操作指南和可能出现的问题解决方案。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

高德API使用心得（一）

前言
准备工作
- 下载高德地图的api
- 申请key
- 在AndroidManifest填入key
实现定位功能

一、前言

前段时间为了拿时长，学习了一个月的android，做了个关于路线规划的app，然后还拿了一等奖（请允许我装一下逼）。因为带了一个只会P图的萌新（连java都不太会），所以项目里的每一行基本上都是我自己一个人搞定的（情不自禁又装了一下逼）。事实证明，即使临危受命，只要自己肯花时间，不放弃，也能做得不错。

二、准备工作

言归正传，我们来手把手教学，说说如何做准备工作。

1. 下载高德地图的api

根据自己的需求，选择2D地图或者是3D地图。点击这里下载jar包

2. 注册一个高德地图api的帐号

进入高德地图api官网，点击右上角，注册一个帐号

3. 申请key

为什么要申请key呢？因为没有key的话，高德地图API中的很多功能是不允许使用的，例如定位，搜索，导航等等。
方法如下：进入控制台，点击我的应用->创建新应用->添加新的key
详细方法点击这里查看

4. 在AndroidManifest填入key

在application里面，写一个标签

<meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="请填入你的key"></meta-data>
        <activity android:name=".MainActivity">

在value处填入你的key值，name是你使用的jar包的全路径，在这里我使用的是2DMap

三、实现定位功能

终于到了真正的实现了，我们先来做个定位功能练练手
首先我要提前说明一下，我使用的IDE是Android Studio 2.2.3，使用的操作系统是win8.1（习惯了用低版本一点的…）
首先要配置AndroidMainfest.xml文件

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="填写你的包名">
    <!--//地图包、搜索包需要的基础权限-->
    <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_NOTIFICATION_POLICY"/>
    <uses-permission android:name="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE"/>
    <!--//定位包、导航包需要的额外权限（注：基础权限也需要）-->
    <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.CHANGE_WIFI_STATE" />
    <!--用于进行网络定位-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <!--用于访问GPS定位-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!--获取运营商信息，用于支持提供运营商信息相关的接口-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!--用于访问wifi网络信息，wifi信息会用于进行网络定位-->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!--这个权限用于获取wifi的获取权限，wifi信息会用来进行网络定位-->
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <!--用于访问网络，网络定位需要上网-->
    <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" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <service android:name="com.amap.api.location.APSService"/>
        <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="填写你的key"></meta-data>
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>

</manifest>

在MainActivity文件里

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mapView = (MapView) findViewById(R.id.map_view);
        //在activity执行onCreate时执行mMapView.onCreate(savedInstanceState)，实现地图生命周期管理
        mapView.onCreate(savedInstanceState);
        // 检验是否有定位权限
        if (ActivityCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            //Log.e("around", "申请权限1");
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                //Log.e("around", "申请权限2");
                //ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, 1);
                ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 1);
            }
            //return;
        }
        if (aMap == null) {
            aMap = mapView.getMap();
            //设置显示定位按钮 并且可以点击
            UiSettings settings = aMap.getUiSettings();
            aMap.setLocationSource(this);//设置了定位的监听
            // 是否显示定位按钮
            settings.setMyLocationButtonEnabled(true);
            aMap.setMyLocationEnabled(true);//显示定位层并且可以触发定位,默认是flase
        }
        //开始定位
        location();
        }

private void location() {
        //初始化定位
        mLocationClient = new AMapLocationClient(getApplicationContext());
        //设置定位回调监听
        mLocationClient.setLocationListener(this);
        //初始化定位参数
        mLocationOption = new AMapLocationClientOption();
        //设置定位模式为Hight_Accuracy高精度模式，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();
    }

//Location的回调函数
    @Override
    public void onLocationChanged(AMapLocation aMapLocation) {
        if (aMapLocation != null) {
            if (aMapLocation.getErrorCode() == 0) {
                this.aMapLocation = aMapLocation;
                //定位成功回调信息，设置相关消息
                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();//省信息
                city = 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())));
                    // 设置图标
                    MarkerOptions markerOptions = new MarkerOptions();
                    markerOptions.title("当前位置");
                    // 获得小点
                    if (latLonPoint == null) {
                        latLonPoint = new LatLonPoint(aMapLocation.getLatitude(), aMapLocation.getLongitude());
                    } else {
                        latLonPoint.setLatitude(aMapLocation.getLatitude());
                        latLonPoint.setLongitude(aMapLocation.getLongitude());
                    }
                    // 设置图片
                    markerOptions.position(new LatLng(aMapLocation.getLatitude(), aMapLocation.getLongitude()));
                    BitmapDescriptor bitmapDescriptor = BitmapDescriptorFactory.fromResource(R.drawable.navi_map_gps_locked);
                    markerOptions.icon(bitmapDescriptor);
                    aMap.addMarker(markerOptions);



                    aMap.setLocationSource(this);// 设置定位监听
                    aMap.getUiSettings().setMyLocationButtonEnabled(true);// 设置默认定位按钮是否显示

                    aMap.setMyLocationEnabled(true);// 设置为true表示显示定位层并可触发定位，false表示隐藏定位层并不可触发定位，默认是false

                    //点击定位按钮 能够将地图的中心移动到定位点
                    mListener.onLocationChanged(aMapLocation);

                    //添加图钉
                    //aMap.addMarker());
                    //获取定位信息
                    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());
                System.out.println("location Error, ErrCode:"
                        + aMapLocation.getErrorCode() + ", errInfo:"
                        + aMapLocation.getErrorInfo());
                Toast.makeText(getApplicationContext(), "定位失败", Toast.LENGTH_LONG).show();
            }
        }
    }

这里要注意几点

android 4.0之后，必须使用上述的方法来实现权限的申请，不然要自己手动在手机内分配应用权限
上述的代码要自己声明一些成员变量，以及修改一些图片，这些都可以自定义的

如果抛出了key错误异常，如

 KEY错误 请到http://lbs.amap.com/api/android-location-sdk/guide/utilities/errorcode/查看错误码说明,错误详细信息:auth fail:INVALID_USER_KEY#SHA1AndPackage#（你的sh1值）

如果你确定你申请了key，那么很有可能是你的sh1值填写错误了，你应该把你的sh1值修改成如上显示的sh1值，这样是最正确的！！！（这个东东是我尝试了多次发现的）
这里写图片描述
效果图就这样了，因为不想暴露本人渣渣的学校…
如果还有哪里有问题，欢迎在下面留言，我会一一解答的，下一篇博客估计得等我期末考考完了才有时间写了。那就这样了，886。