路线回复

欧洲经济区 (EEA) 开发者

此产品处于旧版状态。自 2026 年 10 月起,您将无法再为新的 Google Cloud 项目启用 Directions API(旧版)。现有项目仍会得到全面支持。如需体验新功能和更出色的性能,请迁移到 Routes API。

响应示例

Directions 响应会以网址请求路径中的 output 标志所指示的格式返回。

以下示例 HTTP 请求计算了从伊利诺伊州芝加哥到加利福尼亚州洛杉矶的路线,该路线途经密苏里州乔普林和俄克拉荷马州俄克拉荷马城这两个航点。

网址

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

上述示例请求 JSON 输出。您也可以请求 XML 输出。选择以下标签页,查看 JSON 和 XML 响应示例。

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}
      
      

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>
      
      

本文档的其余部分将使用 JSON 语法。在大多数情况下,输出格式对于说明文档中的概念或字段名称并不重要。不过,请注意以下细微差别:

  • XML 结果封装在根 <DirectionsResponse> 元素中。
  • JSON 使用复数数组(例如 steps 和 legs)表示包含多个元素的条目,而 XML 使用多个单数元素(例如 <step> 和 <leg>)表示这些条目。
  • JSON 通过 waypoint_order 字段表示航点顺序,而 XML 则使用单独的 <waypoint_index> 元素表示这些顺序。
  • 空白元素在 JSON 中通过空数组表示,但在 XML 中则通过不包含任何此类元素来表示。例如,未生成任何结果的响应将在 JSON 中返回一个空的 routes 数组,但在 XML 中不返回任何 <route> 元素。

DirectionsResponse

字段 必填 类型 说明
required Array<DirectionsRoute>

包含从出发地到目的地的路线数组。路线由嵌套的航段和步骤组成。

如需了解详情,请参阅 DirectionsRoute。

required DirectionsStatus

包含请求的状态,可能还包含调试信息,以帮助您跟踪请求失败的原因。

如需了解详情,请参阅 DirectionsStatus。

可选 Array<TravelMode>

包含可用出行方式的数组。当请求指定了出行方式但未获得任何结果时,系统会返回此字段。该数组包含给定航点组所在国家/地区可用的出行方式。如果一个或多个航点是“途径航点”,则系统不会返回此字段。

如需了解详情,请参阅 TravelMode。

可选 字符串

当服务返回 OK 以外的状态代码时,响应对象中可能会有一个额外的 error_message 字段。此字段包含有关给定状态代码背后原因的更详细信息。此字段不一定会返回,其内容可能会发生变化。

可选 Array<DirectionsGeocodedWaypoint>

包含一个数组,其中包含有关出发地、目的地和航点的地理编码的详细信息。 geocoded_waypoints 数组中的元素按其从零开始的位置,分别对应于出发地、按指定顺序排列的航点以及目的地。

如果服务未返回任何结果,则对于指定为文本纬度/经度值的航点,这些详细信息将不会显示。这是因为,只有在找到路线后,系统才会对这些航点进行反向地理编码,以获取其代表性地址。空 JSON 对象将占据 geocoded_waypoints 数组中的相应位置。

如需了解详情,请参阅 DirectionsGeocodedWaypoint。

DirectionsRoute

路由由嵌套的 legs 和 steps 组成。

字段 必填 类型 说明
required 边界

包含 overview_polyline 的视口边界框。

如需了解详情,请参阅边界。

required 字符串

包含要为此路线显示的版权通知。您必须自行处理和显示这些信息。此内容应按原样读取。请勿以程序化方式解析此仅供显示的内容。

required Array<DirectionsLeg>

一个数组,其中包含有关路线的一段路程(介于给定路线中两个位置之间)的信息。系统会针对指定的每个航点或目的地显示一段单独的路程。(没有任何航点的路线将在 legs 数组中仅包含一个路段)。每段路程都由一系列步骤组成。

