導航地圖

公用介面 NavigationMap

提供修改導覽地圖內容的方法，例如新增及移除標記。

所有方法都只能在 Android UI 執行緒上存取。

巢狀類別摘要

NavigationMap.OnMapClickListener 使用者輕觸地圖時的回呼介面。
NavigationMap.OnMarkerClickListener 定義點選或輕觸標記時呼叫的方法簽章。

公用方法摘要

Marker
addMarker(MarkerOptionsMarkerOptions)
在地圖中加入單一標記。
投影
getProjection()
傳回 Projection 物件，可用於在螢幕座標和經緯度座標之間進行轉換。
抽象 void
removeAllMarkers()
移除目前地圖上的所有標記。
抽象 void
removeMarker(Marker 標記)
從地圖中移除指定的標記。
抽象 void
setOnMapClickListener(NavigationMap.OnMapClickListener事件監聽器)
設定使用者輕觸地圖時叫用的回呼。
抽象 void
setOnMarkerClickListener(NavigationMap.OnMarkerClickListener事件監聽器)
設定按一下標記時叫用的回呼。
抽象 void
setPadding(int left, int top, int right, int bottom)
設定地圖區域內 UI 元素的邊框間距 (以像素為單位)。
抽象 void
setTrafficEnabled(已啟用布林值)
設定是否顯示路況資訊。

公用方法

public 抽象 Marker addMarker (MarkerOptions tagOptions)

在地圖中加入單一標記。

參數
markerOptions 可定義標記屬性 (例如位置) 的 MarkerOptions。選項將複製到標記中，您可以放心重複使用。
傳回
  • 代表標記的物件

公開 抽象 投影 getProjection ()

傳回 Projection 物件，可用於在螢幕座標和經緯度座標之間進行轉換。

傳回的 Projection 是目前投影的快照，不會在攝影機移動時自動更新。由於這項作業的費用較高，因此每個畫面只應取得一次投影。Google 地圖採用麥卡托投影，先根據地理資料建立地圖，再將地圖上的點轉換為地理座標。

傳回
  • 地圖目前狀態的 Projection；如果地圖尚未完全初始化，則為 null。

public 抽象 void removeAllMarkers ()

移除目前地圖上的所有標記。

public 抽象 void removeMarker (Marker 標記)

從地圖中移除指定的標記。

參數
馬克筆 要移除的標記

public 抽象 void setOnMapClickListener (NavigationMap.OnMapClickListener事件監聽器)

設定使用者輕觸地圖時叫用的回呼。

參數
事件監聽器 使用者輕觸地圖時叫用的回呼。如要取消設定回呼，請使用 null。

public 抽象 void setOnMarkerClickListener (NavigationMap.OnMarkerClickListener事件監聽器)

設定按一下標記時叫用的回呼。

參數
事件監聽器 點選標記時叫用的回呼。如要取消設定回呼，請使用 null。

public 抽象 void setPadding (int left, int top, intright, intbottom)

設定地圖區域內 UI 元素的邊框間距 (以像素為單位)。這也會影響重新置中的行為，導致地圖在設有邊框間距的區域內重新置中。

注意：只有在標頭停用時，才適用頂端邊框間距值 (請參閱 setHeaderEnabled(boolean))，而且只有在 ETA 資訊卡停用時才會套用底部邊框間距值 (請參閱 setEtaCardEnabled(boolean))。左側和右側邊框間距值會一律套用。

參數
左
上
右
下

public 抽象 void setTrafficEnabled (boolean enabled)

設定是否顯示路況資訊。

參數
已啟用 如果為 true，就會顯示車流量資訊。