公用介面
OnMapReadyCallback
地圖已可供使用時的回呼介面。
在 MapFragment
或 MapView
物件上設定這個介面的執行個體後,系統會在地圖已可供使用時觸發 onMapReady(GoogleMap)
方法,並提供 GoogleMap
的非空值例項。
如果使用者的裝置並未安裝 Google Play 服務,系統就會提示使用者安裝;假如使用者已安裝該應用程式並返回應用程式,則系統只會觸發 onMapReady(GoogleMap)
方法。
公用方法摘要
抽象 void |
公用方法
公共抽象 void onMapReady (GoogleMap googleMap)
地圖準備就緒時呼叫時。
請注意,這並不保證地圖已有版面配置。因此,在呼叫回呼方法時,可能尚未決定地圖的大小。如果您需要知道維度,或在 API 中呼叫需要知道維度的方法,請取得地圖的 View
並註冊 ViewTreeObserver.OnGlobalLayoutListener
。
請勿鏈結 OnMapReadyCallback
和 OnGlobalLayoutListener
事件監聽器,而是改為註冊並等待兩個回呼,因為回呼能以任何順序觸發。
舉例來說,如果您想使用不含維度的 LatLngBounds
更新地圖相機,請等到 OnMapReadyCallback
和 OnGlobalLayoutListener
都完成後。否則,可能會有可觸發 IllegalStateException
的競爭狀況。
參數
googleMap | 與定義回呼的 MapFragment 或 MapView 相關聯的 GoogleMap 非空值例項。 |
---|