此产品处于旧版状态。自 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 <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b></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 <b>right</b> at the 1st cross street onto <b>W Van Buren St</b></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。 |
|
可选 | 字符串 |
当服务返回 |
|
可选 | Array<DirectionsGeocodedWaypoint> |
包含一个数组,其中包含有关出发地、目的地和航点的地理编码的详细信息。 geocoded_waypoints 数组中的元素按其从零开始的位置,分别对应于出发地、按指定顺序排列的航点以及目的地。 如果服务未返回任何结果,则对于指定为文本纬度/经度值的航点,这些详细信息将不会显示。这是因为,只有在找到路线后,系统才会对这些航点进行反向地理编码,以获取其代表性地址。空 JSON 对象将占据 geocoded_waypoints 数组中的相应位置。 如需了解详情,请参阅 DirectionsGeocodedWaypoint。 |
DirectionsRoute
路由由嵌套的 legs 和 steps 组成。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
|
required | 边界 |
包含 如需了解详情,请参阅边界。 |
|
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 | 字符串 |
包含通过对这段路程的 |
|
required | LatLngLiteral |
此路段指定目的地的纬度/经度坐标。由于 Directions API 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线,因此 如需了解详情,请参阅 LatLngLiteral。 |
|
required | 字符串 |
包含对这段路程的 |
|
required | LatLngLiteral |
这段路程出发地的纬度/经度坐标。由于 Directions API 根据距离起点和终点最近的交通方式(通常为道路)来计算不同位置之间的路线,因此 如需了解详情,请参阅 LatLngLiteral。 |
|
required | Array<DirectionsStep> |
一个路段数组,用于表示行程路程的每个单独路段的相关信息。 如需了解详情,请参阅 DirectionsStep。 |
|
可选 | Array<DirectionsTrafficSpeedEntry> |
有关路段车速的信息。 如需了解详情,请参阅 DirectionsTrafficSpeedEntry。 |
|
required | Array<DirectionsViaWaypoint> |
此路段沿途的经停航点的位置。 如需了解详情,请参阅 DirectionsViaWaypoint。 |
|
可选 | TimeZoneTextValueObject |
包含这段路程的预计到达时间。系统只针对公共交通路线返回该属性。 如需了解详情,请参阅 TimeZoneTextValueObject。 |
|
可选 | TimeZoneTextValueObject |
包含这段路程的预计出发时间,以 Time 对象的形式指定。 如需了解详情,请参阅 TimeZoneTextValueObject。 |
|
可选 | TextValueObject |
此路程覆盖的总距离。 如需了解详情,请参阅 TextValueObject。 |
|
可选 | TextValueObject |
此路程的总持续时间。 如需了解详情,请参阅 TextValueObject。 |
|
可选 | TextValueObject |
表示这段路程所需的总时长。此值是根据当前和历史路况信息估算的交通时间。请参阅
如需了解详情,请参阅 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 |
如果出行方式为 如需了解详情,请参阅 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 |
指定目前同一车站各次发车的预计间隔秒数。例如, |
|
可选 | DirectionsTransitLine |
包含该路段中所用公交线路的相关信息。 如需了解详情,请参阅 DirectionsTransitLine。 |
|
可选 | integer |
从出发站到到达站的经停点数量。该属性包含到达站,但不含出发站。例如,如果您的路线是从 A 站出发,途经 B 站和 C 站,最终到达 D 站,那么 |
|
可选 | 字符串 |
在时刻表和标牌中显示的文本,用于向乘客标识公交行程。该文本应唯一标识服务日内的行程。例如,“538”是 Amtrak 列车的 |
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 | 字符串 |
所用车辆的类型。
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> |
指明用于计算路线的地理编码结果的地址类型。
空的类型列表表示特定地址组成部分没有对应的已知类型,例如法国的地点 (Lieu-dit)。 |