Directions

DirectionsService

google.maps.DirectionsService

用于计算两个或多个位置之间路线的服务。

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

DirectionsService
DirectionsService()
参数:无
创建 DirectionsService 的新实例,该实例可向 Google 服务器发送路线查询。
route
route(request[, callback])
参数: 
返回值:  Promise<DirectionsResult>
发出路线搜索请求。

DirectionsRequest 接口

google.maps.DirectionsRequest 接口

要发送到 DirectionsService 的路线查询。

destination
类型:  string|LatLng|Place|LatLngLiteral
目标位置。此参数可以指定为要进行地理编码的字符串、LatLngPlace。必填。
origin
类型:  string|LatLng|Place|LatLngLiteral
原点的位置。此参数可以指定为要进行地理编码的字符串、LatLngPlace。必填。
travelMode
类型:  TravelMode
请求的路线类型。必填。
avoidFerries optional
类型:  boolean optional
如果值为 true,则指示路线服务尽可能避开轮渡。可选。
avoidHighways optional
类型:  boolean optional
如果值为 true,则指示路线服务尽可能避开公路。可选。
avoidTolls optional
类型:  boolean optional
如果值为 true,则指示 Directions 服务尽可能避开收费路段。可选。
drivingOptions optional
类型:  DrivingOptions optional
仅适用于 travelModeDRIVING 的请求的设置。此对象对其他出行方式没有影响。
language optional
类型:  string optional
一种语言标识符,用于指定应尽可能以哪种语言返回结果。请参阅支持的语言列表
optimizeWaypoints optional
类型:  boolean optional
如果设置为 trueDirectionsService 将尝试重新排序提供的中间途经点,以最大限度地降低路线的总费用。如果航点经过优化,请检查响应中的 DirectionsRoute.waypoint_order 以确定新的顺序。
provideRouteAlternatives optional
类型:  boolean optional
是否应提供备选路线。可选。
region optional
类型:  string optional
用作地址解析请求偏向的区域代码。地区代码接受 ccTLD(“顶级域名”)双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同,但也有一些需要注意的例外情况。例如,英国的 ccTLD 为“uk”(.co.uk),而其 ISO 3166-1 代码为“gb”(从技术上讲,是指“大不列颠及北爱尔兰联合王国”这一实体)。
transitOptions optional
类型:  TransitOptions optional
仅适用于 travelMode 为 TRANSIT 的请求的设置。此对象对其他出行方式没有影响。
unitSystem optional
类型:  UnitSystem optional
默认值:出发地所在国家/地区的单位制。
显示距离时要使用的首选单位制。
waypoints optional
类型:  Array<DirectionsWaypoint> optional
中间路标的数组。系统会计算从出发地到目的地(途经此数组中的每个途径点)的路线。如需了解允许的航点数量上限,请参阅 开发者指南。公交路线不支持途经点。可选。

DirectionsStatus 常量

google.maps.DirectionsStatus 常量

在完成对 route() 的调用后,DirectionsService 返回的状态。您可以通过值或使用常量的名称来指定这些参数。例如 'OK'google.maps.DirectionsStatus.OK

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

INVALID_REQUEST 提供的 DirectionsRequest 无效。
MAX_WAYPOINTS_EXCEEDED DirectionsRequest 中提供的 DirectionsWaypoint 过多。如需了解允许的航点数量上限,请参阅 开发者指南
NOT_FOUND 至少无法对原点、目标或路标之一进行地址解析。
OK 响应包含有效的 DirectionsResult
OVER_QUERY_LIMIT 网页发出请求的频率过高,超过了最短时间限制。
REQUEST_DENIED 不允许网页使用路线服务。
UNKNOWN_ERROR 由于服务器错误而无法处理路线请求。如果您再试一次,该请求可能会成功。
ZERO_RESULTS 在起点和终点之间找不到任何路线。

DirectionsResult 接口

google.maps.DirectionsResult 接口

从路线服务器检索获得的路线响应。您可以使用 DirectionsRenderer 呈现这些对象,也可以自行解析并呈现此对象。您必须按照 Google Maps Platform 服务条款中的规定显示警告和版权声明。请注意,虽然此结果类似于 JSON,但它并非严格意义上的 JSON,因为它间接包含 LatLng 对象。

