Place Autocomplete

Places SDK for Android のオートコンプリート サービスは、ユーザーの検索クエリに応じて場所の予測を返します。オートコンプリート サービスは、ユーザーの入力に応じて、ビジネス、住所、Plus Codes、スポットなどの場所の候補を返します。

次の方法でアプリにオートコンプリート機能を追加することができます。

• オートコンプリート ウィジェットを追加すると、開発時間を短縮し、一貫したユーザー エクスペリエンスを確保できます。
• プログラムから場所の予測を取得し、カスタマイズされたユーザー エクスペリエンスを実現します。

オートコンプリート ウィジェットを追加する

オートコンプリート ウィジェットは、オートコンプリート機能が組み込まれた検索ダイアログです。ユーザーが検索キーワードを入力すると、予測される場所のリストがウィジェットに表示されます。ユーザーが選択すると、Place インスタンスが返されます。アプリは、これを使用して、選択された場所の詳細を取得できます。

オートコンプリート ウィジェットをアプリに追加する方法として、次の 2 つのオプションがあります。

• オプション 1: AutocompleteSupportFragment を埋め込む。
• オプション 2: インテントを使用してオートコンプリート アクティビティを起動する

オプション 1: AutocompleteSupportFragment を埋め込む

アプリに AutocompleteSupportFragment を追加する手順は次のとおりです。

1. アクティビティの XML レイアウトにフラグメントを追加します。
2. アクティビティまたはフラグメントにリスナーを追加します。

AutocompleteSupportFragment をアクティビティに追加する

アクティビティに AutocompleteSupportFragment を追加するには、新しいフラグメントを XML レイアウトに追加します。例:

<fragment android:id="@+id/autocomplete_fragment"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:name="com.google.android.libraries.places.widget.AutocompleteSupportFragment"
  />

• デフォルトでは、フラグメントに枠線や背景はありません。一貫した外観を提供するには、CardView などの別のレイアウト要素内にフラグメントをネストします。
• オートコンプリート フラグメントを使用していて onActivityResult をオーバーライドする必要がある場合は、super.onActivityResult を呼び出す必要があります。そうしないと、フラグメントが適切に機能しません。

PlaceSelectionListener をアクティビティに追加する

PlaceSelectionListener は、ユーザーの選択に応じて場所を返す処理を行います。次のコードは、フラグメントへの参照を作成し、AutocompleteSupportFragment にリスナーを追加する方法を示しています。

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

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME));

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() {
        @Override
        public void onPlaceSelected(@NonNull Place place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
        }


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

      

    // Initialize the AutocompleteSupportFragment.
    val autocompleteFragment =
        supportFragmentManager.findFragmentById(R.id.autocomplete_fragment)
            as AutocompleteSupportFragment

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(listOf(Place.Field.ID, Place.Field.NAME))

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener {
        override fun onPlaceSelected(place: Place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: ${place.name}, ${place.id}")
        }

        override fun onError(status: Status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: $status")
        }
    })

      

オプション 2: インテントを使用してオートコンプリート アクティビティを起動する

アプリで別のナビゲーション フローを使用したい場合（たとえば、検索フィールドではなくアイコンからオートコンプリート エクスペリエンスをトリガーする場合）、アプリはインテントを使用してオートコンプリートを起動できます。

インテントを使用してオートコンプリート ウィジェットを起動するには、次の手順を実行します。

1. Autocomplete.IntentBuilder を使用してインテントを作成し、目的の Autocomplete モードを渡します。インテントは startActivityForResult を呼び出し、インテントを識別するリクエスト コードを渡す必要があります。
2. 選択した場所を受け取るように onActivityResult コールバックをオーバーライドします。

オートコンプリート インテントを作成する

以下の例は、Autocomplete.IntentBuilder を使用して、オートコンプリート ウィジェットをインテントとして起動するインテントを作成する方法を示しています。

    private static int AUTOCOMPLETE_REQUEST_CODE = 1;

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    List<Place.Field> fields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

    // Start the autocomplete intent.
    Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .build(this);
    startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE);

      

    private val AUTOCOMPLETE_REQUEST_CODE = 1

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    val fields = listOf(Place.Field.ID, Place.Field.NAME)

    // Start the autocomplete intent.
    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .build(this)
    startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE)

      

