OnMapReadyCallback

公開インターフェース OnMapReadyCallback

地図を使用する準備ができたときのコールバック インターフェース。

このインターフェースのインスタンスが MapFragment または MapView オブジェクトに設定されると、地図が使用可能になると onMapReady(GoogleMap) メソッドがトリガーされ、GoogleMap の null ではないインスタンスが提供されます。

Google Play 開発者サービスがデバイスにインストールされていない場合、インストールを求めるメッセージがユーザーに表示され、ユーザーがインストールしてアプリに戻った場合にのみ、onMapReady(GoogleMap) メソッドがトリガーされます。

パブリック メソッドの概要

抽象 void

onMapReady（GoogleMap googleMap） 地図を使用する準備が整うと呼び出されます。

パブリック メソッド

public summary void onMapReady （GoogleMap googleMap）

地図を使用する準備が整うと呼び出されます。

ただし、これによって地図にレイアウトが適用されるとは限りません。そのため、コールバック メソッドが呼び出された時点までに地図のサイズが確定していないことがあります。寸法を把握する必要がある場合、または寸法を把握する必要がある API のメソッドを呼び出す場合は、地図の View を取得し、ViewTreeObserver.OnGlobalLayoutListener も登録します。

コールバックは任意の順序で起動できるため、OnMapReadyCallback リスナーと OnGlobalLayoutListener リスナーを連結するのではなく、両方のコールバックを別々に登録して待機してください。

たとえば、寸法を指定せずに LatLngBounds を使用して地図のカメラを更新する場合は、OnMapReadyCallback と OnGlobalLayoutListener の両方が完了するまで待つ必要があります。それ以外の場合は、IllegalStateException をトリガーする競合状態が発生します。

パラメータ

googleMap	コールバックを定義する MapFragment または MapView に関連付けられた GoogleMap の null 以外のインスタンス。