request
类型:  DirectionsRequest
生成相应结果的 DirectionsRequest。
routes
类型:  Array<DirectionsRoute>
一个 DirectionsRoute 数组,其中每个元素都包含有关相应路段及其所包含的步骤的信息。除非 DirectionsRequest 是在 provideRouteAlternatives 设置为 true 的情况下创建的,否则只会有一条路线。
available_travel_modes optional
类型:  Array<TravelMode> optional
包含可用出行方式的数组。当请求指定出行方式但未获得任何结果时,系统会返回此字段。该数组包含给定航点组中相应国家/地区提供的出行方式。如果一个或多个途经点是“途经点”,则不会返回此字段。
geocoded_waypoints optional
类型:  Array<DirectionsGeocodedWaypoint> optional
一个 DirectionsGeocodedWaypoint 数组,其中每个元素都包含有关出发地、目的地和航点的地理编码的信息。

DirectionsRenderer

google.maps.DirectionsRenderer

呈现从 DirectionsService 获取的路线。

此类扩展了 MVCObject

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

DirectionsRenderer
DirectionsRenderer([opts])
参数: 
使用指定选项创建渲染程序。路线可在地图上呈现(以视觉叠加层的形式),也可在 <div> 面板上呈现(以文字说明的形式)。
getDirections
getDirections()
参数:无
返回值:  DirectionsResult
传回渲染程序的当前路线集。
getMap
getMap()
参数:无
返回值:  Map
返回渲染 DirectionsResult 的地图。
getPanel
getPanel()
参数:无
返回值:  HTMLElement|null
返回渲染 DirectionsResult 的面板 <div>
getRouteIndex
getRouteIndex()
参数:无
返回值:  number
返回此 DirectionsRenderer 对象当前使用的(从零开始的)路线索引。
setDirections
setDirections(directions)
参数: 
返回值:无
将渲染器设置为使用 DirectionsService 的结果。以这种方式设置一组有效的路线将在渲染程序的指定地图和面板上显示这些路线。
setMap
setMap(map)
参数: 
返回值:无
此方法指定将在其上渲染路线的地图。传递 null 以从地图中移除路线。
setOptions
setOptions(options)
参数: 
返回值:无
在初始化后更改此 DirectionsRenderer 的选项设置。
setPanel
setPanel(panel)
参数: 
返回值:无
此方法会在 <div> 中呈现路线。传递 null 以从面板中移除内容。
setRouteIndex
setRouteIndex(routeIndex)
参数: 
  • routeIndexnumber
返回值:无
设置 DirectionsResult 对象中要渲染的路线的索引(从零开始)。默认情况下,将渲染数组中的第一条路线。
继承自addListenerbindTogetnotifysetsetValuesunbindunbindAll
directions_changed
function()
参数:None
当渲染的路线发生变化时(无论是设置新的 DirectionsResult 还是用户完成拖动操作以更改路线),系统都会触发此事件。

DirectionsRendererOptions 接口

google.maps.DirectionsRendererOptions 接口

此对象定义了可针对 DirectionsRenderer 对象设置的属性。

directions optional
类型:  DirectionsResult optional
要在地图上和/或 <div> 面板中显示的路线,以 DirectionsResult 对象的形式从 DirectionsService 中检索。
draggable optional
类型:  boolean optional
如果值为 true,则允许用户拖动和修改此 DirectionsRenderer 渲染的路线的路径。
hideRouteList optional
类型:  boolean optional
默认值false
此属性用于指示渲染器是否应在“路线”面板中提供可供用户选择的路线列表。
infoWindow optional
类型:  InfoWindow optional
点击标记时用于呈现文本信息的 InfoWindow。现有的信息窗口内容将会被覆盖,其位置也会移动。如果未指定信息窗口,DirectionsRenderer 将创建并使用自己的信息窗口。如果 suppressInfoWindows 设置为 true,系统将忽略此属性。
map optional
类型:  Map optional
要在其上显示路线的地图。
markerOptions optional
类型:  MarkerOptions optional
标记的选项。DirectionsRenderer 渲染的所有标记都将使用这些选项。
panel optional
类型:  HTMLElement optional
用于显示路线步骤的 <div>
polylineOptions optional
类型:  PolylineOptions optional
折线的选项。由 DirectionsRenderer 渲染的所有折线都将使用这些选项。
preserveViewport optional
类型:  boolean optional
默认值false
如果此选项设置为 true 或从未设置过地图的中心和缩放级别,则输入地图会居中并缩放至这组路线的边界框。
routeIndex optional
类型:  number optional
DirectionsResult 对象中路线的索引。默认值为 0。
suppressBicyclingLayer optional
类型:  boolean optional
在请求骑车路线时,禁止渲染 BicyclingLayer
suppressInfoWindows optional
类型:  boolean optional
取消信息窗口的渲染。
suppressMarkers optional
类型:  boolean optional
取消标记的渲染。
suppressPolylines optional
类型:  boolean optional
取消折线的渲染。

