一、 問題描述:
華為地圖服務“我的位置”能力,在中國大陸地區,向使用者展示他們在地圖上的目前位置與使用者的實際位置存在較大的偏差。
具體差别可以檢視下方的圖檔:
二、 偏差較大的原因:
- 華為Map SDK在中國大陸使用的地理坐标系是GCJ02。
- 點選“我的位置”控件,擷取的定位經緯度的地理坐标系是WGS-84。
- 因為以上兩個原因,即地圖View和“我的位置”定位源使用的地理坐标系不一緻,是以才導緻了“我的位置”定位不準确的問題。
三、 解決方案:
- 先使用華為Location SDK通過定位擷取使用者目前所在位置,華為Location SDK使用的地理坐标系也是WGS-84。
- 将華為Location SDK擷取的定位經緯度轉換為GCJ02地理坐标系。
- 通過華為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="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://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)方法設定為我的位置圖層的定位源,具體實作如下:
- 建立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);
}
}
- 初始化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);
}
- 在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所需的權限清單有:
- 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"/>
- 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"/>
七、 參考資料:
- 華為Map SDK接入指南:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-brief-introduction-0000001061991343?ha_source=hms1
- 建立地圖執行個體:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-map-instance-creation-0000001062881706?ha_source=hms1
- 開啟我的位置功能:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-my-location-0000001061775973?ha_source=hms1
- 建立并設定Marker标記:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-sdk-map-instance-creation-0000001062881706?ha_source=hms1
- 設定我的位置圖層的位置源:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/huaweimap-0000001050151757#section1664916820220?ha_source=hms1
- 華為Location SDK接入指南:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-introduction-0000001121930588?ha_source=hms1
- 融合定位開發,擷取使用者目前所在位置:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/location-develop-steps-0000001050746143?ha_source=hms1