此商品处于旧版状态。自 2026 年 10 月起，无法再为新的 Google Cloud 项目启用 Distance Matrix API（旧版）。现有项目仍完全受支持。如需使用新功能并提升性能，请迁移到 Routes API。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Distance Matrix API（旧版）请求和响应

欧洲经济区 (EEA) 开发者

简介

Distance Matrix API（旧版）请求采用以下形式：

https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters

其中 outputFormat 可以是以下任一值：

json（推荐）表示以 JavaScript 对象表示法 (JSON) 格式输出。
xml 表示输出为 XML。

某些参数是必需参数，其他则是可选参数。依照网址的标准，所有参数都使用“与”符号 (&) 分隔。所有保留字符（例如加号“+”）都必须经过网址编码。下面列出了参数及其可能的值。

必需参数

目标账号

一个或多个用作计算行程距离和时间的终点的位置。目的地参数的选项与来源参数的选项相同。
origins

计算行程距离和用时的起点。您可以提供一个或多个位置（以竖线字符 [|] 分隔），格式可以是地点 ID、地址或纬度/经度坐标：
- 地点 ID：如果您提供地点 ID，则必须为其添加前缀 place_id:。
- 地址：如果您传递地址，该服务会对字符串进行地理编码，并将其转换为纬度/经度坐标，以计算距离。此坐标可能与 Geocoding API 返回的坐标不同，例如，它可能是建筑物入口，而不是建筑物中心。
  注意：最好使用地点 ID，而不是地址或纬度/经度坐标。使用坐标始终会导致点被吸附到最靠近这些坐标的道路，而该道路可能不是房产的入口点，甚至不是能够快速或安全到达目的地的道路。使用地址将提供到建筑物中心的距离，而不是到建筑物入口的距离。
- 坐标：如果您传递纬度/经度坐标，它们将吸附到最近的道路。最好传递地点 ID。如果您确实传递了坐标，请确保纬度值和经度值之间没有空格。
- Plus Code 的格式必须为全局代码或混合代码。按如下格式设置 Plus Codes（加号经网址转义为 %2B，空格经网址转义为 %20）：
  - 全局代码是包含 4 个字符的区号和至少包含 6 个字符的区域代码（849VCWC8+R9 编码为 849VCWC8%2BR9）。
  - 混合代码是至少包含 6 个字符的区域代码，具有明确的位置信息（CWC8+R9 Mountain View, CA, USA 编码为 CWC8%2BR9%20Mountain%20View%20CA%20USA）。
- 编码多段线：或者，您也可以使用编码多段线算法提供一组经过编码的坐标。如果您有大量起点，此功能会特别有用，因为使用编码多段线时，网址会明显缩短。
  - 经过编码的多段线必须以 enc: 为前缀，后跟英文冒号 :。例如： origins=enc:gfo}EtohhU:
  - 您还可以添加多条编码多段线，并用竖线字符 | 分隔。例如：
```
origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
```

可选参数

arrival_time

指定公共交通路线的首选到达时间，以自世界协调时间 (UTC) 1970 年 1 月 1 日午夜起的秒数表示。您可以指定 departure_time 或 arrival_time，但不能同时指定这两者。请注意，arrival_time 必须指定为整数。
避免

计算距离时可能会遵循某些限制。限制通过使用 avoid 参数以及该参数的参数值（指示要避开的限制）来指示。支持以下限制：
- tolls 表示计算出的路线应避开收费路段/桥梁。
- highways 表示计算出的路线应避开高速公路。
- ferries 表示计算出的路线应避开轮渡。
- indoor 表示计算出的路线应避免在步行和公共交通路线中出现室内台阶。
通过将两个限制条件都传递给 avoid 参数，可以请求避开收费站、高速公路和轮渡的任意组合的路线。例如 avoid=tolls|highways|ferries。

注意：添加限制条件并不会排除包含受限特征的路线，而是会使结果偏向于更合适的路线。
departure_time

指定首选出发时间。您可以将时间指定为自世界协调时间 (UTC) 1970 年 1 月 1 日午夜起经过的秒数（整数）。如果指定的 departure_time 晚于 9999-12-31T23:59:59.999999999Z，则 API 会将 departure_time 回退到 9999-12-31T23:59:59.999999999Z。或者，您也可以指定 now 值，将出发时间设置为当前时间（精确到最接近的秒）。在以下两种情况下，可以指定出发时间：
- 对于出行方式为公交的请求：您可以视需要指定 departure_time 或 arrival_time。如果未指定任何时间，则 departure_time 默认为当前时间（即出发时间默认为当前时间）。
- 对于出行方式为驾车的请求：您可以指定 departure_time，以接收考虑了路况信息的路线和行程时长（响应字段：duration_in_traffic）。departure_time 必须设置为当前时间或未来的某个时间，但不能是过去的时间。
注意：如果未指定出发时间，则系统会根据道路网和与时间无关的平均路况信息来选择路线和时长。受道路网变化、平均路况信息更新以及服务的分布式性质的影响，给定请求的结果可能会随时间的推移而发生变化。此外，在时间或频率不受限制的情况下，即使两条路线几乎相同，结果还是有可能不同。