DirectionsWaypoint 接口

google.maps.DirectionsWaypoint 接口

DirectionsWaypoint 表示出发地和目的地之间应规划行程的某个位置。

location optional
类型:  string|LatLng|LatLngLiteral|Place optional
路标位置。可以是地址字符串、LatLngPlace。可选。
stopover optional
类型:  boolean optional
默认值true
如果值为 true,则表示此航点是出发地和目的地之间的经停点。这会将路线拆分为两段。如果值为 false,则表示路线应偏向于经过此途经点,但不会拆分为两段。如果您想在用户拖动地图上的途经点时创建路线,此方法非常有用。

DirectionsGeocodedWaypoint 接口

google.maps.DirectionsGeocodedWaypoint 接口

单个经过地理编码的航点。

partial_match optional
类型:  boolean optional
地理编码器是否无法返回与原始途径点完全匹配的结果,尽管它能够匹配所请求地址的一部分内容。
place_id optional
类型:  string optional
与途经点关联的地点 ID。地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。如需详细了解地点 ID,请参阅 Places API 开发者指南。
types optional
类型:  Array<string> optional
一个字符串数组,这些字符串表示传回的地址解析元素的类型。如需查看可能的字符串列表,请参阅《开发者指南》的 地址组成部分类型部分。

DirectionsRoute 接口

google.maps.DirectionsRoute 接口

包含 DirectionsResult 中一组路段的单个路线。请注意,虽然此对象类似于 JSON,但它并不完全是 JSON,因为它直接和间接包含 LatLng 对象。

bounds
类型:  LatLngBounds
此路线的范围。
copyrights
类型:  string
要针对此路线显示的版权文本。
legs
类型:  Array<DirectionsLeg>
一个 DirectionsLeg 的数组,其中每个 DirectionsLeg 都包含有关其组成步骤的信息。系统会针对指定的每个经停航点或目的地显示一段单独的路程。因此,如果路线不包含停靠航点,则会包含一个 DirectionsLeg;如果路线包含一个停靠航点,则会包含两个。
overview_path
类型:  Array<LatLng>
一个 LatLng 数组,表示此路线的整个行程。该路径已简化,目的是为了适应需要少量顶点的环境(如 Google Static Maps API 网址)。
overview_polyline
类型:  string
概览路径的编码多段线表示法。此多段线是所生成路线的近似(平滑处理)路径。
summary
类型:  string
包含路线的简短文字说明,适合用于命名路线并区分路线与替代路线。
warnings
类型:  Array<string>
显示这些路线时将要显示的警告。
waypoint_order
类型:  Array<number>
如果 optimizeWaypoints 设置为 true,此字段将包含输入途经点的重新排序后的排列。例如,如果输入为:
  起点:洛杉矶
  途经点:达拉斯、班戈、凤凰城
  目的地:纽约
且优化后的输出按以下顺序排列:
  起点:洛杉矶
  途经点:凤凰城、达拉斯、班戈
  目的地:纽约
,则此字段将是一个 Array,其中包含值 [2, 0, 1]。请注意,路标的编号是从零开始的。
如果任何输入途径点的 stopover 设置为 false,则此字段将为空,因为此类查询无法进行路线优化。
fare optional
类型:  TransitFare optional
整个中转行程的总票价。仅适用于公交请求。

DirectionsLeg 接口

google.maps.DirectionsLeg 接口

DirectionsResult 中的一组步数组成的单个路段。路程中的某些字段可能并不会针对所有请求返回请注意,虽然此结果类似于 JSON,但它并不完全是 JSON,因为它直接或间接包含 LatLng 对象。

end_address
类型:  string
相应路段的目的地地址。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。
end_location
类型:  LatLng
DirectionsService 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线。end_location 表示实际的地理编码目的地,如果道路不在这段路程的目的地附近,则该值可能与最后一步的 end_location 不同。
start_address
类型:  string
相应路段的出发地地址。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。
start_location
类型:  LatLng
DirectionsService 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线。start_location 表示实际的地理编码出发地,如果道路不在这段路程的出发地附近,则该值可能与第一步的 start_location 不同。
steps
类型:  Array<DirectionsStep>
一个 DirectionsStep 数组,其中每个元素都包含相应路程中各个路段的相关信息。
traffic_speed_entry
类型:  Array<*>
有关路段交通速度的信息。
via_waypoints
类型:  Array<LatLng>
相应路段上的一系列非经停途经点(在原始请求中指定)。

