Fragment中Google Maps相机无法跳转指定固定位置的问题咨询

我有一个搭载BottomNavigationMenu的MainActivity，可实现多Fragment切换。其中首页Fragment需展示带标记点的Google Maps，但地图相机未跳转至指定固定位置。请问问题原因是什么？是否需实现继承SupportMapFragment的类来正确显示地图？

实际效果与预期效果 #

• 实际效果：地图默认显示初始区域（如非洲中部），标记点已添加但相机未移动到指定坐标位置
• 预期效果：地图相机自动定位到标记点所在的(40.1234, 13.1234)位置

代码实现 #

Homepage.kt #

class HomepageFragment : Fragment(), GoogleMap.OnMyLocationButtonClickListener,
    GoogleMap.OnMyLocationClickListener, OnMapReadyCallback {

    private lateinit var map: GoogleMap
    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val mapFragment = childFragmentManager.findFragmentById(R.id.map_fragment) as SupportMapFragment?
       mapFragment?.getMapAsync(this)
        return inflater.inflate(R.layout.fragment_homepage, container, false)
    }

    override fun onMyLocationButtonClick(): Boolean {
        // TODO something
        return false
    }

    override fun onMyLocationClick(location: Location) {
        // TODO something
    }

    override fun onMapReady(googleMap: GoogleMap) {
        map = googleMap
        map.setOnMyLocationButtonClickListener(this)
        map.setOnMyLocationClickListener(this)

        val fixedPosition: LatLng = LatLng(40.1234, 13.1234)
        map.addMarker(
            MarkerOptions()
                .position(fixedPosition)
                .title("My fixed position")
        )
        map.moveCamera(CameraUpdateFactory.newLatLng(fixedPosition))
    }

}

fragment_homepage.xml #

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".fragments.HomepageFragment">

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/map_fragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:name="com.google.android.gms.maps.SupportMapFragment"/>

</androidx.constraintlayout.widget.ConstraintLayout>

问题原因与解决方案 #

问题原因 #

1. 布局加载顺序错误：在onCreateView中，你先尝试通过childFragmentManager.findFragmentById获取地图Fragment，再加载布局。此时布局尚未被添加到视图树中，findFragmentById会返回null，导致getMapAsync未被触发，后续的相机移动逻辑完全没有执行。
2. 不需要继承SupportMapFragment，当前的嵌套Fragment实现方式是官方推荐的正确写法，问题仅出在代码执行顺序上。

修复方案 #

调整onCreateView的代码顺序，先加载布局，再获取地图Fragment：

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View? {
    // 先加载布局并获取view实例
    val view = inflater.inflate(R.layout.fragment_homepage, container, false)
    // 从已加载的view中查找地图Fragment
    val mapFragment = childFragmentManager.findFragmentById(R.id.map_fragment) as SupportMapFragment?
    mapFragment?.getMapAsync(this)
    return view
}

可选优化 #

如果希望相机移动到指定位置时带有合适的缩放级别，可以使用newLatLngZoom替代newLatLng，示例如下：

// 第二个参数为缩放级别，范围2（最广）到21（最精细）
map.moveCamera(CameraUpdateFactory.newLatLngZoom(fixedPosition, 15f))

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