如需了解详情,请参阅 DirectionsLeg。

required DirectionsPolyline

包含一个对象,用于保存路线的编码多段线表示法。此多段线是所生成路线的近似(平滑)路径。

如需了解详情,请参阅 DirectionsPolyline。

required 字符串

包含路线的简短文字说明,适合用于命名路线以及区分路线与其他备选路线。

required Array<string>

包含一系列要在显示这些路线时显示的警告。您必须自行处理和显示这些警告。

required Array<integer>

一个数组,用于表示计算出的路线中任意航点的顺序。如果请求在其 waypoints 参数中传递了 optimize:true,则这些航点可能会重新排序。

可选 票价

如果存在,则包含该路线的总交通费用(即总票价)。 此属性仅针对公交请求返回,并且仅适用于所有公交路程均有票价信息的路线。

如需了解详情,请参阅票价。

边界

地理坐标中的矩形,由西南角和东北角的点定义。

字段 必填 类型 说明
required LatLngLiteral 如需了解详情,请参阅 LatLngLiteral。
required LatLngLiteral 如需了解详情,请参阅 LatLngLiteral。

LatLngLiteral

一个对象,用于描述特定位置,其中纬度和经度以十进制度表示。

字段 必填 类型 说明
required 数值

纬度(十进制度)

required 数值

经度(以十进制度为单位)

DirectionsLeg

字段 必填 类型 说明
required 字符串

包含通过对这段路程的 end_location 进行反向地理编码而获得的直观易懂的地址(通常为街道地址)。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。

required LatLngLiteral

此路段指定目的地的纬度/经度坐标。由于 Directions API 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线,因此 end_location 可能会与所提供的这段路程目的地不同,例如道路不在目的地附近时。

如需了解详情,请参阅 LatLngLiteral。

required 字符串

包含对这段路程的 start_location 进行反向地理编码后得到的人类可读地址(通常为街道地址)。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。

required LatLngLiteral

这段路程出发地的纬度/经度坐标。由于 Directions API 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线,因此 start_location 可能会与所提供的这段路程出发地不同,例如道路不在出发地附近时。

如需了解详情,请参阅 LatLngLiteral。

required Array<DirectionsStep>

一个路段数组,用于表示行程路程的每个单独路段的相关信息。

如需了解详情,请参阅 DirectionsStep。

traffic_speed_entry

可选 Array<DirectionsTrafficSpeedEntry>

有关路段车速的信息。

如需了解详情,请参阅 DirectionsTrafficSpeedEntry。

required Array<DirectionsViaWaypoint>

此路段沿途的经停航点的位置。

如需了解详情,请参阅 DirectionsViaWaypoint。

可选 TimeZoneTextValueObject

包含这段路程的预计到达时间。系统只针对公共交通路线返回该属性。

如需了解详情,请参阅 TimeZoneTextValueObject。

可选 TimeZoneTextValueObject

包含这段路程的预计出发时间,以 Time 对象的形式指定。departure_time 仅适用于公共交通路线。

如需了解详情,请参阅 TimeZoneTextValueObject。

可选 TextValueObject

此路程覆盖的总距离。

如需了解详情,请参阅 TextValueObject。

可选 TextValueObject

此路程的总持续时间。

如需了解详情,请参阅 TextValueObject。

可选 TextValueObject

表示这段路程所需的总时长。此值是根据当前和历史路况信息估算的交通时间。请参阅 traffic_model 请求参数,了解可用于请求返回值为乐观、悲观或最佳猜测估计值的选项。只有在满足以下所有条件时,系统才会返回路况中的时长:

  • 请求不包含停靠航点。如果请求包含航点,则必须为这些航点添加 via: 前缀,以避免停靠。
  • 请求专门用于行车路线,即 mode 参数设置为 driving。
  • 请求包含 departure_time 参数。
  • 所请求路线的路况信息可用。

如需了解详情,请参阅 TextValueObject。

