Directions (deprecated)

DirectionsService 类

class google.maps.DirectionsService
library "routes"

const {DirectionsService} = await google.maps.importLibrary("routes");
DirectionsService
DirectionsService()
参数:无
创建 DirectionsService 的新实例,用于向 Google 服务器发送路线查询。
route
route(request[, callback])
参数:
发出路线搜索请求。

DirectionsRequest 接口

接口 google.maps.DirectionsRequest

要发送到 DirectionsService 的路线查询。

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

DirectionsStatus 常量

常量 google.maps.DirectionsStatus
库 "routes"

DirectionsService 在完成对 route() 的调用后返回的状态。按值或使用常量名称指定这些值。例如 'OK' 或 google.maps.DirectionsStatus.OK。

这些常量也可以用作字符串。在 TypeScript 中,字符串字面量由 DirectionsStatusString 类型定义。

const {DirectionsStatus} = await google.maps.importLibrary("routes");
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
DirectionsRoute 数组,其中每个对象都包含有关其组成路段和步骤的信息。除非 DirectionsRequest 是在 provideRouteAlternatives 设置为 true 的情况下创建的,否则只会有一条路线。
available_travel_modes
可选
类型:Array<TravelMode> optional
包含可用出行方式的数组。如果请求指定了出行方式,但未返回任何结果,则会返回此字段。该数组包含给定航点集所在国家/地区可用的出行方式。如果一个或多个航点是“途径航点”,则系统不会返回此字段。
geocoded_waypoints
可选
DirectionsGeocodedWaypoint 数组,其中每个对象都包含有关出发地、目的地和航点的地理编码信息。

DirectionsRenderer 类

class google.maps.DirectionsRenderer extends MVCObject
library "routes"

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

DirectionsRendererOptions 接口

接口 google.maps.DirectionsRendererOptions

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

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

DirectionsWaypoint 接口

接口 google.maps.DirectionsWaypoint

DirectionsWaypoint 表示行程应经过的出发地和目的地之间的位置。

location
可选
类型:string|LatLng|LatLngLiteral|Place optional
路标位置。可以是地址字符串、LatLng 或 Place。可选。
stopover
可选
类型:boolean optional
默认值:true
如果为 true,则表示此航点是起点和终点之间的经停点。这会将路线一分为二。如果为 false,则表示路线应偏向于经过此航点,但不会拆分为两个路段。如果您想根据用户在地图上拖动航点的操作来创建路线,此功能会非常有用。

DirectionsGeocodedWaypoint 接口

接口 google.maps.DirectionsGeocodedWaypoint

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

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

DirectionsRoute 接口

接口 google.maps.DirectionsRoute

DirectionsResult 中包含一组路段的单条路线。请注意,虽然此对象“类似于 JSON”,但它并非严格意义上的 JSON,因为它直接和间接包含 LatLng 对象。

bounds
类型:LatLngBounds
此路线的范围。
copyrights
类型:string
要针对此路线显示的版权文本。
legs
DirectionsLeg 数组,其中每个都包含有关其组成步骤的信息。系统会针对指定的每个经停航点或目的地显示一段路程。因此,不含停靠航点的路线将包含一个 DirectionsLeg,而包含一个停靠航点的路线将包含两个。
overview_path
类型:Array<LatLng>
LatLng 数组,表示此路线的整个路径。该路径已简化,目的是为了适应需要少量顶点的环境(如 Google Static Maps API 网址)。
overview_polyline
类型:string
overview_path 中路线的编码多段线表示法。此多段线是所生成路线的近似(平滑处理)路径。
summary
类型:string
包含路线的简短文字说明,适合用于命名路线以及区分路线与其他备选路线。
warnings
类型:Array<string>
显示这些路线时将要显示的警告。
waypoint_order
类型:Array<number>
如果 optimizeWaypoints 设置为 true,则此字段将包含输入航点的重新排序排列。例如,如果输入为:
  起点:洛杉矶
  航点:达拉斯、班戈、菲尼克斯
  终点:纽约
并且优化后的输出顺序如下:
  起点:洛杉矶
  航点:菲尼克斯、达拉斯、班戈
  终点:纽约
那么此字段将是一个包含值 [2, 0, 1] 的 Array。请注意,路标的编号是从零开始的。
如果任何输入航点的 stopover 设置为 false,此字段将为空,因为此类查询不支持路线优化。
fare
可选
类型: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
DirectionsStep 数组,其中每个 都包含此路段中各个步骤的相关信息。
traffic_speed_entry
类型:Array<*>
有关路段车速的信息。
via_waypoints
类型:Array<LatLng>
此路段沿途的非停靠航点数组,这些航点是在原始请求中指定的。

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

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