インテントを使用してオートコンプリート ウィジェットを起動する場合は、オーバーレイ モードと全画面ディスプレイ モードから選択できます。次のスクリーンショットは、それぞれ各表示モードを示しています。

onActivityResult コールバックをオーバーライドする

ユーザーが場所を選択したときに通知を受け取るには、次の例に示すように、アプリでアクティビティの onActivityResult() をオーバーライドして、インテントに渡されたリクエスト コードを確認する必要があります。

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    if (requestCode == AUTOCOMPLETE_REQUEST_CODE) {
        if (resultCode == RESULT_OK) {
            Place place = Autocomplete.getPlaceFromIntent(data);
            Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
        } else if (resultCode == AutocompleteActivity.RESULT_ERROR) {
            // TODO: Handle the error.
            Status status = Autocomplete.getStatusFromIntent(data);
            Log.i(TAG, status.getStatusMessage());
        } else if (resultCode == RESULT_CANCELED) {
            // The user canceled the operation.
        }
        return;
    }
    super.onActivityResult(requestCode, resultCode, data);
}

      

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    if (requestCode == AUTOCOMPLETE_REQUEST_CODE) {
        when (resultCode) {
            Activity.RESULT_OK -> {
                data?.let {
                    val place = Autocomplete.getPlaceFromIntent(data)
                    Log.i(TAG, "Place: ${place.name}, ${place.id}")
                }
            }
            AutocompleteActivity.RESULT_ERROR -> {
                // TODO: Handle the error.
                data?.let {
                    val status = Autocomplete.getStatusFromIntent(data)
                    Log.i(TAG, status.statusMessage ?: "")
                }
            }
            Activity.RESULT_CANCELED -> {
                // The user canceled the operation.
            }
        }
        return
    }
    super.onActivityResult(requestCode, resultCode, data)
}

      

プログラムで場所の予測を取得する

オートコンプリート ウィジェットで提供される UI の代わりに、カスタム検索 UI を作成できます。これを行うには、アプリでプログラムによって場所の予測を取得する必要があります。アプリでは、PlacesClient.findAutocompletePredictions() を呼び出して以下のパラメータで FindAutocompletePredictionsRequest オブジェクトを渡すことで、Autocomplete API から予測される場所の名前や住所のリストを取得できます。

• 必須: ユーザーが入力したテキストを含む query 文字列。
• 推奨:AutocompleteSessionToken。請求処理のために、ユーザー検索のクエリフェーズと選択フェーズを個別のセッションにグループ化します。セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択すると終了します。
• 推奨:RectangularBounds オブジェクト。指定されたリージョンに結果を制限するために緯度と経度の境界を指定します。
• 省略可: 結果を制限する国を示す 2 文字の国コード（ISO 3166-1 Alpha-2）を 1 つ以上入力します。

• 省略可: TypeFilter。結果を指定された場所のタイプに制限するために使用できます。次の場所タイプがサポートされています。

  • TypeFilter.GEOCODE - ビジネスではなく、ジオコーディングの結果のみを返します。このリクエストを使用して、はっきり特定できない場所を明確にします。
  • TypeFilter.ADDRESS - 正確な住所のオートコンプリートの結果のみを返します。このタイプは、ユーザーが完全な住所を指定して検索することがわかっている場合に使用します。
  • TypeFilter.ESTABLISHMENT - ビジネスの場所のみを返します。

  • TypeFilter.REGIONS - 次のいずれかのタイプに一致する場所のみを返します。

    • LOCALITY
    • SUBLOCALITY
    • POSTAL_CODE
    • COUNTRY
    • ADMINISTRATIVE_AREA_LEVEL_1
    • ADMINISTRATIVE_AREA_LEVEL_2

  • TypeFilter.CITIES - LOCALITY または ADMINISTRATIVE_AREA_LEVEL_3 に一致する結果のみを返します。

