Map View

Journey SharingMapView

google.maps.journeySharing.JourneySharingMapView

地图视图。

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

JourneySharingMapView
JourneySharingMapView(options)
参数
将地图视图实例化。
anticipatedRoutePolylines
类型Array<Polyline>
用于返回预期的路线多段线(如果有)。
anticipatedRoutePolylineSetup
类型PolylineSetup
配置预期路线多段线的选项。每当呈现新的预期路线多段线时,都会调用该方法。

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

指定 DirectionsSetupOptions 对象与指定会返回该静态对象的函数作用相同。

请勿在不同的 polylineSetup 函数或静态值中重复使用相同的 polylineSetupOptions 对象,也不应在不同的 LineSetupOptions 对象中针对 polylineOptions 键重复使用相同的 google.maps.polylineOptions 对象。如果未设置 polylineOptions 或 visible 或者设置 null,则会使用默认值覆盖它。系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。
automaticViewportMode
此字段为只读字段。自动视口模式。
element
类型Element
此字段为只读字段。支持视图的 DOM 元素。
enableTraffic
类型boolean
启用或停用路况图层。
locationProvider
此字段为只读字段。要在跟踪地图视图中显示所跟踪地点的来源。
map
类型Map
此字段为只读字段。地图视图中包含的地图对象。
mapOptions
类型MapOptions
此字段为只读字段。通过地图视图传入地图的地图选项。
takenRoutePolylines
类型Array<Polyline>
用于返回拍摄的路线多段线(如果有)。
takenRoutePolylineSetup
类型PolylineSetup
配置已拍摄路线多段线的选项。每当呈现新拍摄的路线多段线时,都会调用该方法。

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

指定 DirectionsSetupOptions 对象与指定会返回该静态对象的函数作用相同。

请勿在不同的 polylineSetup 函数或静态值中重复使用相同的 polylineSetupOptions 对象,也不应在不同的 LineSetupOptions 对象中针对 polylineOptions 键重复使用相同的 google.maps.polylineOptions 对象。

系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。任何未设置或 null 的值都将被替换为默认值。
destinationMarkerSetup
类型MarkerSetup
配置目标位置标记。每当呈现新的目标标记时调用。

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中针对 markerOptions 键重复使用相同的 google.maps.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>
返回航点标记(如果有)。

Journey SharingMapViewOptions 接口

google.maps.journeySharing.JourneySharingMapViewOptions接口

地图视图的选项。

element
类型Element
支持视图的 DOM 元素。必需。
locationProvider
要在跟踪地图视图中显示所跟踪地点的来源。必需。
anticipatedRoutePolylineSetup optional
类型PolylineSetup optional
配置预期路线多段线的选项。每当呈现新的预期路线多段线时,都会调用该方法。

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

指定 DirectionsSetupOptions 对象与指定会返回该静态对象的函数作用相同。

请勿在不同的 polylineSetup 函数或静态值中重复使用相同的 polylineSetupOptions 对象,也不应在不同的 LineSetupOptions 对象中针对 polylineOptions 键重复使用相同的 google.maps.polylineOptions 对象。如果未设置 polylineOptions 或 visible 或者设置 null,则会使用默认值覆盖它。系统会忽略为 polylineOptions.map 或 polylineOptions.path 设置的任何值。
automaticViewportMode optional
类型AutomaticViewportMode optional
自动视口模式。默认值为 FIT_ANTICIPATED_ROUTE,这可让地图视图自动调整视口,以适应车辆标记、位置标记和任何可见的预期路线多段线。设置为“无”可关闭自动调整功能。
destinationMarkerSetup optional
类型MarkerSetup optional
配置目标位置标记。每当呈现新的目标标记时调用。

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中针对 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果标记选项未设置或为 null,则会使用默认值覆盖它。为 markerOptions.map 或 markerOptions.position 设置的任何值都将被忽略。
mapOptions optional
类型MapOptions optional
传递到 google.maps.Map 构造函数的地图选项。
originMarkerSetup optional
类型MarkerSetup optional
配置出发地位置标记的选项。每当呈现新的出发地标记时调用。

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中针对 markerOptions 键重复使用相同的 google.maps.MarkerOptions 对象。如果标记选项未设置或为 null,则会使用默认值覆盖它。为 markerOptions.map 或 markerOptions.position 设置的任何值都将被忽略。
takenRoutePolylineSetup optional
类型PolylineSetup optional
配置已拍摄路线多段线的选项。每当呈现新拍摄的路线多段线时,都会调用该方法。

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

指定 DirectionsSetupOptions 对象与指定会返回该静态对象的函数作用相同。

请勿在不同的 polylineSetup 函数或静态值中重复使用相同的 polylineSetupOptions 对象,也不应在不同的 LineSetupOptions 对象中针对 polylineOptions 键重复使用相同的 google.maps.polylineOptions 对象。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

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

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

指定 MarkerSetupOptions 对象与指定会返回相应静态对象的函数作用相同。

请勿在不同的 MarkerSetup 函数或静态值中重复使用相同的 MarkerSetupOptions 对象,也不要在不同的 MarkerSetupOptions 对象中针对 markerOptions 键重复使用相同的 google.maps.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、无限或负值,系统会停用位置信息自动更新。如果跟踪 ID 参数(例如,货运地点提供商的物流跟踪 ID)或过滤选项(例如,车队位置提供商的视口边界或属性过滤器)发生更改,系统将获取一次新的位置更新。

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

PollingLocationProviderIsPollingChangeEvent 接口

google.maps.journeySharing.PollingLocationProviderIsPollingChangeEvent接口

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

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