プレイスピッカーウィジェットとオートコンプリートコンポーネントは、Google Play開発者サービスの強力な機能です。 この記事では、アプリケーションでそれらを実装する方法と同様に、それらを詳細に検討します。


Play Services 7.0のリリースに伴い、Googleは非常に便利な機能をアプリケーションの実装に利用できるようにしました。そのうちの2つには、Place Picker UIとAutocompleteコンポーネントが含まれます。 どちらも、アプリケーションの既存のソリューションを大幅に改善するのに役立ちます。また、将来のアプリケーションに同様の機能を実装するのに役立ちます。 いずれにせよ、このような頻繁に使用される機能でネイティブでクリーンなソリューションを提供することは、アプリケーションが提供するエクスペリエンスの品質を向上させるのに大いに役立ちます。

これらの機能をリリースしてから実装する機会がなかったという事実を考慮して、私はそれらを詳しく調べる時が来たと判断しました。

この記事とともに、これらの機能を試すことができるアプリケーションを作成しました。 リンクの githubでコードを見つけることができます。

カスタマイズ

まだここで読んでいるので、これらのコンポーネントを直接試してみることをお勧めします。 したがって、Javaの帽子をかぶってコードを書く前に、build.gradleファイルにplay-services-location依存関係を追加することから始める必要があります。

compile 'com.google.android.gms:play-services-location:8.1.0'

注：使用する形式に詳しくない場合は、使用するplayサービスの依存関係を宣言するだけです。 詳細については、 このガイドを読むことをお勧めします。

これに加えて、位置情報サービスを使用するときにAPIキーを登録する必要もあります。これは次のガイドで行うことができます。 登録が完了したら、以下に示すように、マニフェストファイルにAPIキーとプレイサービスのバージョンを追加する必要があります。

 <meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR_API_KEY" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" /> 

場所の選択

場所選択ウィジェットは、デバイスの現在の地理的位置に基づいてインタラクティブマップと対話する機能を提供するユーザーインターフェイスコンポーネントです。 このマップを使用して、次の2つの方法のいずれかで近くの場所を選択できます。

• 現在の場所を選択する -ユーザーは、自動的に選択された場所が自分に合わない場合、画面に表示された地図を移動して場所を選択できます。
• 近くの場所の選択 -ユーザーは、現在の場所の近くの場所のリストから場所を選択できます。このリストは、マップの下部からドラッグして開くことができます。

明らかな質問は、「これを使用する理由は何ですか？」です。

• 開発時間は大幅に短縮されます -コンポーネントはすぐに使用できます。つまり、すべての機能（マップ、場所、ライフサイクル、ネットワーク要求など）はウィジェットによって完全に制御されます。 これを手動で行う方法に比べて、時間が大幅に短縮されます。
• 一貫した使用経験 -このコンポーネントをGoogleだけでなく、サードパーティの開発者（あなたのような）でも使用すると、このコンポーネントは使い慣れているため、ユーザーエクスペリエンスがはるかに簡単になります。

運用プロセス

だから、今、私たちは何を扱っているかを知っています。 Place Pickerライフサイクルには常に存在するいくつかの重要な操作があります。これについては、これから慣れ親しんでいきます。

• startActivityForResult（）メソッドを使用してプレースピッカーを開くと、アクティビティによって返された選択したプレースをキャッチします。
• 次のステップは、マップ上の初期位置を決定することです。 場所が事前に提供されている場合はそれを使用します。それ以外の場合は、デバイスの現在位置が選択されます。
• ユーザーが地図上の場所を選択するか、近くの場所のリストから選択するか、選択せずに場所の選択ツールを閉じるか。
• 選択が完了すると、場所の選択が完了し、結果（選択した場所）がアクティビティに返されます。

実装

最初に、Place PickerクラスのIntentBuilderを使用して、Builderの新しいインスタンスを作成する必要があります。

 PlacePicker.IntentBuilder builder = new PlacePicker.IntentBuilder(); 

このビルダーを使用して、プレイスピッカーのインスタンスで使用される緯度-ドゴタの初期境界を設定できます。 前述したように、初期値が設定されていない場合、デフォルトでプレースピッカーはLatLngBoundsとしてデバイスの現在の位置を使用します。

 builder.setLatLngBounds(new LatLngBounds(...)); 

これが完了したら、 startActivityForResult()メソッドを使用してピッカーを起動し、ビルダーにプレースピッカーのインスタンスとリクエストコードをパラメーターとして渡します。 前述したように、Place Pickerから選択したPlaceはonActivityResultアクティビティに戻り、 PLACE_PICKER_REQUESTリクエストコードを使用して結果をフィルタリングします。

 startActivityForResult(builder.build(this), PLACE_PICKER_REQUEST); 

