【FAQ】關於華為地圖服務定位存在偏差的原因及解決辦法

  • 2022 年 10 月 31 日
  • 筆記

一、 問題描述:

華為地圖服務「我的位置」能力,在中國大陸地區,向用戶展示他們在地圖上的當前位置與用戶的實際位置存在較大的偏差。

具體差別可以查看下方的圖片:

二、 偏差較大的原因:

  1. 華為Map SDK在中國大陸使用的地理坐標系是GCJ02。

  2. 點擊「我的位置」控件,獲取的定位經緯度的地理坐標系是WGS-84。

  3. 因為以上兩個原因,即地圖View和「我的位置」定位源使用的地理坐標系不一致,所以才導致了「我的位置」定位不準確的問題。

三、 解決方案:

  1. 先使用華為Location SDK通過定位獲取用戶當前所在位置,華為Location SDK使用的地理坐標系也是WGS-84。

  2. 將華為Location SDK獲取的定位經緯度轉換為GCJ02地理坐標系。

  3. 通過華為Map SDK提供的huaweiMap.setLocationSource(LocationSource locationSource)方法,設置「我的位置」圖層定位源。

四、 注意事項:

使用Location SDK獲取用戶當前所在位置信息 和 WGS84轉GCJ02坐標系的章節僅適用於6.7.0.300之前的SDK版本,因為Location SDK的6.7.0.300及之後的版本已支持直接獲取GCJ-02坐標系的經緯度。

五、 具體的實現步驟:

1. 創建已開啟「我的位置」功能的地圖實例

a. 在Activity的布局文件中添加地圖控件且設置地圖屬性。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="//schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <fragment xmlns:android="//schemas.android.com/apk/res/android"
        xmlns:map="//schemas.android.com/apk/res-auto"
        android:id="@+id/mapfragment_mapfragmentdemo"
        class="com.huawei.hms.maps.SupportMapFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        map:cameraTargetLat="48.893478"
        map:cameraTargetLng="2.334595"
        map:cameraZoom="16" />
</androidx.constraintlayout.widget.ConstraintLayout>

b. 在Activity中初始化SDK,並加載地圖。

public class HwMyLocationActivity extends AppCompatActivity implements OnMapReadyCallback {
    private HuaweiMap huaweiMap;
    private SupportMapFragment mSupportMapFragment;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //初始化SDK
        MapsInitializer.initialize(this);
        setContentView(R.layout.activity_mylocation);
        mSupportMapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.mapfragment_mapfragmentdemo);
        //加載地圖
        mSupportMapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(HuaweiMap huaweiMap) {
        //地圖數據加載完成,展示成功。
        this.huaweiMap = huaweiMap;
        huaweiMap.setMyLocationEnabled(true);
    }
}

c. 展示地圖並點擊我的位置UI控件,從三張截圖可以看出:「我的位置」與「用戶實際所在位置」存在較大偏差。



2. 使用華為Location SDK獲取用戶當前所在位置

a. 聲明FusedLocationProviderClient對象。

// 聲明fusedLocationProviderClient對象
private FusedLocationProviderClient fusedLocationProviderClient;

b. 創建LocationCallback,用於位置更新的回調。

/**
 * 定義位置更新回調
 */
LocationCallback mLocationCallback = new LocationCallback() {
    @Override
    public void onLocationResult(LocationResult locationResult) {
        if (locationResult != null) {
            // TODO: 處理位置回調結果
            Log.d("LOG_HwMyLocation", "Latitude" + locationResult.getLastHWLocation().getLatitude() +
                    " ; Longitude:" + locationResult.getLastHWLocation().getLongitude());
        }
    }
};

c. 初始化FusedLocationProviderClient對象,設置定位類型並開啟定位。

private void initLocationClient() {
    // 實例化fusedLocationProviderClient對象
    fusedLocationProviderClient = LocationServices.getFusedLocationProviderClient(this);

    LocationRequest mLocationRequest = new LocationRequest();
    // 設置位置更新的間隔(單位:毫秒)
    mLocationRequest.setInterval(1000);
    // 設置定位類型
    mLocationRequest.setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY);
    // 設置回調次數為1
    mLocationRequest.setNumUpdates(10);
    //開啟定位
    fusedLocationProviderClient.requestLocationUpdates(mLocationRequest, mLocationCallback, Looper.getMainLooper())
            .addOnSuccessListener(new OnSuccessListener<Void>() {
                @Override
                public void onSuccess(Void aVoid) {
                    // TODO: 接口調用成功的處理
                    Log.d("LOG_HwMyLocation", "定位開啟成功");
                }
            })
            .addOnFailureListener(new OnFailureListener() {
                @Override
                public void onFailure(Exception e) {
                    // TODO: 接口調用失敗的處理
                    Log.d("LOG_HwMyLocation", "定位開啟失敗:"+e.getMessage());
                }
            });
}

d. 啟動定位獲得用戶當前所在位置(WGS-84坐標系),即可得到如下結果:

