Map View

JourneySharingMapView

google.maps.journeySharing.JourneySharingMapView

地图视图。

通过调用 const {JourneySharingMapView} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库

JourneySharingMapView
JourneySharingMapView(options)
参数: 
实例化地图视图。
automaticViewportMode
此字段为只读字段。自动视口模式。
element
类型:  Element
此字段为只读字段。为视图提供后备的 DOM 元素。
enableTraffic
类型:  boolean
启用或停用交通层。
locationProviders
类型:  Array<LocationProvider> optional
此字段为只读字段。要显示在跟踪地图视图中的已跟踪位置的来源。如需添加或移除位置信息提供程序,请使用 JourneySharingMapView.addLocationProviderJourneySharingMapView.removeLocationProvider 方法。
map
类型:  Map
此字段为只读字段。地图视图中包含的地图对象。
mapOptions
类型:  MapOptions
此字段为只读字段。通过地图视图传递给地图的地图选项。
locationProvider
类型:  LocationProvider optional
此字段为只读字段。要显示在跟踪地图视图中的跟踪位置的来源。
destinationMarkerSetup
类型:  MarkerSetup
配置目的地位置标记的选项。每当渲染新的目的地标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
originMarkerSetup
类型:  MarkerSetup
配置起始位置标记的选项。每当渲染新的起点标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
taskOutcomeMarkerSetup
类型:  MarkerSetup
为任务结果位置标记配置选项。每当渲染新的任务结果位置标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
unsuccessfulTaskMarkerSetup
类型:  MarkerSetup
为未成功的任务位置标记配置选项。每当渲染新的未完成任务标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
vehicleMarkerSetup
类型:  MarkerSetup
配置车辆位置标记的选项。每当渲染新的车辆标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
waypointMarkerSetup
类型:  MarkerSetup
配置航点位置标记的选项。每当渲染新的航点标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
anticipatedRoutePolylineSetup
类型:  PolylineSetup
配置预计路线多段线的选项。每当渲染新的预计路线多段线时,都会调用此方法。

如果指定函数,该函数可以且应修改包含 google.maps.PolylineOptions 对象的输入的 defaultPolylineOptions 字段,并在输出 PolylineSetupOptions 对象中将其作为 polylineOptions 返回。

指定 PolylineSetupOptions 对象的效果与指定用于返回该静态对象的函数相同。

请勿在不同的 PolylineSetup 函数或静态值中重复使用相同的 PolylineSetupOptions 对象,也不要在不同的 PolylineSetupOptions 对象中为 polylineOptions 键重复使用相同的 google.maps.PolylineOptions 对象。如果 polylineOptions 或 visible 未设置或为 null,则会被默认值覆盖。系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。
takenRoutePolylineSetup
类型:  PolylineSetup
配置所行路线多段线的选项。每当渲染新的已行驶路线多段线时,都会调用此方法。

如果指定函数,该函数可以且应修改包含 google.maps.PolylineOptions 对象的输入的 defaultPolylineOptions 字段,并在输出 PolylineSetupOptions 对象中将其作为 polylineOptions 返回。

指定 PolylineSetupOptions 对象的效果与指定用于返回该静态对象的函数相同。

请勿在不同的 PolylineSetup 函数或静态值中重复使用相同的 PolylineSetupOptions 对象,也不要在不同的 PolylineSetupOptions 对象中为 polylineOptions 键重复使用相同的 google.maps.PolylineOptions 对象。

系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。任何未设置或 null 值都将被默认值覆盖。
pingMarkerSetup
类型:  MarkerSetup
配置 ping 位置标记的选项。每当渲染新的 ping 标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
successfulTaskMarkerSetup
类型:  MarkerSetup
为成功的任务位置标记配置选项。每当渲染新的成功任务标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
destinationMarkers
类型:  Array<Marker>
返回目的地标记(如果有)。
originMarkers
类型:  Array<Marker>
返回起点标记(如果有)。
successfulTaskMarkers
类型:  Array<Marker>
返回成功的任务标记(如果有)。
taskOutcomeMarkers
类型:  Array<Marker>
返回任务结果标记(如果有)。
unsuccessfulTaskMarkers
类型:  Array<Marker>
返回失败的任务标记(如果有)。
vehicleMarkers
类型:  Array<Marker>
返回车辆标记(如果有)。
waypointMarkers
类型:  Array<Marker>
返回航点标记(如果有)。
anticipatedRoutePolylines
类型:  Array<Polyline>
返回预计路线多段线(如果有)。
takenRoutePolylines
类型:  Array<Polyline>
返回所经路线的多段线(如果有)。
addLocationProvider
addLocationProvider(locationProvider)
参数: 
返回值:None
向地图视图添加位置信息提供程序。如果位置信息提供程序已添加,则不会执行任何操作。
removeLocationProvider
removeLocationProvider(locationProvider)
参数: 
返回值:None
从地图视图中移除位置信息提供程序。如果位置信息提供程序尚未添加到地图视图中,则不会执行任何操作。

JourneySharingMapViewOptions 接口

google.maps.journeySharing.JourneySharingMapViewOptions 接口

地图视图的选项。

element
类型:  Element
为视图提供后备的 DOM 元素。必填。
anticipatedRoutePolylineSetup optional
类型:  PolylineSetup optional
配置预计路线多段线的选项。每当渲染新的预计路线多段线时,都会调用此方法。

如果指定函数,该函数可以且应修改包含 google.maps.PolylineOptions 对象的输入的 defaultPolylineOptions 字段,并在输出 PolylineSetupOptions 对象中将其作为 polylineOptions 返回。

指定 PolylineSetupOptions 对象的效果与指定用于返回该静态对象的函数相同。

