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 ,则指示路线服务尽可能避开收费路段。可选。 |
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 为 广告附加信息 的请求。此对象对其他出行方式没有任何影响。 |
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 包含可用出行方式的数组。如果请求指定了出行方式但未收到任何结果,则系统会返回此字段。数组包含给定航点集的国家/地区的可用出行方式。如果一个或多个路径点为“via 路径点”,则不会返回此字段。 |
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) 参数:
返回值:None
将渲染程序设置为使用来自 DirectionsService 的结果。以这种方式设置一组有效的路线将在渲染程序的指定地图和面板上显示这些路线。 |
setMap |
setMap(map) 参数:
返回值:None
此方法指定将在其上渲染路线的地图。传递 null 即可从地图中移除路线。 |
setOptions |
setOptions(options) 参数:
返回值:None
完成初始化后,更改此 DirectionsRenderer 的选项设置。 |
setPanel |
setPanel(panel) 参数:
返回值:None
此方法在 <div> 中渲染路线。传递 null 可从面板中移除内容。 |
setRouteIndex |
setRouteIndex(routeIndex) 参数:
返回值:None
在 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 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 路标位置。可以是地址字符串、 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 ,而具有一个停靠航点的路线将包含两个停靠航点。 |
overview_path |
LatLng 数组,表示此路线的整个路线。该路径已简化,目的是为了适应需要少量顶点的环境(如 Google Static Maps API 网址)。 |
overview_polyline |
类型:
string Overview_path 中路线的编码多段线表示法。此多段线是所生成路线的近似(平滑处理)路径。 |
summary |
类型:
string 包含路线的简短文本说明,适用于命名路线以及消除路线与备选路线的歧义。 |
warnings |
类型:
Array<string> 显示这些路线时将要显示的警告。 |
waypoint_order |
类型:
Array<number> 如果 optimizeWaypoints 设置为 true ,则此字段将包含输入航点的重新排序的排列。例如,如果输入值为:出发地:洛杉矶 航点:达拉斯、班戈尔、菲尼克斯 目的地:纽约 ,优化输出排序如下: 出发地:洛杉矶 航点:菲尼克斯、达拉斯、班戈 目的地:纽约 ,那么此字段的值为 [2, 1.]。 Array 请注意,路标的编号是从零开始的。如果任何输入航点的 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 数组,其中每个路段都包含有关这段路程中各个路段的信息。 |
|
类型:
Array<?> 路程沿途车流速度信息。 |
via_waypoints |
沿这段路程的不停靠航点数组,在原始请求中指定。 在备用路由中已弃用。版本 3.27 将是最后一个在备选路线中添加额外 使用路线服务实现可拖动路线时,建议停用备选路线的拖动功能。只有主路线应该是可拖动的。用户可以拖动主路线,直到它与备选路线一致为止。 |
arrival_time optional |
类型:
Time optional 这段路程的预计到达时间。仅适用于 Transit 请求。 |
departure_time optional |
类型:
Time optional 这段路程的预计出发时间。仅适用于 Transit 请求。 |
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 。可以从向 Places API 发送的任何请求(例如,TextSearch)中检索地点 ID。您也可以通过向 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 货币代码,用于表示票价所采用的货币。 |
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 大道”。 |
short_name |
类型:
string 该公交线路的简称,例如“E”。 |
text_color |
类型:
string 该公交线路标牌中常用的文字颜色,以十六进制字符串表示。 |
url |
类型:
string 该公交线路的专属代理机构网址。 |
vehicle |
所用交通工具的类型,如火车或公交车。 |
TransitAgency 接口
google.maps.TransitAgency
接口
运营公交线路的公交公司的相关信息。
属性 | |
---|---|
name |
类型:
string 此公交公司的名称。 |
phone |
类型:
string 公交公司的电话号码。 |
url |
类型:
string 公交公司的网址。 |
TransitVehicle 接口
google.maps.TransitVehicle
接口
在公交线路上行驶的车辆的相关信息。
属性 | |
---|---|
icon |
类型:
string 与该线路所用交通工具类型对应的图标的网址。 |
local_icon |
类型:
string 对应于此区域所用车辆类型(而不是更宽泛的图标)的图标的网址。 |
name |
类型:
string 此类 TransitVehicle 的名称,例如“火车”或“公交车”。 |
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 中的距离。 |
Distance 界面
google.maps.Distance
接口
距离的表示(采用数值和显示字符串的形式)。
属性 | |
---|---|
text |
类型:
string 距离值的字符串表示,使用请求中指定的 UnitSystem 。 |
value |
类型:
number 距离(以米为单位)。 |
Duration 接口
google.maps.Duration
接口
持续时间的表示(采用数值和显示字符串的形式)。
属性 | |
---|---|
text |
类型:
string 持续时间值的字符串表示。 |
value |
类型:
number 持续时间(以秒为单位)。 |
Time 接口
google.maps.Time
接口
以日期对象、本地化字符串和时区表示时间。
属性 | |
---|---|
text |
类型:
string 表示时间值的字符串。时间以公共交通车站的时区显示。 |
time_zone |
类型:
string 此经停点所在的时区。该值是 IANA 时区数据库中定义的时区名称,例如“America/New_York”。 |
value |
类型:
Date 此出发或到达时间,以 JavaScript Date 对象的形式指定。 |
DirectionsTravelMode 常量
google.maps.DirectionsTravelMode
常量
DirectionsUnitSystem 常量
google.maps.DirectionsUnitSystem
常量