DirectionsStep

steps 数组中的每个元素都定义了计算出的路线中的一个路段。路段是路线的最小单位,其中包含用于描述行程中某条具体指示的单个路段。例如“在西四街左转”。该路段不仅可用于描述指示,同时也包含与该路段和下一路段之间关系有关的距离和时长信息。例如,一个以“并入 80 号公路西段”表示的路段可能包含距离“37 英里”和时长“40 分钟”这些信息,指示从此路段到下一路段还有 37 英里/需要 40 分钟。

使用 Directions API 搜索公共交通路线时,路段数组会包含其他公交详细信息(以 transit_details 数组的形式)。如果路线包括多种交通方式,系统会在内部路段数组中提供步行或行车路段的详细路线。例如,步行路段将包含从起始位置到终点位置的路线:“步行至 Innes Ave & Fitch St”。该路段会在内部路段数组中提供该路线的详细步行路线,例如:“朝西北方向走”“左转进入 Arelious Walker”和“左转进入 Innes Ave”。

字段 必填 类型 说明
required TextValueObject

包含走完此路段到达下一路段通常所需的时间。如果时长未知,那么此字段可能未定义。

如需了解详情,请参阅 TextValueObject。

required LatLngLiteral

包含此路段最后一个点的位置。

如需了解详情,请参阅 LatLngLiteral。

required 字符串

包含此路段的格式化指示,以 HTML 文本字符串的形式呈现。此内容应按原样读取。请勿以程序化方式解析此仅供显示的内容。

required DirectionsPolyline

包含一个 points 对象,用于保存路段的编码多段线表示法。此多段线是路段的近似(平滑)路径。

如需了解详情,请参阅 DirectionsPolyline。

required LatLngLiteral

包含此路段出发地的位置。

如需了解详情,请参阅 LatLngLiteral。

required TravelMode

包含所用出行方式的类型。

如需了解详情,请参阅 TravelMode。

可选 TextValueObject

包含该路段与下一路段之间的距离。如果距离未知,那么此字段可能未定义。

如需了解详情,请参阅 TextValueObject。

可选 字符串

包含当前步骤要执行的操作(左转、并道、直行等)。 这些值可能会发生变化,并且我们可能会在未事先通知您的情况下引入新值。

The allowed values include: turn-slight-left, turn-sharp-left, turn-left, turn-slight-right, turn-sharp-right, keep-right, keep-left, uturn-left, uturn-right, turn-right, straight, ramp-left, ramp-right, merge, fork-left, fork-right, ferry, ferry-train, roundabout-left, and roundabout-right
可选

包含公共交通路线中步行或行车路段的详细路线。仅当 travel_mode 设置为“transit”时,子路段才可用。内部 steps 数组与 steps 的类型相同。

可选 DirectionsTransitDetails

如果出行方式为 transit,则为与此路段相关的详细信息。

如需了解详情,请参阅 DirectionsTransitDetails。

TextValueObject

一个包含数值及其格式化文本表示形式的对象。

字段 必填 类型 说明
required 字符串

字符串值。

required 数值

数值。

DirectionsPolyline

多段线编码是一种有损压缩算法,可让您将一系列坐标存储为单个字符串。点坐标使用有符号值进行编码。如果您只有几个静态点,可能还需要使用交互式多段线编码实用程序。

编码过程使用熟悉的 base64 编码方案将二进制值转换为一系列 ASCII 字符的代码:为确保这些字符正确显示,编码值会先与 63(ASCII 字符“?”)相加,然后再转换为 ASCII。该算法还会通过检查每个字节组的最低有效位来检查给定点的其他字符代码;如果此位设置为 1,则该点尚未完全形成,后面必须有其他数据。

此外,为了节省空间,点仅包含与上一个点的偏移量(当然,第一个点除外)。所有点都以 Base64 编码为有符号整数,因为纬度和经度是有符号值。多段线内的编码格式需要以合理的精度表示纬度和经度这两个坐标。假设最大经度为 +/- 180 度,精确到小数点后 5 位(180.00000 到 -180.00000),则需要一个 32 位有符号二进制整数值。