startActivityForResultメソッドがstartActivityForResultと、プレースピッカーウィジェットが新しいアクティビティで開かれます。 ここで、ユーザーは現在の位置を使用して選択するか、推奨に基づいて場所を選択します。 プレイスピッカーが閉じられると、 onActivityResultが呼び出されます。

 protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == PLACE_PICKER_REQUEST) { if (resultCode == RESULT_OK) { Place selectedPlace = PlacePicker.getPlace(data, this); // Do something with the place } } } 

上に示したように、アクティビティから返されたときに選択したプレイスを取得します。 次のようにします。

 Place selectedPlace = PlacePicker.getPlace(data, this); 

この時点で、ユーザーが場所を選択せず​​に戻るボタンを使用してピッカーウィジェットを終了すると、結果は返されません。

注 ： Place Pickerウィジェットを使用するには、アプリケーションに次の権限を付与する必要があります-ACCESS_FINE_LOCATION 。

テーマ

アプリケーションで1つのデザインテーマを維持するために、デフォルトでは、Place Pickerウィジェットはアプリケーションの色を使用します。

• colorPrimary-アプリケーションのアクションバーのテキストと戻る矢印の色として使用されます
• colorPrimaryDark-アクションバーの背景色として使用されます

注意して、テーマの設定された色属性を再確認してください。

ビーコン信号

プレイサービス7.8のリリースにより、プレイスピッカーウィジェットは近くのビーコンからの信号を使用して、デバイスの現在の場所を特定することもできます。 これPlaceId検出されたビーコンの PlaceIdと、デバイスで使用可能な他の検出された信号（ネットワーク、wifiなど）のおかげで機能します。 収集されたジオデータに基づいて、プレイスピッカーコンポーネントで「Nearby Places」としてユーザーに表示するための推奨事項のリストが作成されます。

オートコンプリートを配置

プレイスオートコンプリート-検索クエリに基づいて近くにある推奨される場所のリストを返すために使用できる新しいコンポーネント。結果はデバイスの現在の場所からオフセットされます。 以前は、この結果を得るにはPlaces APIを直接呼び出す必要がありましたが、GoogleApiClientをラップすることで同じことが自動的に行えるようになりました。

まず、GoogleApiClientクラスの新しいインスタンスを作成する必要があります。 これを行うには、GoogleApiClientビルダーを使用します。ここでは、Places APIを使用することを示す必要もあります。

 mGoogleApiClient = new GoogleApiClient.Builder(this) .enableAutoManage(this, 0, this) .addApi(Places.GEO_DATA_API) .build(); 

検索クエリの結果として、現在の位置はこのインスタンスを使用してAuto Complete APIにリクエストを行います。

RxJavaは現在私のワークフローの一部であるため、Observableを使用してこれを実装することにしました。 完成したクラスを見て、コードを理解することをお勧めします。

• Places APIを使用して、提供された検索クエリと緯度経度境界に基づいて予測オートコンプリートリストを取得し始めています。

 PendingResult<AutocompletePredictionBuffer> results = Places.GeoDataApi.getAutocompletePredictions( mGoogleApiClient, query, bounds, null); 

注 ： LatLngBoundsインスタンスを提供しても、結果はこれらの境界に制限されません。 結果は指定された制限内で偏ります。つまり、近くの場所に高い優先度が与えられます。

PendingResultメソッドPendingResult 、APIにアクセスしてGoogle Play開発者サービスからデータを受信するために使用されます。 これを行うには、 await()メソッドを使用しawait() PendingResultデータを返す時間を与えます。

 AutocompletePredictionBuffer autocompletePredictions = results.await(60, TimeUnit.SECONDS); 

結果を待つとすぐに、DataBufferのステータスをチェックして、リクエストの成功を確認できます。

 final Status status = autocompletePredictions.getStatus(); if (!status.isSuccess()) { autocompletePredictions.release(); subscriber.onError(null); } else { for (AutocompletePrediction place : autocompletePredictions) { subscriber.onNext( new AutocompletePlace( place.getPlaceId(), place.getDescription() )); } autocompletePredictions.release(); subscriber.onCompleted(); } 

リクエストが正常に完了すると、理論的には最小のPlaceオブジェクトであるAutocompletePredictionオブジェクトのセットを返します。 これはユーザーに有用な情報を表示するには不十分なので、 placeIdを使用してAPIで完全なPlaceオブジェクトを取得します。 これは、リクエストを監視可能なストリームにリンクすることで行われ、次のように配置されます。

 final PendingResult<PlaceBuffer> placeResult = Places.GeoDataApi.getPlaceById(mGoogleApiClient, id); placeResult.setResultCallback(new ResultCallback<PlaceBuffer>() { @Override public void onResult(PlaceBuffer places) { if (!places.getStatus().isSuccess()) { places.release(); subscriber.onError(new Throwable(...)); } else { subscriber.onNext( PointOfInterest.fromPlace(places.get(0))); places.close(); subscriber.onCompleted(); } } }); 

注 ： PlaceBufferインスタンスのreleaseを呼び出すことを忘れないでください。

これらのプレイスの結果は、 アクティビティによって返され、recyclerview検索の結果として表示されます。 次に、 プレイスピッカーの例のように機能します。オートコンプリートの予測がリストから選択されると、 MainActivityに戻り、保存されたプレイスがリストに表示されます。

結論

この記事から、デモンストレーションされたサービスの実装と構成がどれほど簡単かを結論付けることができればと思います。また、アプリケーションでそれらを使用してください。

標準のMapViewは依然としてさまざまな状況で使用されますが（主に微調整と拡張機能のために、プレースピッカーは高度な機能が必要ない場合に役立ちます。同じことがオートコンプリートコンポーネントにも当てはまります）繰り返しますが、地理データに基づいて推奨事項を取得するためにAPI呼び出しを個別に実装できますが、 GoogleApiClientを使用すると、Play Servicesで提供されるコンポーネントでより多くの問題を解決できると考えて、これを行う方がはるかに簡単です ほとんどの日常的なタスク。