e. 創建Marker標記,標記Location的定位位置,可在LocationCallback回調中調用此方法。

private Marker locationMarker;
//添加定位位置標記
public void addLocationMarker(double Latitude, double Longitude) {
    if (null != locationMarker) {
        locationMarker.remove();
    }
    MarkerOptions options = new MarkerOptions()
            .position(new LatLng(Latitude, Longitude))
            .title("定位位置")
            .snippet("定位所在位置");
    locationMarker = this.huaweiMap.addMarker(options);
}

f. 從下方2圖可以看出,Location定位獲取的位置與用戶實際所在位置存在較大偏差:


3. 將Location SDK獲取的「WGS-84坐標系」的經緯度轉換為「GCJ-02坐標系」的經緯度

a. 實現WGS-84坐標系 轉 GCJ-02坐標系的方法。

public static double pi = 3.1415926535897932384626;
public static double a = 6378245.0;
public static double ee = 0.00669342162296594323;


/**
 * WGS-84 轉 GCJ-02
 */
public static double[] wgs84_To_Gcj02(double lat, double lon) {
    if (outOfChina(lat, lon)) {
        return new double[] { lat, lon };
    }
    double dLat = transformLat(lon - 105.0, lat - 35.0);
    double dLon = transformLon(lon - 105.0, lat - 35.0);
    double radLat = lat / 180.0 * pi;
    double magic = Math.sin(radLat);
    magic = 1 - ee * magic * magic;
    double sqrtMagic = Math.sqrt(magic);
    dLat = (dLat * 180.0) / ((a * (1 - ee)) / (magic * sqrtMagic) * pi);
    dLon = (dLon * 180.0) / (a / sqrtMagic * Math.cos(radLat) * pi);
    double mgLat = lat + dLat;
    double mgLon = lon + dLon;
    return new double[] { mgLat, mgLon };
}

public static double transformLat(double x, double y) {
    double ret = -100.0 + 2.0 * x + 3.0 * y + 0.2 * y * y + 0.1 * x * y
            + 0.2 * Math.sqrt(Math.abs(x));
    ret += (20.0 * Math.sin(6.0 * x * pi) + 20.0 * Math.sin(2.0 * x * pi)) * 2.0 / 3.0;
    ret += (20.0 * Math.sin(y * pi) + 40.0 * Math.sin(y / 3.0 * pi)) * 2.0 / 3.0;
    ret += (160.0 * Math.sin(y / 12.0 * pi) + 320 * Math.sin(y * pi / 30.0)) * 2.0 / 3.0;
    return ret;
}

public static double transformLon(double x, double y) {
    double ret = 300.0 + x + 2.0 * y + 0.1 * x * x + 0.1 * x * y + 0.1
            * Math.sqrt(Math.abs(x));
    ret += (20.0 * Math.sin(6.0 * x * pi) + 20.0 * Math.sin(2.0 * x * pi)) * 2.0 / 3.0;
    ret += (20.0 * Math.sin(x * pi) + 40.0 * Math.sin(x / 3.0 * pi)) * 2.0 / 3.0;
    ret += (150.0 * Math.sin(x / 12.0 * pi) + 300.0 * Math.sin(x / 30.0
            * pi)) * 2.0 / 3.0;
    return ret;
}

public static boolean outOfChina(double lat, double lon) {
    if (lon < 72.004 || lon > 137.8347)
        return true;
    if (lat < 0.8293 || lat > 55.8271)
        return true;
    return false;
}

b. 調用上述方法,將Location SDK獲取的經緯度的坐標系轉換為GCJ-02,可在LocationCallback回調方法中執行轉換代碼。

Log.d("LOG_HwMyLocation", "WGS-86坐標系經緯度:"+ locationResult.getLastHWLocation().getLatitude() +
        " ; "+ locationResult.getLastHWLocation().getLongitude());
Log.d("LOG_HwMyLocation", "===============轉換地理坐標系===============");
double[] Gcj02LatLng = wgs84_To_Gcj02(locationResult.getLastHWLocation().getLatitude(),locationResult.getLastHWLocation().getLongitude());
Log.d("LOG_HwMyLocation", "Gcj-02坐標系經緯度:" + Gcj02LatLng[0]+" ; "+Gcj02LatLng[1]+"\n");

//將轉換坐標系之後的經緯度 標記在地圖上
addGCJ02LocationMarker(Gcj02LatLng[0], Gcj02LatLng[1]);

c. 轉換結果—日誌表現:

d. 轉換結果-用戶界面表現:從兩圖可以看出,轉換坐標系之後的經緯度 與 用戶實際所在位置經緯度無偏差。


4. 將GCJ-02坐標系的經緯度通過huaweiMap.setLocationSource(LocationSouce locationSouce)方法設置為我的位置圖層的定位源,具體實現如下:

  1. 新建MyLocationSouce類,定義定位源。
private class MyLocationSouce implements LocationSource {
    private OnLocationChangedListener listener;

