导航地图

公共接口 NavigationMap

提供修改导航地图内容(例如添加和移除标记)的方法。

所有方法都应仅在 Android 界面线程上访问。

嵌套类摘要

接口 NavigationMap.OnMapClickListener 在用户点按地图时使用的回调接口。
接口 NavigationMap.OnMarkerClickListener 定义点击或点按标记时调用的方法的签名。

公共方法摘要

abstract 标记
addMarker(MarkerOptions markerOptions)
用于向地图添加一个标记。
abstract 投影
getProjection()
返回一个 Projection 对象,您可以使用该对象在屏幕坐标与纬度/经度坐标之间进行转换。
abstract void void
removeAllMarkers()
用于删除地图上当前的所有标记。
abstract void void
removeMarkerMarker 标记)
从地图中删除指定标记。
abstract void void
setOnMapClickListener(NavigationMap.OnMapClickListener 监听器)
用于设置在用户点按地图时调用的回调。
abstract void void
setOnMarkerClickListener(NavigationMap.OnMarkerClickListener 监听器)
用于设置在用户点击标记时调用的回调。
abstract void void
setPadding(int left, int top, int right, int bottom)
设置地图区域内界面元素的内边距(以像素为单位)。
abstract void void
setTrafficEnabled(已启用布尔值)
设置是否显示路况信息。

公共方法

public abstract Marker addMarker (MarkerOptions markerOptions)

用于向地图添加一个标记。

参数
markerOptions MarkerOptions,用于定义标记属性(例如位置)。这些选项将被复制到标记中,并且可以安全地重复使用。
返回
  • 一个表示标记的对象

public abstract 投影 getProjection ()

返回一个 Projection 对象,您可以使用该对象在屏幕坐标与纬度/经度坐标之间进行转换。

返回的 Projection 是当前投影的快照,不会在相机移动时自动更新。由于此操作成本高昂,因此您应该在每个屏幕仅获取一次投影。Google 地图使用墨卡托投影法来根据地理数据创建地图,并将地图上的点转换为地理坐标。

返回
  • 地图的 Projection 处于当前状态,如果地图尚未完全初始化,则为 null

public abstract void removeAllMarkers ()

用于删除地图上当前的所有标记。

public abstract void removeMarker Marker 标记)

从地图中删除指定标记。

参数
标记 要移除的标记

public abstract void setOnMapClickListener (NavigationMap.OnMapClickListener 监听器)

用于设置在用户点按地图时调用的回调。

参数
监听器 点按地图时调用的回调。如需取消设置回调,请使用 null

public abstract void setOnMarkerClickListener (NavigationMap.OnMarkerClickListener 监听器)

用于设置在用户点击标记时调用的回调。

参数
监听器 点击标记时调用的回调。如需取消设置回调,请使用 null

public abstract void setPadding (int left, int top, int right, int bottom)

设置地图区域内界面元素的内边距(以像素为单位)。这还会影响中心位置行为,导致地图在含内边距的区域内重新设置中心位置。

注意:上内边距值仅在标题处于停用状态时适用(请参阅 setHeaderEnabled(boolean)),下内边距仅在 ETA 卡片停用时适用(请参阅 setEtaCardEnabled(boolean))。左侧和右侧内边距值始终适用。

参数

public abstract void setTrafficEnabled (boolean enabled)

设置是否显示路况信息。

参数
已启用 如果为 true,系统将会显示路况信息。