指定路由的位置

如需计算路线,您必须至少指定路线出发地和路线目的地的位置。您可以将这些位置定义为路线上的航点

除了出发地和目的地之外,您还可以指定不同类型的航点以及如何处理路线的航点。如需了解详情和示例,请参阅以下主题:

为路线指定位置

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

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

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

  • 使用纬度/经度坐标可能会导致位置被贴靠到距离这些坐标最近的道路,而该道路可能不是不动产的接入点,甚至是可快速或安全地通向目的地的道路。
  • 必须先通过 Routes API 对地址字符串进行地理编码,将其转换为纬度/经度坐标,然后才能计算路线。这种转化可能会影响效果。

将营业地点指定为地点 ID

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

Geocoding APIPlaces API(包括地点自动补全)中检索地点 ID。如需详细了解地点 ID,请参阅地点 ID 概览

以下示例使用 placeId 属性为 origindestination 传递地点 ID:

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

以经纬度坐标的形式指定位置

如需在航点中定义位置,请使用纬度/经度坐标指定位置 (REST)位置(gRPC)

例如,使用 latitudelongitude 坐标为路线 origindestination 指定航点:

{
  "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 会在内部对该字符串进行地理编码,以将其转换为纬度和经度坐标。

例如,如需计算路线,您可以使用地址字符串为路线 origindestination 指定航点:

{
  "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 代码相同,但也有一些需要注意的例外情况。例如,英国的 ccTLD 为“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 Codes 基于纬度/经度坐标,以数字和字母形式显示,而不是包含街道名称和门牌号的地址。

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 Codes 为路线 origindestination 指定航点来计算路线:

    {
      "origin":{
        "address": "849VCWC8+R9"
      },
      "destination":{
        "address": "CRHJ+C3 Stanford, CA 94305, USA"
      },
      "travelMode": "DRIVE"
    }

Google Maps Platform API(包括地点自动补全地点详情Directions APIGeocoding API)均支持 Plus Code。例如,您可以使用 Geocoding API 对由纬度/经度坐标指定的位置进行反向地理编码,以确定该位置的 Plus Code。