• 省略可: リクエストの送信元のロケーションを指定する LatLng。setOrigin() を呼び出すと、レスポンス内のオートコンプリート候補ごとに、指定されたオリジンからの距離（メートル（distanceMeters））が返されます。

場所のタイプについては、場所のタイプに関するガイドをご覧ください。

以下の例は、PlacesClient.findAutocompletePredictions() の完全な呼び出しを示しています。

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    AutocompleteSessionToken token = AutocompleteSessionToken.newInstance();

    // Create a RectangularBounds object.
    RectangularBounds bounds = RectangularBounds.newInstance(
        new LatLng(-33.880490, 151.184363),
        new LatLng(-33.858754, 151.229596));
    // Use the builder to create a FindAutocompletePredictionsRequest.
    FindAutocompletePredictionsRequest request = FindAutocompletePredictionsRequest.builder()
        // Call either setLocationBias() OR setLocationRestriction().
        .setLocationBias(bounds)
        //.setLocationRestriction(bounds)
        .setOrigin(new LatLng(-33.8749937,151.2041382))
        .setCountries("AU", "NZ")
        .setTypesFilter(Arrays.asList(TypeFilter.ADDRESS.toString()))
        .setSessionToken(token)
        .setQuery(query)
        .build();

    placesClient.findAutocompletePredictions(request).addOnSuccessListener((response) -> {
        for (AutocompletePrediction prediction : response.getAutocompletePredictions()) {
            Log.i(TAG, prediction.getPlaceId());
            Log.i(TAG, prediction.getPrimaryText(null).toString());
        }
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            ApiException apiException = (ApiException) exception;
            Log.e(TAG, "Place not found: " + apiException.getStatusCode());
        }
    });

      

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    val token = AutocompleteSessionToken.newInstance()

    // Create a RectangularBounds object.
    val bounds = RectangularBounds.newInstance(
        LatLng(-33.880490, 151.184363),
        LatLng(-33.858754, 151.229596)
    )
    // Use the builder to create a FindAutocompletePredictionsRequest.
    val request =
        FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(listOf(TypeFilter.ADDRESS.toString()))
            .setSessionToken(token)
            .setQuery(query)
            .build()
    placesClient.findAutocompletePredictions(request)
        .addOnSuccessListener { response: FindAutocompletePredictionsResponse ->
            for (prediction in response.autocompletePredictions) {
                Log.i(TAG, prediction.placeId)
                Log.i(TAG, prediction.getPrimaryText(null).toString())
            }
        }.addOnFailureListener { exception: Exception? ->
            if (exception is ApiException) {
                Log.e(TAG, "Place not found: " + exception.statusCode)
            }
        }

      

API が Task で FindAutocompletePredictionsResponse を返します。FindAutocompletePredictionsResponse には、予測された場所を表す AutocompletePrediction オブジェクトのリストが含まれます。クエリとフィルタ条件に対応する既知の場所がない場合、リストは空です。

予測された場所ごとに、次のメソッドを呼び出して Place Details を取得できます。

• getFullText(CharacterStyle) は、場所の説明の全文を返します。これは、プライマリ テキストとセカンダリ テキストを組み合わせたものです。例: 「エッフェル塔、アナトール フランス通り（パリ、フランス）」また、このメソッドでは、CharacterStyle を使用して、検索と一致する任意のセクションを、任意のスタイルでハイライト表示できます。CharacterStyle パラメータは省略可能です。ハイライトが不要な場合は null に設定します。
• getPrimaryText(CharacterStyle) は、場所を表すメインのテキストを返します。これは通常、場所の名前です。たとえば、「エッフェル塔」、「123 Pitt Street」などです。
• getSecondaryText(CharacterStyle) は、場所の説明の子テキストを返します。これは、オートコンプリートの予測の 2 行目などに役立ちます。例: 「Avenue Anatole France、Paris, France」、「Sydney, New South Wales」など。
• getPlaceId() は、予測された場所の場所 ID を返します。場所 ID は、場所を一意に識別するテキスト表記の ID です。ID を使用すると、後で Place オブジェクトを再度取得できます。Places SDK for Android の場所 ID について詳しくは、Place Details をご覧ください。場所 ID の概要については、場所 ID の概要をご覧ください。
• getPlaceTypes() は、この場所に関連付けられている場所のタイプのリストを返します。
• getDistanceMeters() は、この場所からリクエストで指定された出発地までの直線距離をメートル単位で返します。

