You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

模拟器正常、真机无法获取当前位置并添加地图标记问题求助

真机无法显示当前位置标记的排查与解决方案

这种模拟器正常、真机出问题的场景我碰到过很多,大概率是这几个关键环节没处理到位,咱们一步步来排查:

1. 权限问题:只抑制警告但没真正获取权限

你代码里的@SuppressLint("MissingPermission")只是让编译器不再报错,但真机上必须主动请求并获取位置权限——模拟器通常会默认授予权限,但真机用户需要手动同意。

你需要补充动态权限申请逻辑,比如在调用loadmap()前先检查权限:

private static final int LOCATION_PERMISSION_REQUEST = 1001;

// 在合适的时机(比如onCreate)调用权限检查
private void checkLocationPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                LOCATION_PERMISSION_REQUEST);
    } else {
        // 权限已获取,加载地图
        loadmap();
    }
}

// 处理权限申请回调
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == LOCATION_PERMISSION_REQUEST) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            loadmap();
        } else {
            Toast.makeText(this, "需要位置权限才能显示当前位置标记", Toast.LENGTH_SHORT).show();
        }
    }
}

同时别忘了在AndroidManifest.xml里声明基础权限:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

2. Release版本的Google Maps API密钥配置错误

模拟器用的是debug签名密钥,而你打包APK用的是release密钥,这两个密钥对应的Google Maps API密钥是独立的——如果只配置了debug的API密钥,release版本会无法加载地图服务。

解决步骤:

  • 生成release密钥的SHA-1指纹
  • 登录Google Cloud控制台,把这个SHA-1添加到你的Maps SDK API密钥的允许列表中
  • 在build.gradle(app)里分别配置debug和release的API密钥,避免混用:
buildTypes {
    release {
        resValue "string", "google_maps_key", "你的release环境API密钥"
        // 其他release配置
    }
    debug {
        resValue "string", "google_maps_key", "你的debug环境API密钥"
    }
}

然后在AndroidManifest.xml中引用这个动态配置的密钥:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="@string/google_maps_key" />

3. 真机位置服务未开启

模拟器默认会开启位置服务,但真机用户可能手动关闭了GPS或网络定位。你可以在代码里检查状态,引导用户开启:

private void checkLocationService() {
    LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
    boolean isGpsEnabled = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);
    boolean isNetworkEnabled = locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER);

    if (!isGpsEnabled && !isNetworkEnabled) {
        Intent intent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
        startActivity(intent);
        Toast.makeText(this, "请开启位置服务以获取当前位置", Toast.LENGTH_SHORT).show();
    }
}

4. 代码未实现"添加标记"的逻辑

你的代码片段里只有googleMap.moveCamera...,但没看到获取当前位置并添加标记的代码。如果要显示标记,需要结合位置服务获取坐标后添加:

// 在onMapReady里添加位置获取逻辑
@SuppressLint("MissingPermission")
@Override
public void onMapReady(GoogleMap googleMap) {
    MainActivity.this.googleMap = googleMap;
    
    FusedLocationProviderClient fusedLocationClient = LocationServices.getFusedLocationProviderClient(MainActivity.this);
    fusedLocationClient.getLastLocation()
            .addOnSuccessListener(location -> {
                if (location != null) {
                    LatLng currentLatLng = new LatLng(location.getLatitude(), location.getLongitude());
                    // 添加当前位置标记
                    googleMap.addMarker(new MarkerOptions()
                            .position(currentLatLng)
                            .title("我的位置")
                            .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_BLUE)));
                    // 移动相机到当前位置
                    googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(currentLatLng, 15));
                }
            });
}

优先排查权限和API密钥这两个最常见的问题,基本能解决大部分真机不显示标记的情况。

内容的提问来源于stack exchange,提问作者spilote nilo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.26 09:25:46