arrival_time
可选
类型:Time optional
这段路程的预计到达时间。仅适用于 TRANSIT 请求。
departure_time
可选
类型:Time optional
这段路程的预计出发时间。仅适用于 TRANSIT 请求。
distance
可选
类型:Distance optional
此路程覆盖的总距离。此属性可能未定义,因为距离可能未知。
duration
可选
类型:Duration optional
此路程的总持续时间。由于时长可能未知,此属性可能为 undefined。
duration_in_traffic
可选
类型: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-left、merge、straight 等)。这些值可能会发生变化,并且我们可能会在未事先通知您的情况下引入新值。
path
类型:Array<LatLng>
一系列 LatLng,用于描述此路段的路径。这是路段的近似(平滑)路径。
start_location
类型:LatLng
此路段的起始位置。
start_point
类型:LatLng
此路段的起始位置。
travel_mode
类型:TravelMode
此路段中所使用的出行方式。
distance
可选
类型:Distance optional
此路段覆盖的距离。此属性可能为 undefined,因为距离可能未知。
duration
可选
类型:Duration optional
完成此路段通常所需的时间(以秒为单位,采用文本形式)。由于时长可能未知,此属性可能为 undefined。
polyline
可选
类型:DirectionsPolyline optional
包含一个具有单个属性“points”的对象,该属性用于保存路段的编码多段线表示法。此多段线是分段的近似(平滑)路径。
steps
可选
类型:Array<DirectionsStep> optional
此步骤的子步骤。为公交路线的非公交路段指定。
transit
可选
类型:TransitDetails optional
此步骤的公交专用详情。除非此路段的出行方式为 TRANSIT,否则此属性将处于未定义状态。
transit_details
可选
类型:TransitDetails optional
如果出行方式为 TRANSIT,则为与此步骤相关的详细信息。

DirectionsPolyline 接口

接口 google.maps.DirectionsPolyline

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

points
类型:string

Place 接口

接口 google.maps.Place

包含为 DirectionsRequest 或 DistanceMatrixRequest 定位、识别或描述地点所需的信息。在这种情况下,“地点”是指商家、地图注点或地理位置。如需提取地点相关信息,请参阅 PlacesService。

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

TravelMode 常量

常量 google.maps.TravelMode
库 "routes"

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

这些常量也可以用作字符串。在 TypeScript 中,字符串字面量由 TravelModeString 类型定义。

const {TravelMode} = await google.maps.importLibrary("routes");
BICYCLING 指定骑车路线请求。
DRIVING 指定行车路线请求。
TRANSIT 指定公共交通路线请求。
BetaTWO_WHEELER 指定双轮机动车路线请求。
WALKING 指定步行路线请求。

DrivingOptions 接口

接口 google.maps.DrivingOptions

在出行方式设置为 DRIVING 时配置 DirectionsRequest。

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

TrafficModel 常量

常量 google.maps.TrafficModel
库 "routes"

预测路况中的时长时要使用的假设。指定为 DirectionsRequest 或 DistanceMatrixRequest 的一部分。按值或使用常量名称指定这些值。例如 'bestguess' 或 google.maps.TrafficModel.BEST_GUESS。

这些常量也可以用作字符串。在 TypeScript 中,字符串字面量由 TrafficModelString 类型定义。

const {TrafficModel} = await google.maps.importLibrary("routes");
BEST_GUESS 使用历史路况数据,尽可能准确地估算在路上花费的时间。
OPTIMISTIC 使用历史路况数据对路况中的时长进行乐观估算。
PESSIMISTIC 使用历史路况数据对路况中的时长进行悲观估计。

TransitOptions 接口

接口 google.maps.TransitOptions

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

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

TransitMode 常量

常量 google.maps.TransitMode
库 "routes"

可在 TransitOptions 中指定的有效公交方式,例如公交车。按值或使用常量名称指定这些值。例如 'BUS' 或 google.maps.TransitMode.BUS。

这些常量也可以用作字符串。在 TypeScript 中,字符串字面量由 TransitModeString 类型定义。

const {TransitMode} = await google.maps.importLibrary("routes");
BUS 指定公交车为首选公共交通方式。
BetaLIGHT_RAIL 指定轻轨为首选公共交通方式。
RAIL 指定铁路作为首选公共交通方式。
SUBWAY 指定地铁作为首选公共交通方式。
TRAIN 指定火车作为首选公共交通方式。
TRAM 指定电车作为首选公共交通方式。

TransitRoutePreference 常量

常量 google.maps.TransitRoutePreference
库 "routes"

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

这些常量也可以用作字符串。在 TypeScript 中,字符串字面量由 TransitRoutePreferenceString 类型定义。

const {TransitRoutePreference} = await google.maps.importLibrary("routes");
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
运营此公共交通线路的公共交通公司。
color
类型:string
该公交线路站牌常用的颜色,以十六进制字符串表示。
icon
类型:string
与该线路相关联的图标的网址。
name
类型:string
该公交线路的全名,例如“8 Avenue Local”。
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
库 "routes"

车辆类型的可能值。

这些常量也可以用作字符串。在 TypeScript 中,字符串字面量由 VehicleTypeString 类型定义。

const {VehicleType} = await google.maps.importLibrary("routes");
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
库 "core"

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

const {UnitSystem} = await google.maps.importLibrary("core");
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

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

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