在备选路线中已弃用。版本 3.27 将是最后一版可在备选路线中添加额外 via_waypoints 的 API。

使用路线服务来实现可拖动路线时,建议停用备选路线的拖动功能。只有主路线应该是可拖动的。用户可以拖动主路线,直到它与备选路线一致为止。

arrival_time optional
类型:  Time optional
相应路段的预计到达时间。仅适用于公交请求。
departure_time optional
类型:  Time optional
相应路段的预计出发时间。仅适用于公交请求。
distance optional
类型:  Distance optional
此路程覆盖的总距离。此属性可能未定义,因为距离可能未知。
duration optional
类型:  Duration optional
此路程的总持续时间。此属性可能为 undefined,因为时长可能未知。
duration_in_traffic optional
类型:  Duration optional
这段路程的总时长,其中考虑了 trafficModel 属性指示的路况。此属性可能为 undefined,因为时长可能未知。

DirectionsStep 接口

google.maps.DirectionsStep 接口

DirectionsResult 中的单个 DirectionsStep。某些字段可能为 undefined。请注意,虽然此对象类似于 JSON,但它并不完全是 JSON,因为它直接包含 LatLng 对象。

encoded_lat_lngs
类型:  string
相应路段的编码多段线表示法。此多段线是路段的近似(平滑)路径。
end_location
类型:  LatLng
此路段的结束位置。
end_point
类型:  LatLng
此路段的结束位置。
instructions
类型:  string
此路段的说明。
lat_lngs
类型:  Array<LatLng>
一系列 LatLng,用于描述此路段的路线。此多段线是路段的近似(平滑)路径。
maneuver
类型:  string
包含当前步骤要执行的操作(turn-leftmergestraight 等)。这些值可能会发生变化,我们可能会在未事先通知您的情况下引入新值。
path
类型:  Array<LatLng>
一系列 LatLng,用于描述此路段的路线。此多段线是路段的近似(平滑)路径。
start_location
类型:  LatLng
此路段的起始位置。
start_point
类型:  LatLng
此路段的起始位置。
travel_mode
类型:  TravelMode
此路段中所使用的出行方式。
distance optional
类型:  Distance optional
此路段覆盖的距离。此属性可能为 undefined,因为距离可能未知。
duration optional
类型:  Duration optional
完成此路段通常所需的时间(以秒为单位,采用文本形式)。此属性可能为 undefined,因为时长可能未知。
polyline optional
类型:  DirectionsPolyline optional
包含一个具有单个属性“points”的对象,该属性用于保存路段的编码多段线表示法。此多段线是分段的近似(平滑)路径。
steps optional
类型:  Array<DirectionsStep> optional
此步骤的子步骤。针对公交路线的非公交路段指定。
transit optional
类型:  TransitDetails optional
有关此步骤的公交专用详细信息。除非相应步的出行模式为 TRANSIT,否则此属性将处于未定义状态。
transit_details optional
类型:  TransitDetails optional
如果出行方式为 TRANSIT,则此步骤的相关详细信息。

DirectionsPolyline 接口

google.maps.DirectionsPolyline 接口

一个包含 points 属性的对象,用于描述 DirectionsStep 的多段线。

points
类型:  string

Place 接口

google.maps.Place 接口

包含为 DirectionsRequestDistanceMatrixRequest 查找、识别或描述地点所需的信息。在这种情况下,“地点”是指商家、地图注点或地理位置。如需获取有关某个地点的信息,请参阅 PlacesService

location optional
类型:  LatLng|LatLngLiteral optional
相应地点所描述实体的 LatLng
placeId optional
类型:  string optional
地点的地点 ID(例如商家或地图注点)。地点 ID 是 Google 地图数据库中某个地点的唯一标识符。请注意,placeId 是识别地点的最准确方式。如果可能,您应指定 placeId,而不是 query。地点 ID 可从对 Places API 的任何请求(例如 TextSearch)中检索。您还可以通过向 Geocoding API 发出的请求检索地点 ID。如需了解详情,请参阅地点 ID 概览
query optional
类型:  string optional
描述地点的搜索查询(例如商家或地图注点)。例如,查询可以是“Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW”。如果可能,您应指定 placeId,而不是 query。API 不保证将查询字符串解析为地点的准确性。如果同时提供了 placeIdquery,则会发生错误。

TravelMode 常量