セッション トークン

セッション トークンは、オートコンプリート検索のクエリと選択フェーズを、請求処理のために個別のセッションにグループ化します。セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択すると終了します。各セッションには複数のクエリがあり、その後に 1 つの場所が選択される場合があります。セッションが終了すると、トークンは無効になります。アプリはセッションごとに新しいトークンを生成する必要があります。すべてのプログラマティック オートコンプリート セッションでセッション トークンを使用することをおすすめします（フラグメントを埋め込むか、インテントを使用してオートコンプリートを起動する場合、API によって自動的に処理されます）。

Places SDK for Android は、AutocompleteSessionToken を使用して各セッションを識別します。アプリは、新しいセッションが開始されるたびに新しいセッション トークンを渡して、その後の fetchPlace() の呼び出しで、この同じトークンを場所 ID とともに渡して、ユーザーが選択した場所の Place Details を取得する必要があります。

セッション トークンの詳細

オートコンプリートの結果を制限する

オートコンプリートの結果を特定の地域に制限したり、1 つ以上の場所タイプ、または最大 5 つの国に結果をフィルタしたりできます。これらの制約は、オートコンプリート アクティビティ、AutocompleteSupportFragment、プログラマティック オートコンプリート API に適用できます。

結果を制限する手順は次のとおりです。

• 定義済みのリージョン内の結果を優先するには、setLocationBias() を呼び出します（定義されたリージョン外からの結果は返される場合があります）。
• 定義済みのリージョン内の結果のみを表示するには、setLocationRestriction() を呼び出します（定義済みのリージョンの結果のみが返されます）。
• 特定の場所のタイプに適合する結果のみを返すには、setTypesFilter() を呼び出します（たとえば、TypeFilter.ADDRESS を指定すると、正確な住所を含む結果のみが返されます）。
• 指定した最大 5 つの国の結果のみを返すには、setCountries() を呼び出します。国は、ISO 3166-1 Alpha-2 に準拠した 2 文字の国コードとして渡す必要があります。

特定の地域を優先するよう結果にバイアスを設定する