字段 必填 类型 说明
required 字符串

多段线的单个字符串表示法。

TravelMode

  • DRIVING(默认)表示使用道路网进行计算。
  • BICYCLING - 用于请求计算经由自行车道和首选街道(如有)的骑车路线。
  • TRANSIT - 用于请求使用公交路线(如有)进行计算。
  • WALKING - 用于请求计算经由步道和人行道(如有)的步行路线。

DirectionsTransitDetails

与其他交通方式无关的额外信息。

字段 必填 类型 说明
可选 DirectionsTransitStop

到达站。

如需了解详情,请参阅 DirectionsTransitStop。

可选 TimeZoneTextValueObject 如需了解详情,请参阅 TimeZoneTextValueObject。
可选 DirectionsTransitStop

出发公交站点。

如需了解详情,请参阅 DirectionsTransitStop。

可选 TimeZoneTextValueObject 如需了解详情,请参阅 TimeZoneTextValueObject。
可选 字符串

指定该线路的行进方向,如车辆或出发站所标示的方向。(通常为终点站)。

可选 integer

指定目前同一车站各次发车的预计间隔秒数。例如,headway 值为 600 时,如果您错过了一班公交,那么预计需要 10 分钟才能等到下一班。

可选 DirectionsTransitLine

包含该路段中所用公交线路的相关信息。

如需了解详情,请参阅 DirectionsTransitLine。

可选 integer

从出发站到到达站的经停点数量。该属性包含到达站,但不含出发站。例如,如果您的路线是从 A 站出发,途经 B 站和 C 站,最终到达 D 站,那么 num_stops 会返回 3。

可选 字符串

在时刻表和标牌中显示的文本,用于向乘客标识公交行程。该文本应唯一标识服务日内的行程。例如,“538”是 Amtrak 列车的 trip_short_name,该列车在工作日 15:10 从加利福尼亚州圣何塞出发,前往加利福尼亚州萨克拉门托。

DirectionsTransitStop

字段 必填 类型 说明
required LatLngLiteral

停靠点的位置。

如需了解详情,请参阅 LatLngLiteral。

required 字符串

公交经停点的名称。

TimeZoneTextValueObject

一个包含 Unix 纪元时间、时区及其格式化文本表示形式的对象。

字段 必填 类型 说明
required 字符串

以字符串形式指定的时区时间。

required 字符串

包含时区。该属性的值是时区的名称(如 IANA 时区数据库中所定义),例如“America/New_York”。

required 数值

以 Unix 纪元时间(即自世界协调时间 [UTC] 1970 年 1 月 1 日午夜以来经过的秒数)指定的时间。

DirectionsTransitLine

字段 必填 类型 说明
required Array<DirectionsTransitAgency>

运营此公共交通线路的公共交通公司。

如需了解详情,请参阅 DirectionsTransitAgency。

required 字符串

该公交线路的全名,例如“8 Avenue Local”。

可选 字符串

该线路站牌常用的颜色。

可选 字符串

包含与该线路相关联的图标的网址。

可选 字符串

该公交线路的简称。这通常是线路编号,例如“M7”或“355”。

可选 字符串

该线路站牌常用的颜色。

可选 字符串

包含该公共交通线路的网址(由公共交通公司提供)。

可选 DirectionsTransitVehicle

此公交线路上的交通工具类型。

如需了解详情,请参阅 DirectionsTransitVehicle。

DirectionsTransitAgency

字段 必填 类型 说明
可选 字符串

此公共交通公司的名称。

可选 字符串

公共交通公司的电话号码。

可选 字符串

公共交通公司的网址。

DirectionsTransitVehicle

字段 必填 类型 说明
required 字符串

此交通工具的名称,首字母大写。