    @Override
    public void activate(OnLocationChangedListener onLocationChangedListener) {
        listener = onLocationChangedListener;
    }

    @Override
    public void deactivate() {

    }

    /**
     * 改變我的位置圖層的定位源
     * @param lat_gcj02 GCJ-02
     * @param log_gcj02 GCJ-02
     */
    public void changeMyLocationSouce(double lat_gcj02, double log_gcj02) {
        Location location = new Location("Provider");

        location.setLatitude(lat_gcj02);
        location.setLongitude(log_gcj02);
        //設置精度
        location.setAccuracy(200);
        //當獲取到新的用戶位置時,調用此方法,設置定位源
        listener.onLocationChanged(location);
    }
}
  1. 初始化MyLocationSouce類 並 將MyLocationSouce設置為我的位置圖層的定位源:
private MyLocationSouce myLocationSouce;
@Override
public void onMapReady(HuaweiMap huaweiMap) {
    this.huaweiMap = huaweiMap;
    huaweiMap.setMyLocationEnabled(true);
    //初始化LocationSouce並設置我的位置圖層的位置源
    if (null == myLocationSouce){
        myLocationSouce = new MyLocationSouce();
    }
    huaweiMap.setLocationSource(myLocationSouce);
}
  1. 在LocationCallback回調方法中 將GCJ-02坐標系的經緯度 設置為定位源。
/**
 * 定義位置更新回調
 */
LocationCallback mLocationCallback = new LocationCallback() {
    @Override
    public void onLocationResult(LocationResult locationResult) {
        if (locationResult != null) {
            // TODO: 處理位置回調結果
            addLocationMarker(locationResult.getLastHWLocation().getLatitude(), locationResult.getLastHWLocation().getLongitude());
            Log.d("LOG_HwMyLocation", "WGS-86坐標系經緯度:" + locationResult.getLastHWLocation().getLatitude() +
                    " ; " + locationResult.getLastHWLocation().getLongitude());
            Log.d("LOG_HwMyLocation", "===============轉換地理坐標系===============");
            double[] Gcj02LatLng = wgs84_To_Gcj02(locationResult.getLastHWLocation().getLatitude(), locationResult.getLastHWLocation().getLongitude());
            Log.d("LOG_HwMyLocation", "Gcj-02坐標系經緯度:" + Gcj02LatLng[0] + " ; " + Gcj02LatLng[1] + "\n");

            //將轉換坐標系之後的經緯度 標記在地圖上
            addGCJ02LocationMarker(Gcj02LatLng[0], Gcj02LatLng[1]);
            if (null != myLocationSouce){
                myLocationSouce.changeMyLocationSouce(Gcj02LatLng[0],Gcj02LatLng[1]);
            }
        }
    }
};

5. 效果展示:

通過下方兩圖可以看出,我的位置圖層與用戶實際所在位置一致,且無偏差。


六、 Map SDK和Location SDK所需的權限列表有:

  1. Map SDK需要添加的權限列表:
<!-- 您調用地圖服務能力,必須在「AndroidManifest」中為您的應用添加下列權限: -->
<!--允許程序訪問網絡連接-->
<uses-permission android:name="android.permission.INTERNET"/>
<!--允許程序獲取網絡信息狀態-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!--自定義權限,允許程序讀取公共數據-->
<uses-permission android:name="com.huawei.appmarket.service.commondata.permission.GET_COMMON_DATA"/>
<!--允許改變WLAN狀態的開關-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>

<!-- 獲取設備當前位置需要在「AndroidManifest」中增加以下權限,且Android 6.0以後需動態申請: -->
<!--允許程序通過Wi-Fi或移動基站的方式獲取用戶粗略的經緯度信息-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<!--允許程序通過GPS芯片接收衛星的定位信息-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
  1. Location SDK需要添加的權限列表(部分權限列表):
<!-- Android提供了兩種位置權限: ACCESS_COARSE_LOCATION(粗略的位置權限)和ACCESS_FINE_LOCATION(精確的位置權限)。
需要在「AndroidManifest.xml」文件中配置權限,且Android 6.0以後需動態申請: -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

七、 參考資料:

  1. 華為Map SDK接入指南:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-brief-introduction-0000001061991343?ha_source=hms1

  1. 創建地圖實例:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-map-instance-creation-0000001062881706?ha_source=hms1

  1. 開啟我的位置功能:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-my-location-0000001061775973?ha_source=hms1

  1. 創建並設置Marker標記:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-map-instance-creation-0000001062881706?ha_source=hms1

  1. 設置我的位置圖層的位置源:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-References/huaweimap-0000001050151757#section1664916820220?ha_source=hms1

  1. 華為Location SDK接入指南:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-introduction-0000001121930588?ha_source=hms1

  1. 融合定位開發,獲取用戶當前所在位置:

//developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/location-develop-steps-0000001050746143?ha_source=hms1

了解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文檔
華為移動服務開源倉庫地址:GitHubGitee

關注我們,第一時間了解 HMS Core 最新技術資訊~