オートコンプリートの結果を特定の地域に限定するには、setLocationBias() を呼び出して RectangularBounds を渡します。次のコード例では、フラグメント インスタンスで setLocationBias() を呼び出して、オートコンプリートの候補をオーストラリアのシドニー領域にバイアスしています。

    autocompleteFragment.setLocationBias(RectangularBounds.newInstance(
        new LatLng(-33.880490, 151.184363),
        new LatLng(-33.858754, 151.229596)));

      

    autocompleteFragment.setLocationBias(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

結果を特定の地域に限定する

オートコンプリートの結果を特定の地域に制限するには、setLocationRestriction() を呼び出して、RectangularBounds を渡します。次のコード例は、フラグメント インスタンスで setLocationRestriction() を呼び出して、オートコンプリートの候補をオーストラリアのシドニー リージョンにバイアスする方法を示しています。

    autocompleteFragment.setLocationRestriction(RectangularBounds.newInstance(
        new LatLng(-33.880490, 151.184363),
        new LatLng(-33.858754, 151.229596)));

      

    autocompleteFragment.setLocationRestriction(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

注: この制限はルート全体にのみ適用されます。境界の境界外にある合成結果は、場所の制限と重なるルートに基づいて返されることがあります。

場所のタイプまたはコレクションで結果をフィルタ

オートコンプリート リクエストの結果を制限することで、特定の場所タイプのみを返すことができます。場所のタイプ、または場所のタイプの表 1、2、3 のタイプ コレクションを使用して、フィルタを指定します。何も指定しないと、すべてのタイプが返されます。

オートコンプリートの結果をフィルタするには、setTypesFilter() を呼び出してフィルタを設定します。

タイプまたはタイプ コレクション フィルタを指定するには:

• setTypesFilter() を呼び出し、プレイスタイプに示されている表 1 と表 2 のタイプ値を最大 5 つ指定します。型の値は、PlaceTypes の定数によって定義されます。

• setTypesFilter() を呼び出して、プレイスタイプに示されている表 3 のタイプ コレクションを指定します。コレクションの値は、PlaceTypes の定数によって定義されます。

  リクエストでは、表 3 のタイプのうち、1 つのみが許可されます。表 3 の値を指定する場合、表 1 または表 2 の値は指定できません。変更すると、エラーが発生します。

次のコード例は、AutocompleteSupportFragment に対して setTypesFilter() を呼び出し、複数の型の値を指定しています。

    autocompleteFragment.setTypesFilter(Arrays.asList("landmark", "restaurant", "store"));

      

    autocompleteFragment.setTypesFilter(listOf("landmark", "restaurant", "store"))

      

次のコード例は、AutocompleteSupportFragment で setTypesFilter() を呼び出して、型コレクションを指定して正確な住所を持つ結果のみを返すフィルタを設定しています。

    autocompleteFragment.setTypesFilter(Arrays.asList(TypeFilter.ADDRESS.toString()));

      

    autocompleteFragment.setTypesFilter(listOf(TypeFilter.ADDRESS.toString()))

      

次のコード例は、IntentBuilder で setTypesFilter() を呼び出して、タイプ コレクションを指定して正確なアドレスの結果のみを返すフィルタを設定しています。

    Intent intent = new Autocomplete.IntentBuilder(
        AutocompleteActivityMode.FULLSCREEN, fields)
        .setTypesFilter(Arrays.asList(TypeFilter.ADDRESS.toString()))
        .build(this);
    startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE);

      

    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .setTypesFilter(listOf(TypeFilter.ADDRESS.toString()))
        .build(this)
    startActivityForResult(intent, AUTOCOMPLETE_REQUEST_CODE)

      

結果を国でフィルタする

オートコンプリートの結果を最大 5 か国に絞り込むには、setCountries() を呼び出して、国コードを設定します。次に、フィルタをフラグメントまたはインテントに渡します。国は、ISO 3166-1 Alpha-2 に準拠した 2 文字の国コードとして渡す必要があります。

次のコード例は、AutocompleteSupportFragment で setCountries() を呼び出して、指定された国の結果のみを返すフィルタを設定する方法を示しています。

    autocompleteFragment.setCountries("AU", "NZ");

      

    autocompleteFragment.setCountries("AU", "NZ")

      

使用量上限

Places SDK for Android を含め、Places API の使用量が 1 日あたりのリクエスト数（QPD）の上限に制限されることはなくなりました。ただし、以下の使用量上限は引き続き適用されます。

• レート制限は 1 秒あたり 100 リクエスト（QPS）です。これは、同じプロジェクトの認証情報を使用して、すべてのアプリケーションに対するクライアント側リクエストとサーバー側リクエストの合計として計算されます。

アプリに属性を表示する

• アプリでオートコンプリート サービスを使用する場合は、UI に「Powered by Google」アトリビューションを表示するか、Google ブランドの地図内に表示する必要があります。
• アプリでオートコンプリート ウィジェットを使用する場合、追加のアクションは必要ありません（必要なアトリビューションはデフォルトで表示されます）。
• ID で場所を取得した後に追加の場所情報を取得して表示する場合は、サードパーティのアトリビューションも表示する必要があります。

詳細については、アトリビューションに関するドキュメントをご覧ください。

Place Autocomplete の最適化

このセクションでは、Place Autocomplete サービスを最大限に活用するためのヒントを紹介します。

概要は次のとおりです。

• 機能的なユーザー インターフェースを最も手早く作成するには、Maps JavaScript API Autocomplete ウィジェット、Places SDK for Android Autocomplete ウィジェット、または Places SDK for iOS Autocomplete UI コントロールを使用します。
• Place Autocomplete のデータ フィールドの基本を理解します。
• 位置情報のバイアスと位置情報の制限のフィールドは省略可能ですが、オートコンプリートのパフォーマンスに大きく影響する場合があります。
• エラー処理を使用して、API がエラーを返した場合に、アプリでグレースフル デグラデーションが行われるようにします。
• アプリでは、選択肢がない場合でもユーザーが操作を続行できるようにします。

費用の最適化に関するヒント

基本的な費用の最適化

Place Autocomplete サービスの費用を最適化するには、Place Details と Place Autocomplete ウィジェットのフィールド マスクを使用して、必要な場所のデータ フィールドのみを返すよう設定します。

高度な費用の最適化

リクエストあたりの料金設定を利用し、Place Details の代わりに選択された場所に関する Geocoding API の結果をリクエストするためには、Place Autocomplete のプログラマティック実装を行うことをおすすめします。次の両方に該当する場合は、リクエストあたりの料金設定と Geocoding API を組み合わせた方が、セッションあたり（セッション ベース）の料金設定よりも費用対効果が高くなります。

• ユーザーが選択した場所の緯度 / 経度または住所のみが必要な場合。その場合は、Geocoding API の方が、Place Details の呼び出しよりも少ないコストでこの情報を提供できます。
• ユーザーが予測結果を選択するまでのオートコンプリート候補リクエストの回数が、平均 4 回以下の場合。その場合は、リクエストあたりの料金設定の方がセッションあたりの料金設定よりも費用対効果が高くなります。

アプリケーションで、選択された予測結果の住所と緯度 / 経度以外の情報が必要ですか？

パフォーマンスに関するベスト プラクティス

Place Autocomplete のパフォーマンスを最適化するためのガイドラインは次のとおりです。

• Place Autocomplete 実装に、国別のポリシー、場所のバイアス、言語設定（プログラマティック実装の場合）を追加します。ウィジェットはユーザーのブラウザやモバイル デバイスから言語設定を選択するため、ウィジェットでは言語設定は不要です。
• Place Autocomplete が地図に関連付けられている場合は、地図のビューポートを基準に場所にバイアスをかけることができます。
• ユーザーがいずれかのオートコンプリート候補を選択しなかった場合は（通常は目的の住所が候補に挙がらなかったことが原因）、ユーザーの元の入力内容を再利用して、より関連性の高い結果を取得できます。
  • ユーザーが住所情報のみを入力することが予想される場合は、Geocoding API の呼び出しで、ユーザーの元の入力内容を再利用します。
  • ユーザーが特定の場所に関する検索語句（名前や住所）を入力することが予想される場合は、Find Place リクエストを使用します。特定の地域の結果のみが求められる場合は、場所のバイアスを使用します。
  Geocoding API へのフォールバックが最適となるその他のシナリオは次のとおりです。
  • 建物の棟の住所の Place Autocomplete サポートが不完全な国（チェコ、エストニア、リトアニアなど）で、ユーザーが建物の棟の住所を入力する場合。たとえば、チェコ語の住所「Stroupežnického 3191/17, Praha」では、Place Autocomplete で部分的な予測が生成されます。
  • ユーザーがニューヨークの「23-30 29th St, Queens」や、ハワイのカウアイ島の「47-380 Kamehameha Hwy, Kaneohe」など、道路区間のプレフィックスを入力する場合。

トラブルシューティング

さまざまなエラーが発生する可能性がありますが、アプリでよくあるエラーの大半は、構成エラー（誤った API キーが使用された、API キーが正しく構成されていないなど）または割り当てエラー（アプリで割り当てを超過した）が原因で発生します。割り当ての詳細については、使用量上限をご覧ください。

オートコンプリート コントロールの使用中に発生したエラーは、onActivityResult() コールバックで返されます。Autocomplete.getStatus() を呼び出して、結果のステータス メッセージを取得します。