required 字符串

所用车辆的类型。

  • BUS - 公交车。
  • CABLE_CAR - 一种靠电缆运行的交通工具,通常在地面上行驶。 空中缆车可以算作 GONDOLA_LIFT 类型。
  • COMMUTER_TRAIN - 通勤铁路。
  • FERRY - 轮渡。
  • FUNICULAR - 一种由缆线拉上陡坡的交通工具。索道缆车通常由两个车体组成,彼此作为对方的平衡重物。
  • GONDOLA_LIFT - 空中缆车。
  • HEAVY_RAIL - 重型铁路。
  • HIGH_SPEED_TRAIN - 高速列车。
  • INTERCITY_BUS - 长途客车。
  • LONG_DISTANCE_TRAIN - 长途列车。
  • METRO_RAIL - 轻轨交通。
  • MONORAIL - Monorail。
  • OTHER - 所有其他交通工具都将返回此类型。
  • RAIL - 铁路。
  • SHARE_TAXI - 共享出租车是一种公交车,可供乘客在其路线中的任意位置上下车。
  • SUBWAY - 地下轻轨。
  • TRAM - 地上轻轨。
  • TROLLEYBUS - 无轨电车。
The allowed values include: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, and TROLLEYBUS
可选 字符串

包含与该交通工具类型相关联的图标的网址。

可选 字符串

包含与该交通工具类型相关联的图标的网址(取决于当地交通标志)。

DirectionsTrafficSpeedEntry

字段 必填 类型 说明
required 数值

此速度类别有效的沿路径偏移量(以米为单位)。

required 字符串

此路段的当前路况/车速。

DirectionsViaWaypoint

字段 必填 类型 说明
可选 LatLngLiteral

航点的位置。

如需了解详情,请参阅 LatLngLiteral。

可选 integer

包含航点的路段的索引。

可选 数值

航点沿路段多段线的位置,以 0 到 1 的比率表示。

Fare

路线的总交通费用。

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
字段 必填 类型 说明
required 字符串

ISO 4217 货币代码,表示金额所采用的货币。

required 字符串

总票价金额,设置为所请求语言的格式

required 数值

总票价(以指定货币为单位)。

DirectionsStatus

Directions 响应对象中的 status 字段包含请求的状态,可能还包含调试信息,以帮助您跟踪 Directions 服务失败的原因。状态字段可能包含以下值:

  • OK 表示响应中包含有效结果。
  • NOT_FOUND 表示在请求的出发地、目的地或航点中,有至少一个指定的位置无法进行地理编码处理。
  • ZERO_RESULTS 表示在出发地和目的地之间找不到路线。
  • MAX_WAYPOINTS_EXCEEDED 表示请求中提供的航点过多。对于将 Directions API 用作网络服务或使用 Maps JavaScript API 中的路线服务的应用,所允许的航点数上限为 25 个,再加上出发地和目的地。
  • MAX_ROUTE_LENGTH_EXCEEDED 表示所请求的路线过长,无法进行处理。当系统返回更复杂的路线时,就会发生此错误。不妨尝试减少航点、转弯或指示的数量。
  • INVALID_REQUEST 表示提供的请求无效。导致此状态的常见原因包括参数或参数值无效。
  • OVER_DAILY_LIMIT 表示以下任一情况:
    • API 密钥缺失或无效。
    • 您的账号尚未启用结算功能。
    • 超出了您设定的用量上限。
    • 提供的付款方式不再有效(例如,信用卡已过期)。
    请参阅地图常见问题解答,了解如何解决此问题。
  • OVER_QUERY_LIMIT 表示服务在允许的时间段内收到了来自您应用的过多请求。
  • REQUEST_DENIED 表示服务拒绝您的应用使用路线服务。
  • UNKNOWN_ERROR 表示因服务器错误而无法处理路线请求。如果您重试一次,请求可能会成功。

DirectionsGeocodedWaypoint

