此页面由 Cloud Translation API 翻译。

指定路由的位置

如需计算路线，您至少必须指定路线起点和路线终点的位置。您可以将这些位置定义为路线上的路点。

除了起点和终点之外，您还可以指定不同类型的路点以及如何处理路线的路点。如需了解详情和示例，请参阅以下主题：

指定路线的位置

您可以通过创建航点 (REST) 或航点 (gRPC) 对象来表示位置。在航点定义中，您可以通过以下任一方式指定位置：

地点 ID（首选）
经纬度坐标
地址字符串（“伊利诺伊州芝加哥市”或“澳大利亚新南威尔士州达尔文市”）
Plus Code

您可以通过相同的方式为请求中的所有航点指定位置，也可以混用这些航点。例如，您可以为起点路径点使用纬度/经度坐标，并为目的地路径点使用地点 ID。

为了提高效率和准确性，请使用地点 ID，而不是纬度/经度坐标或地址字符串。地点 ID 具有唯一的明确性，可为路线规划提供地理编码优势，例如接入点和交通变量。它们有助于避免因使用其他方式指定位置而导致以下情况：

使用纬度/经度坐标可能会导致相应位置被捕获到距离这些坐标最近的道路，而该道路可能不是相应房源的入口点，甚至可能不是快速或安全地通往目的地的道路。
地址字符串必须先由 Routes API 进行地理编码，将其转换为纬度/经度坐标，然后才能计算路线。此转化可能会影响效果。

将某个位置指定为地点 ID

您可以使用地点 ID 指定航点的位置。由于经纬度坐标会贴靠到道路，因此您可能会发现，在某些情况下，地点 ID 会提供更好的结果。

从 Geocoding API 和 Places API（包括地点自动补全）检索地点 ID。如需详细了解地点 ID，请参阅地点 ID 概览。

以下示例使用 placeId 属性为 origin 和 destination 传递地点 ID：

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

以经纬度坐标指定位置

如需在路径点中定义位置，请使用纬度/经度坐标指定位置 (REST) 或位置 (gRPC)。

例如，使用 latitude 和 longitude 坐标为路线 origin 和 destination 指定航点：

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

以地址字符串的形式指定位置

地址字符串是指由字符串表示的字面地址（例如“1600 Amphitheatre Parkway, Mountain View, CA”）。地理编码是将地址字符串转换为纬度和经度坐标（如纬度 37.423021 和经度 -122.083739）的过程。

当您将地址字符串作为航点的位置传递时，Routes API 会在内部对该字符串进行地理编码，以将其转换为纬度和经度坐标。

例如，如需计算路线，您可以使用地址字符串为路线 origin 和 destination 指定路径点：

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

在此示例中，Routes API 会对这两个地址进行地理编码，将其转换为经纬度坐标。

如果地址值不明确，Routes API 可能会调用搜索功能，以便与类似地址区分开来。例如，“1st Street”可以是“1st street NE”或“1st St SE”的完整值或部分值。此结果可能与 Geocoding API 返回的结果不同。您可以使用地点 ID 来避免可能的误解。

为地址设置区域

如果您将不完整的地址字符串作为路径点的位置传递，API 可能会使用错误的地理编码纬度/经度坐标。例如，您发出请求，将“托莱多”指定为驾车路线的起点，将“马德里”指定为目的地：

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

在此示例中，“托莱多”被解读为美国俄亥俄州的城市，而不是西班牙的城市。因此，请求会返回一个空数组，表示不存在路由：

{
  []
}

您可以通过添加 regionCode 参数，将该 API 配置为返回偏向特定地区的结果。此参数以 ccTLD（“顶级域名”）双字符值的形式指定地区代码。大多数 ccTLD 代码与 ISO 3166-1 代码相同，但有一些明显的例外。例如，英国的国家代码顶级域名为“uk”(.co.uk)，而其 ISO 3166-1 代码却是“gb”（专指“大不列颠及北爱尔兰联合王国”这一实体）。

包含 regionCode 参数的“托莱多”至“马德里”路线请求会返回适当的结果，因为“托莱多”会被解读为西班牙的城市：

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

响应现在包含从西班牙托莱多到西班牙马德里的计算路线：

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

将某个位置指定为 Plus Code

许多人没有确切的地址，这可能会导致他们难以收到送货。或者，有地址的客户可能更希望在更具体的地点（例如后门或装卸区）接收包裹。

Plus Code 就像没有实际地址的人员或地点的街道地址。Plus Code 基于经纬度坐标，以数字和字母的形式显示，而不是包含街道名称和门牌号的地址。

Google 开发了 Plus Code，让所有人和所有事物都能获享地址带来的好处。Plus Code 是一种经过编码的位置引用，衍生自纬度/经度坐标，表示一个区域：1/8000 度 x 1/8000 度（赤道约 14 米 x 14 米）。在没有街道地址的地点（例如建筑物未编号，或者街道未命名）或建筑物未编号，或者街道未命名，您可以使用 Plus Codes 来替代街道地址。

Plus Code 必须采用全局代码或复合代码格式：

全局代码由包含 4 个字符的区号和至少包含 6 个字符的区域代码组成。
例如，对于地址“1600 Amphitheatre Parkway, Mountain View, CA”，全局代码为“849V”，本地代码为“CWC8+R9”。然后，您可以使用完整的 10 个字符的 Plus Code 将地理位置值指定为“849VCWC8+R9”。
复合代码由 6 个字符或更长的本地代码与明确的位置信息组成。
例如，“450 Serra Mall, Stanford, CA 94305, USA”的本地代码为“CRHJ+C3”。对于复合地址，请将本地代码与地址的城市、州/省/直辖市/自治区、邮政编码和国家/地区部分组合在一起，格式为“CRHJ+C3 Stanford, CA 94305, USA”。

例如，使用 Plus Code 为路线 origin 和 destination 指定路径点，以计算路线：
```
{
  "origin":{
    "address": "849VCWC8+R9"
  },
  "destination":{
    "address": "CRHJ+C3 Stanford, CA 94305, USA"
  },
  "travelMode": "DRIVE"
}
```

Google Maps Platform API（包括地点自动填充、地点详情、Directions API 和 Geocoding API）支持 Plus Code。例如，您可以使用 Geocoding API 对通过经纬度坐标指定的地点进行反向地理编码，以确定该地点的 Plus Code。