google.maps.TravelMode 常量

可在 DirectionsRequest 中指定的有效出行方式,以及可在 DirectionsStep 中返回的出行方式。您可以通过值或使用常量的名称来指定这些参数。例如 'BICYCLING'google.maps.TravelMode.BICYCLING

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

BICYCLING 指定骑车路线请求。
DRIVING 指定行车路线请求。
TRANSIT 指定公交路线请求。
WALKING 指定步行路线请求。

DrivingOptions 接口

google.maps.DrivingOptions 接口

当出行模式设置为 DRIVING 时,配置 DirectionsRequest

departureTime
类型:  Date
路线的预期出发时间,以 Date 对象的形式指定。Date 对象以自 1970 年 1 月 1 日以来的毫秒数来衡量时间。必须指定此值,DrivingOptions 才能有效。出发时间必须设置为当前时间或未来的某个时间。而不能是过去的时间。
trafficModel optional
类型:  TrafficModel optional
预测交通中的时长时要使用的首选假设。默认值为 BEST_GUESS

TrafficModel 常量

google.maps.TrafficModel 常量

预测流量中的时长时要使用的假设。指定为 DirectionsRequestDistanceMatrixRequest 的一部分。您可以通过值或使用常量的名称来指定这些参数。例如 'bestguess'google.maps.TrafficModel.BEST_GUESS

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

BEST_GUESS 使用历史交通数据来尽可能准确地估算交通拥堵时间。
OPTIMISTIC 使用历史流量数据乐观估计流量中的时长。
PESSIMISTIC 使用历史交通数据对交通中的时长进行悲观估计。

TransitOptions 接口

google.maps.TransitOptions 接口

当出行方式设置为 TRANSIT 时,要包含在 DirectionsRequest 中的 TransitOptions 对象。

arrivalTime optional
类型:  Date optional
路线的预期到达时间,以 Date 对象的形式指定。Date 对象以自 1970 年 1 月 1 日以来的毫秒数来衡量时间。如果指定了到达时间,就会忽略出发时间
departureTime optional
类型:  Date optional
路线的预期出发时间,以 Date 对象的形式指定。Date 对象以自 1970 年 1 月 1 日以来的毫秒数来衡量时间。如果未指定出发时间和到达时间,则系统会假定时间为“现在”。
modes optional
类型:  Array<TransitMode> optional
一种或多种首选公共交通方式,例如公交车或火车。如果未指定任何偏好设置,API 会返回默认的最佳路线。
routingPreference optional
类型:  TransitRoutePreference optional
可影响公交路线选择的偏好设置,例如步行路程较短。如果未指定任何偏好设置,API 会返回默认的最佳路线。

TransitMode 常量

google.maps.TransitMode 常量

可在 TransitOptions 中指定的有效公交模式,例如“公交”。您可以通过值或使用常量的名称来指定这些参数。例如 'BUS'google.maps.TransitMode.BUS

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

BUS 指定公交车为首选公共交通方式。
RAIL 指定轨道交通为首选公共交通方式。
SUBWAY 指定地铁为首选公共交通方式。
TRAIN 指定火车为首选公共交通方式。
TRAM 指定电车为首选公共交通方式。

TransitRoutePreference 常量

google.maps.TransitRoutePreference 常量

可在 TransitOptions 中指定的有效公交路线类型。您可以通过值或使用常量的名称来指定这些参数。例如 'LESS_WALKING'google.maps.TransitRoutePreference.LESS_WALKING

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

FEWER_TRANSFERS 指定计算出的路线应首选换乘次数较少的路线。
LESS_WALKING 指定计算出的路线应首选步行距离较短的路线。

TransitFare 接口

google.maps.TransitFare 接口

DirectionsRoute 的票价,包含价值和币种。

currency
类型:  string
一个 ISO 4217 货币代码,表示票价所采用的币种。
text
类型:  string
票价的值,以指定 currency 表示,以字符串形式呈现。
value
类型:  number
票价的数值,以给定的 currency 表示。

TransitDetails 接口

google.maps.TransitDetails 接口

有关此路段的出发地、到达地以及所用公交模式的详细信息。

