新版Autocomplete API中AutocompleteSupportFragment的等价组件及地图叠加搜索栏迁移问题

我完全懂你想要UI统一的执念——不同页面的Autocomplete组件风格不一样，用户看着别扭，我们开发者也难受！刚好我之前也遇到过类似的需求，给你梳理下解决方案：

首先得明确：新版的Place Autocomplete API（就是你其他地方用的那种启动Activity的方式）确实没有提供和AutocompleteSupportFragment完全等价的Fragment嵌入组件，官方现在把Autocomplete的UI统一成了全屏/底部弹窗的样式，不再支持直接嵌入到现有布局中。但我们可以通过自定义触发搜索栏+唤起新Autocomplete Activity的方式，实现和原来一样的“地图叠加搜索”功能，同时保持UI和其他页面一致。

具体实现步骤 #

1. 替换原有Fragment布局

把原来布局中R.id.place_autocomplete的AutocompleteSupportFragment替换成一个自定义的搜索栏组件（比如EditText或者带样式的Button，样式和你其他地方的新Autocomplete组件保持一致）。示例布局如下：

<CardView android:id="@+id/search_bar_card_view" ...>
    <!-- 替换原来的AutocompleteSupportFragment为自定义搜索栏 -->
    <EditText
        android:id="@+id/custom_search_bar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="搜索地点"
        <!-- 这里设置和你其他Autocomplete组件一致的样式 -->
        />
</CardView>

2. 初始化Autocomplete Launcher

在你的Activity/Fragment中，注册一个ActivityResultLauncher来处理Autocomplete Activity的返回结果，这部分和你其他地方用新API的逻辑一致：

private lateinit var autocompleteLauncher: ActivityResultLauncher<Intent>

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ... 其他初始化代码 ...

    // 初始化Autocomplete Launcher
    autocompleteLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
        if (result.resultCode == Activity.RESULT_OK) {
            result.data?.let { intent ->
                val selectedPlace = Autocomplete.getPlaceFromIntent(intent)
                // 复用你原来的Place处理逻辑
                handleSelectedPlace(selectedPlace)
            }
        } else if (result.resultCode == AutocompleteActivity.RESULT_ERROR) {
            result.data?.let { intent ->
                val status = Autocomplete.getStatusFromIntent(intent)
                Log.d(TAG, "Autocomplete error: ${status.statusMessage}")
            }
        }
    }
}

// 把原来的onPlaceSelected逻辑抽成独立方法，复用更方便
private fun handleSelectedPlace(place: Place) {
    latitude = place.latLng!!.latitude
    longitude = place.latLng!!.longitude
    setAddress(latitude, longitude)
    map.clear()
    map.setOnMapLoadedCallback {
        setPlaceDetails(latitude, longitude, shortAddress, fullAddress)
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(LatLng(latitude, longitude), zoom))
    }
}

3. 重构搜索栏显示逻辑

修改原来的showSearchBar()方法，替换成点击自定义搜索栏唤起新Autocomplete Activity的逻辑：

private fun showSearchBar() {
    if (!Places.isInitialized()) {
        Places.initialize(applicationContext, googleApiKey!!)
    }

    val searchBar = findViewById<EditText>(R.id.custom_search_bar)
    findViewById<CardView>(R.id.search_bar_card_view).visibility = View.VISIBLE

    // 设置搜索栏点击事件，唤起新Autocomplete UI
    searchBar.setOnClickListener {
        // 配置需要获取的Place字段，和原来保持一致
        val requiredFields = listOf(
            Place.Field.ID,
            Place.Field.NAME,
            Place.Field.LAT_LNG,
            Place.Field.ADDRESS,
            Place.Field.ADDRESS_COMPONENTS
        )

        // 构建Autocomplete Intent，这里可以设置显示模式（OVERLAY是底部弹窗，FULLSCREEN是全屏）
        val autocompleteIntent = Autocomplete.IntentBuilder(AutocompleteActivityMode.OVERLAY, requiredFields)
            // 可选：限制搜索国家，比如中国填"CN"
            // .setCountry("CN")
            .build(this)
        autocompleteLauncher.launch(autocompleteIntent)
    }

    // 可选：设置搜索栏默认显示当前地址
    searchBar.setText(shortAddress)
}

额外说明 #

• 为什么官方不提供Fragment版本？因为新版Autocomplete UI做了自适应（手机上是底部弹窗，平板上是侧边栏），官方希望统一这种交互体验，所以不再支持嵌入式Fragment。
• 如果一定要做“实时提示在地图上叠加”的效果，那需要自己调用AutocompletePredictionClient获取预测结果，然后用AutoCompleteTextView自定义Adapter，但这样需要自己维护样式和逻辑，不如官方Launcher方式省心，而且很难做到和官方UI完全一致。

这样修改后，你的地图搜索栏点击后会唤起和其他页面完全一样的新Autocomplete UI，选择地点后更新地图，完美实现UI一致性！

内容来源于stack exchange