注意：如果距离矩阵请求在 mode=driving 时指定 departure_time，则每个请求最多只能包含 100 个元素。出发地数量与目的地数量的乘积便是元素数量。
language

返回结果时所用的语言。
- 请参阅支持的语言列表。Google 会经常更新支持的语言，因此该列表可能并非详尽无遗。
- 如果未提供 language，API 会尝试使用 Accept-Language 标头中指定的首选语言。
- 该 API 会尽力提供用户和当地人都能看懂的街道地址。为实现此目标，它会返回本地语言的街道地址，并在必要时将其音译为用户可读的文字，同时遵循首选语言。所有其他地址均以首选语言返回。地址组成部分均以同一种语言返回，该语言是从第一个组成部分中选择的。
- 如果首选语言中没有名称，API 会使用最接近的匹配项。
- 首选语言对 API 选择返回的结果集以及返回顺序有轻微影响。地理编码器会根据语言以不同的方式解读缩写，例如街道类型的缩写，或在一种语言中有效但在另一种语言中无效的同义词。例如，utca 和 tér 在匈牙利语中是“街道”的同义词。
模式

在计算距离和路线时，您可以指定要使用的交通方式。默认情况下，系统会使用 DRIVING 模式。默认情况下，系统会计算行车路线。支持以下出行方式：
- driving（默认）表示使用道路网的标准行车路线或距离。
- walking - 用于请求经由步道和人行道（如有）的步行路线或距离。
- bicycling - 用于请求经由自行车道和首选街道（如有）的骑车路线或距离。
- transit - 用于请求经由公交路线（如有）的路线或距离。如果您将出行方式设置为公交，则可以选择指定 departure_time 或 arrival_time。如果未指定任何时间，则 departure_time 默认为当前时间（即出发时间默认为当前时间）。您还可以选择添加 transit_mode 和/或 transit_routing_preference。
注意：步行和骑车路线有时可能不包含畅通无阻的步道或自行车道，因此这些路线会在返回的结果中返回警告，您必须向用户显示这些警告。

注意：公交行程最多可查询过去 7 天或未来 100 天的信息，具体取决于数据提供商提供的公交信息的可用性。公交时刻表经常发生变化，可用的公交行程可能会随时间而变化，因此无法保证为提前很久的预测提供一致的结果。
区域

地区代码，指定为 ccTLD（“顶级域名”）双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同，但也有一些需要注意的例外情况。例如，英国的 ccTLD 为“uk”(.co.uk)，而其 ISO 3166-1 代码为“gb”（代表“大不列颠及北爱尔兰联合王国”）。
traffic_model

指定计算交通时间时要使用的假设条件。此设置会影响响应中返回到 duration_in_traffic 字段的值，该值包含根据历史平均数据预测的交通时间。traffic_model 参数只能在请求包含 departure_time 的行车路线中指定。此参数的可用值如下：
- best_guess（默认）- 表示返回的 duration_in_traffic 应该是最准确的行程时间估算值（根据已知的历史路况信息和实时路况信息得出）。departure_time 越接近当前时间，实时路况信息就越重要。
- pessimistic 表示返回的 duration_in_traffic 在大多数日子里应该长于实际行程时间，但偶尔路况信息特别糟糕的时候，实际行程时间可能会超过该值。
- optimistic 表示返回的 duration_in_traffic 在大多数日子里应该短于实际行程时间，但偶尔路况信息特别理想的时候，实际行程时间可能会小于该值。
对于绝大多数用例，默认值 best_guess 将提供最实用的预测。由于 best_guess 预测模型整合实时路况信息的方式，best_guess 行程时间预测可能比 optimistic 短，也可能比 pessimistic 长。
transit_mode

指定一种或多种首选公共交通方式。此参数只能为公共交通路线指定。该参数支持以下实参：
- bus 表示计算出的路线应首选公交出行。
- subway 表示计算出的路线应首选地铁出行。
- train 表示计算出的路线应首选火车出行。
- tram 表示计算出的路线应首选有轨电车和轻轨出行。
- rail 表示计算出的路线应首选火车、有轨电车、轻轨和地铁出行。这相当于 transit_mode=train|tram|subway。
transit_routing_preference

