如何在Tab Layout结合ViewPager中添加地图并显示定位标记？

针对你在Tab Layout结合ViewPager的界面里MapView不显示地图和定位标记的问题，我结合这类场景的常见坑点，给你整理了具体的排查和修复方案：

一、严格绑定MapView与Fragment的生命周期（ViewPager场景核心） #

ViewPager会缓存或销毁非当前页的Fragment，这就要求MapView的生命周期必须和Fragment完全同步，否则地图会处于异常状态。你需要在Fragment的各个生命周期方法中调用MapView对应的方法：

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    if (mapView != null) {
        mapView.onCreate(savedInstanceState);
    }
}

@Override
public void onResume() {
    super.onResume();
    if (mapView != null) {
        mapView.onResume();
    }
}

@Override
public void onPause() {
    super.onPause();
    if (mapView != null) {
        mapView.onPause();
    }
}

@Override
public void onDestroy() {
    super.onDestroy();
    if (mapView != null) {
        mapView.onDestroy();
    }
}

@Override
public void onLowMemory() {
    super.onLowMemory();
    if (mapView != null) {
        mapView.onLowMemory();
    }
}

@Override
public void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    if (mapView != null) {
        mapView.onSaveInstanceState(outState);
    }
}

小贴士：如果用的是ViewPager2或者FragmentPagerAdapter的BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT模式，要确认onResume/onPause能正确触发，避免地图一直处于暂停状态。

二、正确初始化GoogleMap并处理定位权限 #

1. MapView与GoogleMap的绑定逻辑
   在Fragment的onCreateView里初始化MapView，并调用getMapAsync触发地图加载：

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fragment_map, container, false);
    mapView = view.findViewById(R.id.map_view);
    // 必须调用此方法来触发OnMapReadyCallback
    mapView.getMapAsync(this);
    return view;
}

@Override
public void onMapReady(GoogleMap googleMap) {
    mMap = googleMap;
    // 先检查定位权限，再开启定位图层和添加标记
    if (ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
            || ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
        mMap.setMyLocationEnabled(true);
        // 用你获取到的经纬度添加标记
        addLocationMarker(你的纬度值, 你的经度值);
    } else {
        // 主动请求定位权限
        ActivityCompat.requestPermissions(requireActivity(), new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 1001);
    }
}

// 自定义添加定位标记的方法
private void addLocationMarker(double lat, double lng) {
    LatLng targetLocation = new LatLng(lat, lng);
    mMap.addMarker(new MarkerOptions().position(targetLocation).title("我的位置"));
    // 移动相机到目标位置，缩放级别15是比较合适的街景级别
    mMap.moveCamera(CameraUpdateFactory.newLatLngZoom(targetLocation, 15));
}

2. 权限回调处理
   如果用户之前拒绝了权限，要在权限回调中重新开启定位和添加标记：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            if (mMap != null) {
                if (ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
                        || ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
                    mMap.setMyLocationEnabled(true);
                    addLocationMarker(你的纬度值, 你的经度值);
                }
            }
        }
    }
}

三、检查Google API密钥配置 #

如果地图显示空白网格，大概率是API密钥配置有问题：

• 确保在AndroidManifest.xml中正确配置了密钥：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的Google Maps API密钥"/>

• 确认你的密钥已经在Google Cloud控制台启用了Maps SDK for Android服务，并且添加了正确的包名和SHA-1指纹。

四、处理ViewPager的Fragment状态保存 #

ViewPager的offscreenPageLimit会控制缓存的Fragment数量，如果非当前Fragment被销毁，要确保MapView的状态能通过onSaveInstanceState正确保存，前面的生命周期代码已经覆盖了这部分逻辑。

内容的提问来源于stack exchange，提问作者Daniyal Saeed