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目标位置。此参数可以指定为要进行地理编码的字符串、 LatLng 或 Place。必填。 | 
origin | 
类型:   
string|LatLng|Place|LatLngLiteral原点的位置。此参数可以指定为要进行地理编码的字符串、 LatLng 或 Place。必填。 | 
travelMode | 
类型:   
TravelMode请求的路线类型。必填。  | 
avoidFerries optional | 
类型:   
boolean optional如果值为  true,则指示路线服务尽可能避开轮渡。可选。 | 
avoidHighways optional | 
类型:   
boolean optional如果值为  true,则指示路线服务尽可能避开公路。可选。 | 
avoidTolls optional | 
类型:   
boolean optional如果值为  true,则指示 Directions 服务尽可能避开收费路段。可选。 | 
drivingOptions optional | 
类型:   
DrivingOptions optional仅适用于  travelMode 为 DRIVING 的请求的设置。此对象对其他出行方式没有影响。 | 
language optional | 
类型:   
string optional一种语言标识符,用于指定应尽可能以哪种语言返回结果。请参阅支持的语言列表。  | 
optimizeWaypoints optional | 
类型:   
boolean optional如果设置为  true,DirectionsService 将尝试重新排序提供的中间途经点,以最大限度地降低路线的总费用。如果航点经过优化,请检查响应中的 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。  | 
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)参数:   
 返回值:无 
设置  DirectionsResult 对象中要渲染的路线的索引(从零开始)。默认情况下,将渲染数组中的第一条路线。 | 
继承自:
addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
 | |
事件 | |
|---|---|
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 optionalDirectionsResult 对象中路线的索引。默认值为 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路标位置。可以是地址字符串、 LatLng 或 Place。可选。 | 
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 | 
 一个  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 | 
类型:   
LatLngDirectionsService 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线。end_location 表示实际的地理编码目的地,如果道路不在这段路程的目的地附近,则该值可能与最后一步的 end_location 不同。 | 
start_address | 
类型:   
string相应路段的出发地地址。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。  | 
start_location | 
类型:   
LatLngDirectionsService 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线。start_location 表示实际的地理编码出发地,如果道路不在这段路程的出发地附近,则该值可能与第一步的 start_location 不同。 | 
steps | 
类型:   
Array<DirectionsStep>一个  DirectionsStep 数组,其中每个元素都包含相应路程中各个路段的相关信息。 | 
 | 
类型:   
Array<*>有关路段交通速度的信息。  | 
via_waypoints | 
 相应路段上的一系列非经停途经点(在原始请求中指定)。  在备选路线中已弃用。版本 3.27 将是最后一版可在备选路线中添加额外  使用路线服务来实现可拖动路线时,建议停用备选路线的拖动功能。只有主路线应该是可拖动的。用户可以拖动主路线,直到它与备选路线一致为止。  | 
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此路段的结束位置。  | 
 | 
类型:   
LatLng此路段的结束位置。  | 
instructions | 
类型:   
string此路段的说明。  | 
 | 
 一系列  LatLng,用于描述此路段的路线。此多段线是路段的近似(平滑)路径。 | 
maneuver | 
类型:   
string包含当前步骤要执行的操作( turn-left、merge、straight 等)。这些值可能会发生变化,我们可能会在未事先通知您的情况下引入新值。 | 
path | 
 一系列  LatLng,用于描述此路段的路线。此多段线是路段的近似(平滑)路径。 | 
start_location | 
类型:   
LatLng此路段的起始位置。  | 
 | 
类型:   
LatLng此路段的起始位置。  | 
travel_mode | 
类型:   
TravelMode此路段中所使用的出行方式。  | 
distance optional | 
类型:   
Distance optional此路段覆盖的距离。此属性可能为  undefined,因为距离可能未知。 | 
duration optional | 
类型:   
Duration optional完成此路段通常所需的时间(以秒为单位,采用文本形式)。此属性可能为  undefined,因为时长可能未知。 | 
 | 
类型:   
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
接口
包含为 DirectionsRequest 或 DistanceMatrixRequest 查找、识别或描述地点所需的信息。在这种情况下,“地点”是指商家、地图注点或地理位置。如需获取有关某个地点的信息,请参阅 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 不保证将查询字符串解析为地点的准确性。如果同时提供了 placeId 和 query,则会发生错误。 | 
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 常量
预测流量中的时长时要使用的假设。指定为 DirectionsRequest 或 DistanceMatrixRequest 的一部分。您可以通过值或使用常量的名称来指定这些参数。例如 '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 常量