指定公交路线的偏好设置。利用此参数，您可以自定义调整所返回的选项，而不是接受 API 选择的默认最佳路线。此参数只能为公交路线指定。该参数支持以下实参：
- less_walking 表示计算出的路线应首选步行距离较短的路线。
- fewer_transfers 表示计算出的路线应首选换乘次数较少的路线。
个单元

指定显示结果时要使用的单位制。

请注意：此单位制设置仅影响距离字段中显示的文本。距离字段也包含始终以米为单位的值。

请求示例

此示例使用纬度/经度坐标来指定目的地坐标：

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY'

以下示例使用 Plus Code 指定目的地坐标：

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco
  &origins=849VCWC8%2BR9
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=849VCWC8%2BR9&destinations=San%20Francisco&key=YOUR_API_KEY'

以下示例展示了使用经过编码的多段线的相同请求：

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A&key=YOUR_API_KEY'

路况信息

在满足以下所有条件（在距离矩阵响应中收到 duration_in_traffic 字段的必要条件）时会使用路况信息：

出行方式 mode 参数为 driving 或未指定（driving 为默认出行方式）。
请求包含有效的 departure_time 参数。departure_time 可设置为当前时间或未来的某个时间，而不能是过去的时间。

（可选）您可以在请求中添加 traffic_model 参数，以指定在计算交通时间时要使用的假设。

以下网址会发起距离矩阵请求，以获取马萨诸塞州波士顿或马萨诸塞州查尔斯顿与马萨诸塞州列克星敦和马萨诸塞州康科德之间的驾车距离。该请求包含出发时间，满足在距离矩阵响应中返回 duration_in_traffic 字段的所有要求。

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?departure_time=now
  &destinations=Lexington%2CMA%7CConcord%2CMA
  &origins=Boston%2CMA%7CCharlestown%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Boston%2CMA%7CCharlestown%2CMA&destinations=Lexington%2CMA%7CConcord%2CMA&departure_time=now&key=YOUR_API_KEY'

JSON