arrival_stop
类型:  TransitStop
相应公交步骤的到达站。
arrival_time
类型:  Time
相应路段的到达时间,以 Time 对象的形式指定。
departure_stop
类型:  TransitStop
相应公交步骤的出发站。
departure_time
类型:  Time
相应步骤的出发时间,以 Time 对象的形式指定。
headsign
类型:  string
该线路的行进方向,如车辆或出发站所标示的方向。
headway
类型:  number
此站点的同类车辆之间的预计间隔秒数。
line
类型:  TransitLine
相应路段中所用公交线路的详细信息。
num_stops
类型:  number
相应路段中的公交站数量。该数量包含到达站点,但不含出发站点。
trip_short_name
类型:  string
显示在时刻表和指示牌中的文字,用于向乘客标识公交行程,例如标识通勤铁路行程的列车编号。该文本可唯一标识服务日内的行程。

TransitStop 接口

google.maps.TransitStop 接口

有关公交站或公交经停点的详细信息。

location
类型:  LatLng
相应停靠站的位置。
name
类型:  string
相应公交经停点的名称。

TransitLine 接口

google.maps.TransitLine 接口

有关运营相应公交路段的公交线路的信息。

agencies
类型:  Array<TransitAgency>
运营相应公交线路的公交公司。
color
类型:  string
相应公交线路的站牌上常用的颜色,以十六进制字符串表示。
icon
类型:  string
与相应线路相关联的图标的网址。
name
类型:  string
相应公交线路的全名,例如“8 Avenue Local”。
short_name
类型:  string
相应公交线路的简称,例如“E”。
text_color
类型:  string
相应公交线路的站牌上常用的文字颜色,以十六进制字符串表示。
url
类型:  string
公交公司针对相应公交线路的网址。
vehicle
类型:  TransitVehicle
所用车辆的类型,例如火车或公交车。

TransitAgency 接口

google.maps.TransitAgency 接口

运营公交线路的机构的相关信息。

name
类型:  string
相应公交公司的名称。
phone
类型:  string
公交公司的电话号码。
url
类型:  string
公交公司的网址。

TransitVehicle 接口

google.maps.TransitVehicle 接口

有关公交线路上的车辆的信息。

icon
类型:  string
与该线路所用交通工具类型对应的图标的网址。
local_icon
类型:  string
与相应区域所用交通工具类型对应的图标的网址,而不是更通用的图标。
name
类型:  string
相应公交车辆类型的名称,例如“火车”或“公交车”。
type
类型:  VehicleType
所用车辆的类型,例如火车、公交车或渡轮。

VehicleType 常量

google.maps.VehicleType 常量

车辆类型的可能值。

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

BUS 公交车。
CABLE_CAR 一种靠电缆运行的交通工具,通常在地面上行驶。空中缆车可以算作 GONDOLA_LIFT 类型。
COMMUTER_TRAIN 通勤铁路。
FERRY 轮渡。
FUNICULAR 一种由缆线拉上陡坡的交通工具。
GONDOLA_LIFT 空中缆车
HEAVY_RAIL 重轨。
HIGH_SPEED_TRAIN 高速列车。
INTERCITY_BUS 长途客车。
METRO_RAIL 轻轨。
MONORAIL 单轨。
OTHER 其他车辆。
RAIL 铁路。
SHARE_TAXI 共享出租车是一种公交车,可供乘客在其路线中的任意位置上下车。一般而言,合乘出租车使用小型巴士车辆。
SUBWAY 地下轻轨。
TRAM 地上轻轨。
TROLLEYBUS 无轨电车。

UnitSystem 常量

google.maps.UnitSystem 常量

可在 DirectionsRequest 中指定的有效单位制。

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

IMPERIAL 指定 DirectionsResult 中的距离应以英制单位表示。
METRIC 指定 DirectionsResult 中的距离应以公制单位表示。

距离接口

google.maps.Distance 接口

距离的表示(采用数值和显示字符串的形式)。

text
类型:  string
距离值的字符串表示形式,使用请求中指定的 UnitSystem
value
类型:  number
距离(以米为单位)。

时长接口

google.maps.Duration 接口

持续时间的表示(采用数值和显示字符串的形式)。

text
类型:  string
持续时间值的字符串表示。
value
类型:  number
持续时间(以秒为单位)。

时间接口

google.maps.Time 接口

以 Date 对象、本地化字符串和时区表示的时间。

text
类型:  string
表示时间值的字符串。时间以公共交通车站的时区显示。
time_zone
类型:  string
相应经停点所在的时区。该属性的值是时区的名称(如 IANA 时区数据库中所定义),例如“America/New_York”。
value
类型:  Date
相应出发或到达的时间,以 JavaScript Date 对象的形式指定。

DirectionsTravelMode 常量

google.maps.DirectionsTravelMode 常量

DirectionsUnitSystem 常量

google.maps.DirectionsUnitSystem 常量