MapFragment

公用類別 MapFragment 擴充片段

應用程式中的地圖元件。在應用程式中放置地圖最簡單的方法。這是地圖檢視畫面的包裝函式,可自動處理必要的生命週期需求。這個元件是片段,只需透過下列 XML 即可新增至活動的版面配置檔案。

 <fragment
    class="com.google.android.libraries.maps.MapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
必須使用 getMapAsync(OnMapReadyCallback) 取得 GoogleMap。這個類別會自動初始化地圖系統和檢視畫面。

如果呼叫 MapFragment 的 onDestroyView() 方法,並設定 useViewLifecycleInFragment(boolean) 選項,則可移除檢視畫面。在這種情況下,MapFragment 就會失效,直到系統稍後呼叫 MapFragment 的 onCreateView(LayoutInflater, ViewGroup, Bundle) 方法時,再次重新建立檢視畫面為止。

GoogleMap 取得的所有物件都與檢視畫面相關聯。避免將物件 (例如 Marker) 保留在檢視畫面的生命週期內。否則會導致記憶體流失,因為檢視畫面無法釋放。

只有在指定 API 12 以上的版本時,才能使用這個類別。否則,請將 Android 支援資料庫新增至建構路徑,以便使用 SupportMapFragment。

開發人員指南

詳情請參閱「Google Maps SDK for Android 」開發人員指南。

繼承常數摘要

公用建構函式摘要

MapFragment()
建立地圖片段。

公用方法摘要

void
getMapAsync(OnMapReadyCallback 回呼)
設定回呼物件,在 GoogleMap 執行個體準備就緒時觸發。
靜態 MapFragment
newInstance(GoogleMapOptions 選項)
使用指定的選項建立地圖片段。
靜態 MapFragment
newInstance()
使用預設選項建立地圖片段。
void
onActivityCreated(Bundle savedInstanceState)
void
onAttach(活動活動)
void
onConfigurationChanged(配置設定)
void
onCreate(Bundle savedInstanceState)
查看
onCreateView(LayoutInflater inflater、ViewGroup 容器、Bundle savedInstanceState)
void
void
最後 void
onEnterAmbient(Bundle 環境詳細資料)
您必須從父項 WearableActivity 的相應方法呼叫此方法。
最後 void
onExitAmbient()
您必須從父項 WearableActivity 的相應方法呼叫此方法。
void
onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState)
在加載期間,將屬性從檢視區塊階層剖析為我們處理的引數。
void
void
void
void
onSaveInstanceState(Bundle outState)
提供 Bundle,以便在刪除 Fragment 之前儲存該片段的狀態。
void
void
onStop()
void
setArguments(Bundle 引數)

繼承方法摘要

公用建構函式

public MapFragment ()

建立地圖片段。此建構函式公開,僅供 inflater 使用。使用 newInstance() 透過程式輔助方式建立 MapFragment。

公用方法

public void getMapAsync (OnMapReadyCallback 回呼)

設定回呼物件,在 GoogleMap 執行個體準備就緒時觸發。

請注意:

  • 此方法必須從主執行緒呼叫。
  • 回呼將在主執行緒中執行。
  • 如果使用者的裝置未安裝 Google Play 服務,在使用者安裝之前,系統都不會觸發回呼。
  • 在極少數的情況下,如果 GoogleMap 會在建立後立即刪除,就不會觸發回呼。
  • 回呼提供的 GoogleMap 物件並非空值。

參數
回呼 地圖準備就緒時觸發的回呼物件。

公用靜態 MapFragment newInstance (GoogleMapOptions 選項)

使用指定的選項建立地圖片段。

參數
選項

公開 靜態 MapFragment newInstance ()

使用預設選項建立地圖片段。

public void onActivityCreated (Bundle savedInstanceState)

參數
savedInstanceState

public void onAttach (活動活動)

參數
活動

public void onConfigurationChanged (配置設定)

參數
config

public void onCreate (Bundle savedInstanceState)

參數
savedInstanceState

公開檢視 onCreateView (LayoutInflater inflater、ViewGroup 容器、Bundle savedInstanceState)

參數
發氣機
容器
savedInstanceState

public void onDestroy ()

public void onDestroyView ()

public final void onEnterAmbient (Bundle 環境 Details)

您必須從父項 WearableActivity 的相應方法呼叫此方法。

參數
ambientDetails

public final void onExitAmbient ()

您必須從父項 WearableActivity 的相應方法呼叫此方法。

public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)

在加載期間,將屬性從檢視區塊階層剖析為我們處理的引數。

參數
活動
attrs
savedInstanceState

public void onLowMemory ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

提供 Bundle,以便在刪除 Fragment 之前儲存該片段的狀態。之後再次呼叫 onCreate(Bundle) 即可擷取這個狀態。

參數
outState

public void onStart ()

public void onStop ()

public void setArguments (Bundle args)

參數
args