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) 中保留物件 (例如 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
onDestroy()
void
onDestroyView()
Final void
onEnterAmbient(套裝組合的環境詳細資料)
您必須從父項 WearableActivity' 對應的方法呼叫此方法。
Final void
onExitAmbient()
您必須從父項 WearableActivity' 對應的方法呼叫此方法。
void
onInflate(活動、AttributeSet attrs、套件 savedInstanceState)
在加載期間將屬性剖析為我們處理的引數。
void
onLOWMemory()
void
onPause()
void
onContinue()
void
onSaveInstanceState(套裝組合 OutState)
提供 Bundle，用於儲存片段在刪除之前的狀態。
void
onStart()
void
onStop()
void
setArguments (套件引數)

繼承方法摘要

公用建構函式

public MapFragment ()

建立地圖片段。此建構函式只供充氣器使用。使用 newInstance() 透過程式建立 MapFragment。

公用方法

public getMapAsync (OnMapReadyCallback 回呼)

設定回呼物件，該物件會在準備好 GoogleMap 執行個體時觸發。

請注意：

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

參數
callback 地圖可供使用時觸發的回呼物件。

公開 靜態 MapFragment newInstance (GoogleMapOptions 選項)

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

參數
選項

公開靜態 MapFragment newInstance ()

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

public onActivityCreated (Bundle savedInstanceState)

參數
savedInstanceState

public onAttach (活動活動)

參數
活動

public onConfigurationChanged (設定設定)

參數
config

public onCreate (Bundle savedInstanceState)

參數
savedInstanceState

public onCreateView (LayoutInflater inflater、ViewGroup 容器、Bundle savedInstanceState)

參數
啟動者
容器
savedInstanceState

public onDestroy ()

public onDestroyView ()

public final final void onEnterAmbient (Bundle ambientDetails)

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

參數
背景詳細資料

public final final void onExitAmbient ()

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

public onInflate (活動活動、AttributeSet Attrs、Bundle savedInstanceState)

在加載期間將屬性剖析為我們處理的引數。

參數
活動
attrs
savedInstanceState

public onLOWMemory ()

public onPause ()

public onContinue ()

public onSaveInstanceState (Bundle outState)

提供 Bundle，用於儲存片段在刪除之前的狀態。日後只要再次呼叫 onCreate(Bundle) 時，系統就能擷取這項資訊。

參數
輸出狀態

public onStart ()

public onStop ()

public setArguments (Bundle args)

參數
args