Đường gần nhất

Roads API nhận tối đa 100 toạ độ độc lập và trả về đoạn đường gần nhất cho mỗi điểm. Các điểm đã truyền không cần phải là một phần của đường dẫn liên tục.

Nếu bạn đang làm việc với các điểm GPS tuần tự, hãy sử dụng tính năng Căn chỉnh với đường.

Yêu cầu

Yêu cầu về đường gần nhất phải được gửi qua HTTPS và có dạng như sau:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

Required parameters

• points

  The points to be snapped. The points parameter accepts a list of latitude/longitude pairs. Separate latitude and longitude values with commas. Separate coordinates with the pipe character: "|". For example: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Ví dụ

Yêu cầu sau đây trả về một tập hợp các đoạn đường dựa trên danh sách toạ độ được chỉ định.

URL

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

Phản hồi

Đối với mỗi yêu cầu hợp lệ, Roads API sẽ trả về một phản hồi ở định dạng được chỉ định trong URL yêu cầu.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

Phản hồi sử dụng lược đồ sau.

NearestRoadsResponse

Field	Required	Type	Description
snappedPoints	optional	Array<SnappedPoint>	An array of snapped points. Sometimes containing several snapped points for the same point with differing placeId or location. See SnappedPoint for more information.

SnappedPoint

Field	Required	Type	Description
location	required	LatitudeLongitudeLiteral	See LatitudeLongitudeLiteral for more information.
placeId	required	string	A unique identifier for a place. All place IDs returned by the Roads API correspond to road segments.
originalIndex	optional	number	An integer that indicates the corresponding value in the original request. Each value in the request should map to a snapped value in the response. However, if you've set interpolate=true or if you're using nearest roads, then it's possible that the response will contain more coordinates than the request. Interpolated values will not have an originalIndex. These values are indexed from 0, so a point with an originalIndex of 4 will be the snapped value of the 5th latitude/longitude passed to the path parameter. Nearest Roads points may contain several points for single coordinates with differing location or placeId.

LatitudeLongitudeLiteral

An object describing a specific location with Latitude and Longitude in decimal degrees.

Field	Required	Type	Description
latitude	required	number	Latitude in decimal degrees
longitude	required	number	Longitude in decimal degrees