地図を使用する準備ができたときのコールバック インターフェース。
このインターフェースのインスタンスが MapFragment
または MapView
オブジェクトに設定されると、地図を使用する準備が整うと onMapReady(GoogleMap)
メソッドがトリガーされ、GoogleMap
の null ではないインスタンスが提供されます。
Google Play 開発者サービスがデバイスにインストールされていない場合は、インストールするように求められます。onMapReady(GoogleMap)
メソッドは、ユーザーがアプリをインストールしてアプリに戻ったときにのみトリガーされます。
パブリック メソッドの概要
抽象 void |
パブリック メソッド
public Abstract void onMapReady (GoogleMap googleMap)
地図を使用する準備ができたときに呼び出されます。
ただし、地図がレイアウトされるとは限りません。そのため、コールバック メソッドが呼び出されるまでに、地図のサイズがまだ特定されていない可能性があります。ディメンションを知りたい場合や、ディメンションを把握する必要がある API でメソッドを呼び出す必要がある場合は、地図の View
を取得して、ViewTreeObserver.OnGlobalLayoutListener
も登録してください。
コールバックは任意の順序で実行できるため、OnMapReadyCallback
リスナーと OnGlobalLayoutListener
リスナーの連鎖を行わずに、両方のコールバックを個別に登録して待機します。
たとえば、ディメンションを指定せずに LatLngBounds
を使用して地図のカメラを更新する場合は、OnMapReadyCallback
と OnGlobalLayoutListener
の両方が完了するまで待ちます。そうしないと、IllegalStateException
をトリガーする競合状態が発生します。
パラメータ
googleMap | コールバックを定義する MapFragment または MapView に関連付けられた GoogleMap の null ではないインスタンス。 |
---|