{
  "destination_addresses": ["Lexington, MA, USA", "Concord, MA, USA"],
  "origin_addresses": ["Boston, MA, USA", "Charlestown, Boston, MA, USA"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "33.3 km", "value": 33253 },
              "duration": { "text": "27 mins", "value": 1620 },
              "duration_in_traffic": { "text": "34 mins", "value": 2019 },
              "status": "OK",
            },
            {
              "distance": { "text": "41.5 km", "value": 41491 },
              "duration": { "text": "33 mins", "value": 1981 },
              "duration_in_traffic": { "text": "39 mins", "value": 2342 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "31.1 km", "value": 31100 },
              "duration": { "text": "26 mins", "value": 1543 },
              "duration_in_traffic": { "text": "29 mins", "value": 1754 },
              "status": "OK",
            },
            {
              "distance": { "text": "39.3 km", "value": 39338 },
              "duration": { "text": "32 mins", "value": 1904 },
              "duration_in_traffic": { "text": "35 mins", "value": 2077 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

XML


 OK
 Boston, MA, USA
 Charlestown, Boston, MA, USA
 Lexington, MA, USA
 Concord, MA, USA
 
  
   OK
   
    1620
    27 mins
   
   
    33253
    33.3 km
   
   
    2018
    34 mins
   
  
  
   OK
   
    1981
    33 mins
   
   
    41491
    41.5 km
   
   
    2342
    39 mins
   
  
 
 
  
   OK
   
    1543
    26 mins
   
   
    31100
    31.1 km
   
   
    1759
    29 mins
   
  
  
   OK
   
    1904
    32 mins
   
   
    39338
    39.3 km
   
   
    2077
    35 mins

地理位置修饰符

您可以使用位置修饰符来指引司机应如何抵达特定位置，方法是使用 side_of_road 修饰符指定应使用道路的哪一侧，或指定航向以指明正确的行驶方向。

指定计算出的路线必须经过道路的特定一侧

指定位置时，您可以使用 side_of_road: 前缀，请求计算出的路线经过航点偏向的道路一侧。例如，此请求将返回长路线的距离，以便车辆在航点偏向的道路一侧结束：

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3A37.7663444%2C-122.4412006
  &origins=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=37.7680296%2C-122.4375126&destinations=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

将 side_of_road: 与经过编码的多段线搭配使用时，修饰符会应用于多段线上的每个位置。例如，此请求中的两个目标位置都使用该参数：

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A
  &origins=San%20Francisco%20City%20hall
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=San%20Francisco%20City%20hall&destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A&key=YOUR_API_KEY'

side_of_road: 修饰符只能与以下限制搭配使用：

出行mode 参数为 driving 或未指定（driving 为默认出行方式）。

指定计算出的路线应具有特定朝向

指定位置时，您可以请求计算出的路线以特定方向角穿过该位置。此航向使用前缀 heading=X: 指定，其中 X 是介于 0（含）到 360（不含）之间的整数度数值。朝向 0 表示正北，90 表示正东，依此类推（顺时针）。例如，在此请求中，计算出的路线从起点向东行驶，然后掉头：

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=37.773245%2C-122.469502
  &origins=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=heading%3D90%3A37.773279%2C-122.468780&destinations=37.773245%2C-122.469502&key=YOUR_API_KEY'

heading=X: 修饰符只能在满足以下限制条件的情况下使用：

出行mode 参数为 driving、bicycling 或未指定（driving 为默认出行方式）。
未为同一位置指定 side_of_road 修饰符。
位置通过纬度/经度值指定。您不得将 heading 与地址、地点 ID 或编码的多段线搭配使用。

距离矩阵请求和响应

以下示例 HTTP 请求用于请求从加拿大不列颠哥伦比亚省温哥华和美国华盛顿州西雅图到美国加利福尼亚州旧金山和加拿大不列颠哥伦比亚省维多利亚的距离和时长。

网址

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco%7CVictoria%20BC
  &language=fr-FR
  &mode=bicycling
  &origins=Vancouver%20BC%7CSeattle
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver%20BC%7CSeattle&destinations=San%20Francisco%7CVictoria%20BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY'

此请求将返回四个元素 - 两个起点乘以两个目的地：

温哥华至旧金山	温哥华至维多利亚
西雅图至旧金山	西雅图至维多利亚

结果以行形式返回，每行包含一个出发地与每个目的地的配对。

JSON

{
  "destination_addresses":
    ["San Francisco, Californie, États-Unis", "Victoria, BC, Canada"],
  "origin_addresses":
    ["Vancouver, BC, Canada", "Seattle, Washington, États-Unis"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "1 712 km", "value": 1711765 },
              "duration": { "text": "3 jours 16 heures", "value": 318119 },
              "status": "OK",
            },
            {
              "distance": { "text": "140 km", "value": 139695 },
              "duration": { "text": "6 heures 49 minutes", "value": 24567 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "1 452 km", "value": 1451704 },
              "duration": { "text": "3 jours 2 heures", "value": 266680 },
              "status": "OK",
            },
            {
              "distance": { "text": "146 km", "value": 146500 },
              "duration": { "text": "2 heures 53 minutes", "value": 10374 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

XML


 OK
 Vancouver, BC, Canada
 Seattle, Washington, États-Unis
 San Francisco, Californie, États-Unis
 Victoria, BC, Canada
 
  
   OK
   
    318119
    3 jours 16 heures
   
   
    1711765
    1 712 km
   
  
  
   OK
   
    24567
    6 heures 49 minutes
   
   
    139695
    140 km
   
  
 
 
  
   OK
   
    266680
    3 jours 2 heures
   
   
    1451704
    1 452 km
   
  
  
   OK
   
    10374
    2 heures 53 minutes
   
   
    146500
    146 km

DistanceMatrixResponse

字段	必填	类型	说明
`destination_addresses`	required	Array<string>	API 根据您的原始请求返回的地址数组。与 `origin_addresses` 一样，这些内容也会在适当情况下进行本地化。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。
`origin_addresses`	required	Array<string>	API 根据您的原始请求返回的地址数组。这些地址由地理编码器设置格式，并根据随请求传递的语言参数进行本地化。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。
`rows`	required	Array<DistanceMatrixRow>	一个元素数组，其中每个元素又包含一个 `status`、`duration` 和 `distance` 元素。如需了解详情，请参阅 DistanceMatrixRow。
`status`	required	DistanceMatrixStatus	包含请求的状态，可能还包含调试信息，以帮助您跟踪请求失败的原因。如需了解详情，请参阅 DistanceMatrixStatus。
`error_message`	可选	字符串	一个字符串，其中包含处理请求时遇到的任何错误的人类可读文本。

DistanceMatrixStatus

服务返回的状态代码。

OK 表示响应中包含有效结果。
INVALID_REQUEST 表示提供的请求无效。
MAX_ELEMENTS_EXCEEDED 表示出发地和目的地的乘积超出了每次查询的限制。
MAX_DIMENSIONS_EXCEEDED 表示出发地或目的地的数量超出了每次查询的限制。
OVER_DAILY_LIMIT 表示以下任一情况：
- API 密钥缺失或无效。
- 您的账号尚未启用结算功能。
- 超出了您设定的用量上限。
- 提供的付款方式不再有效（例如，信用卡已过期）。
OVER_QUERY_LIMIT 表示服务在允许的时间段内收到的来自您应用的请求过多。
REQUEST_DENIED 表示服务拒绝您的应用使用距离矩阵服务。
UNKNOWN_ERROR 表示因服务器错误而无法处理距离矩阵请求。如果您重试一次，请求可能会成功。

DistanceMatrixRow

字段	必填	类型	说明
`elements`	required	Array<DistanceMatrixElement>	Distance Matrix API 返回结果时，会将结果放入 JSON rows 数组中。即使未返回任何结果（例如，当起点和/或终点不存在时），它仍会返回一个空数组。行会根据请求的 origin 参数中的值进行排序。每一行对应一个出发地，该行中的每个元素对应于出发地与目的地值的配对。每个行数组都包含一个或多个元素条目，这些条目又包含有关单个起点-终点配对的信息。如需了解详情，请参阅 DistanceMatrixElement。

DistanceMatrixElement

字段	必填	类型	说明
`status`	required	DistanceMatrixElementStatus	元素的状态。如需了解详情，请参阅 DistanceMatrixElementStatus。
`distance`	可选	TextValueObject	该路线的总距离，以文本形式表示，单位为米（值）。文本值使用原始请求的 unit 参数或出发地所在区域指定的单位制。如需了解详情，请参阅 TextValueObject。
`duration`	可选	TextValueObject	该路线所需的行程时长，以文本形式表示，单位为秒（值字段）。文本表示法会根据查询的语言参数进行本地化。如需了解详情，请参阅 TextValueObject。
`duration_in_traffic`	可选	TextValueObject	根据当前和历史路况信息，该路线所需的行程时长。请参阅 `traffic_model` 请求参数，了解可用于请求返回值为乐观、悲观或最佳猜测估计值的选项。时长以秒（值字段）和文本形式表示。文本表示会根据查询的语言参数进行本地化。只有在满足以下所有条件时，系统才会返回路况中的时长：请求包含 `departure_time` 参数。所请求路线的路况信息可用。 mode 参数设置为 driving。如需了解详情，请参阅 TextValueObject。
`fare`	可选	票价	如果存在，则包含该路线的总交通费用（即总票价）。此属性仅针对公交请求返回，并且仅适用于具有可用票价信息的公交路线提供方。如需了解详情，请参阅票价。

Fare

路线的总交通费用。

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

字段	必填	类型	说明
`currency`	required	字符串	ISO 4217 货币代码，表示金额所采用的货币。
`text`	required	字符串	总票价金额，设置为所请求语言的格式
`value`	required	数值	总票价（以指定货币为单位）。

DistanceMatrixElementStatus

OK 表示响应中包含有效结果。
NOT_FOUND 表示无法对该配对的出发地和/或目的地进行地理编码。
ZERO_RESULTS 表示在出发地和目的地之间找不到路线。
MAX_ROUTE_LENGTH_EXCEEDED 表示所请求的路线过长，无法进行处理。

TextValueObject

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

字段	必填	类型	说明
`text`	required	字符串	字符串值。
`value`	required	数值	数值。

Distance Matrix API（旧版）请求和响应 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

简介

必需参数

目标账号

origins

可选参数

arrival_time

避免

departure_time

language

模式

区域

traffic_model

transit_mode

transit_routing_preference

个单元

请求示例

网址

curl

网址

curl

网址

curl

路况信息

网址

curl

JSON

XML

地理位置修饰符

指定计算出的路线必须经过道路的特定一侧

网址

curl

网址

curl

指定计算出的路线应具有特定朝向

网址

curl

距离矩阵请求和响应

网址

curl

JSON

XML

DistanceMatrixResponse

destination_addresses

origin_addresses

rows

status

error_message

DistanceMatrixStatus

DistanceMatrixRow

elements

DistanceMatrixElement

status

distance

duration

duration_in_traffic

fare

Fare

currency

text

value

DistanceMatrixElementStatus

TextValueObject

text

value

Distance Matrix API（旧版）请求和响应

`destination_addresses`

`origin_addresses`

`rows`

`status`

`error_message`

`elements`

`status`

`distance`

`duration`

`duration_in_traffic`

`fare`

`currency`

`text`

`value`

`text`

`value`