字段 必填 类型 说明
可选 字符串

表示地理编码操作生成的状态代码。此字段可能包含以下值。

The allowed values include: OK, and ZERO_RESULTS
可选

表示地理编码器无法返回与原始请求完全匹配的结果,尽管它能够匹配所请求地址的一部分内容。建议您检查一下原始请求中是否存在拼写错误和/或地址不完整的情况。

部分匹配的最常见原因是请求中所传递的市行政区内不存在相关街道地址。当请求与同一市行政区中的两个或更多位置相匹配时,也可能会返回部分匹配。例如,无论是 Henry Street 还是 Henrietta Street,“21 Henr St, Bristol, UK”都会返回部分匹配。请注意,如果请求中包含拼写错误的地址组成部分,地理编码服务可能会推荐备选地址。通过这种方式触发的建议也将标记为部分匹配。

可选 字符串

可以与其他 Google API 搭配使用的唯一标识符。请参阅地点 ID 概览。

可选 Array<string>

指明用于计算路线的地理编码结果的地址类型。

  • administrative_area_level_1 表示国家/地区级别以下的一级行政实体。在美国,这类行政级别是指州。 并不是所有国家都设有这类行政级别。在大多数情况下,administrative_area_level_1 简称可高度匹配 ISO 3166-2 行政区划以及其他广为传播的列表;不过,我们无法对此做出保证,因为我们的地理编码结果基于各种信号和位置数据。
  • administrative_area_level_2 表示国家/地区级别以下的二级行政实体。在美国,这类行政级别是指县。 并不是所有国家都设有这类行政级别。
  • administrative_area_level_3 表示国家/地区级别以下的三级行政实体。此类型表示较小的行政区划单位。并不是所有国家都设有这类行政级别。
  • administrative_area_level_4 表示国家/地区级别以下的四级行政实体。此类型表示较小的行政区划单位。并不是所有国家都设有这类行政级别。
  • administrative_area_level_5 表示国家/地区级别以下的五级行政实体。此类型表示较小的行政区划单位。并不是所有国家都设有这类行政级别。
  • airport 表示机场。
  • colloquial_area 表示实体的常用替代名称。
  • country 表示国家政治实体,通常列在地理编码器所返回结果的最前面。
  • intersection 表示主要交叉路口,通常是两条主要道路的交叉路口。
  • locality 表示有建制的城市或城镇政治实体。
  • natural_feature 表示某个明显的自然地貌。
  • neighborhood 表示已命名的街区。
  • park 表示已命名的公园。
  • plus_code 表示经过编码的位置引用,衍生自纬度和经度。Plus Code 可用于在没有街道地址的地点(例如建筑物未编号,或者街道未命名)取代街道地址。 如需了解详情,请参阅 https://plus.codes。
  • point_of_interest 表示已命名的地图注点。通常情况下,这些“地图注点”是当地的著名实体,无法轻易归入其他类别,例如“帝国大厦”或“埃菲尔铁塔”。
  • political 表示政治实体。这种类型通常表示某些行政管理区的多边形区域。
  • postal_code 表示国家/地区内邮寄地址所用的邮政编码。
  • premise 表示已命名的位置,通常是具有常见名称的建筑或建筑群
  • route 表示已命名的路线(例如“US 101”)。
  • street_address 表示精确的街道地址。
  • sublocality 表示市行政区以下的一级行政实体。对于某些位置,可能会收到以下任一类型:sublocality_level_1 到 sublocality_level_5。每个子级市行政区级别都是一个行政实体。数字越大表示地理区域越小。
  • subpremise 表示已命名位置以下的一级实体,通常是具有共同名称的建筑群中的单个建筑物
  • tourist_attraction 表示旅游景点。
  • train_station 表示火车站。
  • transit_station 表示公共交通站点。

空的类型列表表示特定地址组成部分没有对应的已知类型,例如法国的地点 (Lieu-dit)。