请勿在不同的 PolylineSetup 函数或静态值中重复使用相同的 PolylineSetupOptions 对象,也不要在不同的 PolylineSetupOptions 对象中为 polylineOptions 键重复使用相同的 google.maps.PolylineOptions 对象。如果 polylineOptions 或 visible 未设置或为 null,则会被默认值覆盖。系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。
automaticViewportMode optional
类型:  AutomaticViewportMode optional
自动视口模式。默认值为 FIT_ANTICIPATED_ROUTE,可让地图视图自动调整视口以适应车辆标记、位置标记和任何可见的预计路线多段线。将此值设置为“NONE”可关闭自动调整。
destinationMarkerSetup optional
类型:  MarkerSetup optional
配置目的地位置标记的选项。每当渲染新的目的地标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
locationProvider optional
类型:  LocationProvider optional
要显示在跟踪地图视图中的跟踪位置的来源。可选。
locationProviders optional
类型:  Array<LocationProvider> optional
要显示在跟踪地图视图中的已跟踪位置的来源。可选。
mapOptions optional
类型:  MapOptions optional
传递给 google.maps.Map 构造函数的地图选项。
originMarkerSetup optional
类型:  MarkerSetup optional
配置起始位置标记的选项。每当渲染新的起点标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
pingMarkerSetup optional
类型:  MarkerSetup optional
配置 ping 位置标记的选项。每当渲染新的 ping 标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
successfulTaskMarkerSetup optional
类型:  MarkerSetup optional
为成功的任务位置标记配置选项。每当渲染新的成功任务标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
takenRoutePolylineSetup optional
类型:  PolylineSetup optional
配置所行路线多段线的选项。每当渲染新的已行驶路线多段线时,都会调用此方法。

如果指定函数,该函数可以且应修改包含 google.maps.PolylineOptions 对象的输入的 defaultPolylineOptions 字段,并在输出 PolylineSetupOptions 对象中将其作为 polylineOptions 返回。

指定 PolylineSetupOptions 对象的效果与指定用于返回该静态对象的函数相同。

请勿在不同的 PolylineSetup 函数或静态值中重复使用相同的 PolylineSetupOptions 对象,也不要在不同的 PolylineSetupOptions 对象中为 polylineOptions 键重复使用相同的 google.maps.PolylineOptions 对象。

系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。任何未设置或 null 值都将被默认值覆盖。
taskOutcomeMarkerSetup optional
类型:  MarkerSetup optional
为任务结果位置标记配置选项。每当渲染新的任务结果位置标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
unsuccessfulTaskMarkerSetup optional
类型:  MarkerSetup optional
为未成功的任务位置标记配置选项。每当渲染新的未完成任务标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
vehicleMarkerSetup optional
类型:  MarkerSetup optional
配置车辆位置标记的选项。每当渲染新的车辆标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。
waypointMarkerSetup optional
类型:  MarkerSetup optional
配置航点位置标记的选项。每当渲染新的航点标记时都会调用。

如果指定函数,该函数可以且应修改包含 google.maps.MarkerOptions 对象的输入的 defaultMarkerOptions 字段,并在输出 MarkerSetupOptions 对象中将其作为 markerOptions 返回。

指定 MarkerSetupOptions 对象的效果与指定返回该静态对象的函数相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中为 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果 markerOptions 未设置或为 null,则会被默认值覆盖。系统会忽略为 markerOptions.map 或 markerOptions.position 设置的任何值。

AutomaticViewportMode 常量

google.maps.journeySharing.AutomaticViewportMode 常量

自动视口模式。

通过调用 const {AutomaticViewportMode} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库

FIT_ANTICIPATED_ROUTE 自动调整视口以适应标记和任何可见的预计路线多段线。这是默认值。
NONE 请勿自动调整视口。

LocationProvider 抽象类

google.maps.journeySharing.LocationProvider 抽象类

所有位置信息提供程序的父类。

addListener
addListener(eventName, handler)
参数: 
  • eventNamestring要监听的事件的名称。
  • handlerFunction事件处理脚本。
返回值:  MapsEventListener
为此位置信息提供方触发的事件添加 MapsEventListener。返回此监听器的标识符,该标识符可与 event.removeListener 搭配使用。

PollingLocationProvider 抽象类

google.maps.journeySharing.PollingLocationProvider 抽象类

投票地点提供程序的父类。

此抽象类扩展了 LocationProvider

isPolling
类型:  boolean
如果此位置信息提供程序正在轮询,则为 True。只读。
pollingIntervalMillis
类型:  number
提取位置信息更新之间的最短时间(以毫秒为单位)。如果提取位置信息更新所需的时间超过 pollingIntervalMillis,则系统会等到当前位置信息更新完成后再开始下一个位置信息更新。

将此值设为 0、Infinity 或负值会停用自动位置信息更新。如果跟踪 ID 参数(例如运输位置信息提供程序的运输跟踪 ID)或过滤选项(例如车队位置信息提供程序的视口边界或属性过滤条件)发生变化,系统会提取一次新的位置信息更新。

默认的轮询间隔(也是最短间隔)为 5000 毫秒。如果您将轮询间隔设置为较低的正值,系统会存储并使用 5000。
继承addListener
ispollingchange
function(event)
当位置信息提供程序的轮询状态更新时触发的事件。使用 PollingLocationProvider.isPolling 确定当前轮询状态。

PollingLocationProviderIsPollingChangeEvent 接口

google.maps.journeySharing.PollingLocationProviderIsPollingChangeEvent 接口

在触发 PollingLocationProvider.ispollingchange 事件时传递给事件处理脚本的事件对象。

error optional
类型:  Error optional
导致轮询状态发生变化的错误(如果状态变化是由错误引起的)。如果状态更改是由于正常操作造成的,则为未定义。