公共接口 OnMapReadyCallback
在地图做好使用准备时的回调接口。
在 MapFragment
或 MapView
对象上设置此接口的实例后,系统会在地图做好使用准备时触发 onMapReady(GoogleMap)
方法,该方法会提供 GoogleMap
的非 null 实例。
如果设备上未安装 Google Play 服务,系统会提示用户进行安装,并且只有在用户安装并返回到应用才会触发 onMapReady(GoogleMap)
方法。
公共方法摘要
abstract void |
公共方法
public abstract void onMapReady (GoogleMap googleMap)
在地图做好使用准备时调用。
请注意,这并不保证地图已完成布局。因此,调用回调方法时可能尚未确定地图的大小。如果您需要知道尺寸,或者在 API 中调用需要知道尺寸的方法,请获取地图的 View
并注册 ViewTreeObserver.OnGlobalLayoutListener
。
不要将 OnMapReadyCallback
和 OnGlobalLayoutListener
监听器链接起来,而应独立注册并等待这两个回调,因为回调可以按任何顺序触发。
例如,如果您想使用不带维度的 LatLngBounds
更新地图的相机,则应等到 OnMapReadyCallback
和 OnGlobalLayoutListener
均完成操作。否则,存在可能触发 IllegalStateException
的竞态条件。
参数
googleMap | 与定义回调的 MapFragment 或 MapView 相关联的 GoogleMap 的非 null 实例。 |
---|