Android Google 地方自动完成示例

简介

Google 地方自动完成是一个用于在用户输入到搜索框时自动检索地方或地址的功能。在 Android 应用程序开发中，我们可以使用 Google API 来实现 Google 地方自动完成。

本文将介绍如何在 Android 应用程序中使用 Google 地方自动完成 API。

准备工作

在开始之前，你需要准备好以下内容：

• 一个 Google 地图 API key。你可以从 Google 开发者控制台中获取。

• Android Studio集成开发环境。

步骤

创建新项目

首先我们需要在 Android Studio 中创建一个新项目。

获取 Google API key

在开始之前，你需要在 Google 开发者控制台中创建一个 API key。具体步骤如下：

1. 打开 Google 开发者控制台

2. 创建一个新项目

3. 在 API & 身份验证 页面中，启用 Google 地图 Android API v2 服务

4. 在 API & 身份验证 页面中，创建一个新的 API key

添加 Google 地图 Android API v2 依赖

在 build.gradle (Module: app) 文件中添加以下代码：

    dependencies {
        implementation 'com.google.android.gms:play-services-maps:17.0.0'
    }

添加 Google 地图视图

在您的活动或碎片布局文件中添加以下内容：

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

实现自动完成

实现自动完成接口

您需要实现 OnPlaceSelectedListener 接口。这将允许您监听用户输入的位置，并在选择位置时获取更多信息。

在您的活动或碎片类中，实现 OnPlaceSelectedListener 接口：

public class MainActivity extends AppCompatActivity implements
        OnPlaceSelectedListener {

    // ...

    @Override
    public void onPlaceSelected(Place place) {
        // Get the details of the selected place.
        Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
    }

    @Override
    public void onError(Status status) {
        // Handle the error.
        Log.i(TAG, "An error occurred: " + status);
    }
}

初始化自动完成控件

您需要创建一个 PlacesClient 并将其传递给 AutocompleteSupportFragment。这将启用自动完成，并使其与您的 API key 关联。

在你的活动或碎片类中，添加以下代码：

// Initialize the SDK
Places.initialize(getApplicationContext(), getString(R.string.google_maps_key));

// Create a new Places client instance
PlacesClient placesClient = Places.createClient(this);

// Initialize the autocomplete support fragment.
AutocompleteSupportFragment autocompleteFragment = (AutocompleteSupportFragment)
    getSupportFragmentManager().findFragmentById(R.id.autocomplete_fragment);

// Set the Place Fields to Return
autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME));

// Set a listener for autocomplete events.
autocompleteFragment.setOnPlaceSelectedListener((OnPlaceSelectedListener) this);

运行应用

现在您的应用程序已启用自动完成，它将使用您的 Google 地图 API key 来自动完成位置输入。

您可以在应用程序中测试此功能，并在用户输入地址时观察自动完成建议。它们将显示在自动完成搜索框下方。

结论

Google API 非常强大，它提供了各种服务，包括 Google 地方自动完成。在本文中，我们了解了如何在 Android 应用程序中使用 Google 地方自动完成 API。

现在，您可以使用此功能来改进您的应用程序体验，让用户更加轻松地查找他们需要的位置或地址。