Đặt điểm dừng dọc theo tuyến đường

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Bạn có thể đặt một điểm dừng dọc theo tuyến đường, chẳng hạn như điểm đón hoặc trả khách, theo một trong hai cách sau:

  • Thêm điểm tham chiếu trung gian: Đây là lựa chọn mặc định. Thêm điểm tham chiếu trung gian giữa điểm xuất phát và điểm đến trong mảng intermediates. Công cụ định tuyến sẽ gắn điểm tham chiếu vào con đường có thể di chuyển gần nhất và chia tuyến đường thành các đoạn RouteLeg được kết nối bằng điểm dừng đó.
  • Chỉ định vehicleStopover: Nếu bạn muốn công cụ định tuyến thực hiện thêm phân tích để tránh các đoạn đường không phù hợp để dừng (chẳng hạn như đường cao tốc, đường hầm hoặc cầu vượt), hãy đặt vehicleStopover: true trên một điểm tham chiếu.

Thêm điểm tham chiếu trung gian

Để đặt một điểm dừng dọc theo tuyến đường, hãy thêm điểm tham chiếu trung gian vào mảng intermediates trong yêu cầu của bạn.

Việc thêm điểm tham chiếu trung gian sẽ gây ra những tác động sau:

  • Tuyến đường chia thành các đoạn RouteLeg segments: Mỗi đoạn kết nối một điểm dừng với điểm dừng tiếp theo.
  • Toạ độ gắn vào một con đường: Công cụ định tuyến sẽ gắn toạ độ vĩ độ và kinh độ của bạn (có thể ở trên sân thượng hoặc trong sân) vào đoạn đường có thể di chuyển gần nhất.

Đối với nhiều đường trên mặt đất, việc gắn vào con đường gần nhất sẽ cung cấp một vị trí dừng thực tế. Tuy nhiên, việc gắn không xác định xem đoạn đường đó có phù hợp để tấp vào lề hay không, chẳng hạn như khi con đường gần nhất là đường cao tốc hoặc đường hầm.

Ví dụ: Thêm điểm tham chiếu trung gian

Ví dụ sau đây minh hoạ cách đặt một điểm dừng dọc theo tuyến đường bằng cách thêm điểm tham chiếu trung gian trong yêu cầu POST computeRoutes:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Để biết thêm thông tin về điểm tham chiếu trung gian và đoạn tuyến đường, hãy xem bài viết Đặt điểm tham chiếu trung gian.

Chỉ định vehicleStopover để phù hợp với việc đón và trả khách

Mặc dù điểm tham chiếu trung gian tiêu chuẩn sẽ gắn vào con đường gần nhất, nhưng con đường đó không phải lúc nào cũng phù hợp với điểm dừng của xe. Khi bạn muốn công cụ định tuyến thực hiện thêm phân tích để đánh giá mức độ phù hợp của đường cho việc đón hoặc trả khách, hãy đặt vehicleStopover: true trên điểm tham chiếu.

Khi bạn đặt vehicleStopover: true, công cụ định tuyến sẽ đánh giá các đoạn đường ứng cử viên và cố gắng tránh những con đường không phù hợp để dừng, chẳng hạn như đường cao tốc, đường hầm và cầu vượt.

Ví dụ: hãy xem xét một vị trí mà đường trên mặt đất đi thẳng qua một đường cao tốc bên trong đường hầm: * Điểm tham chiếu trung gian tiêu chuẩn: Gắn vào đường cao tốc hoặc đường hầm bên dưới nếu đường đó gần với toạ độ của bạn hơn về mặt hình học. * Điểm dừng của xe: Thực hiện thêm phân tích để bỏ qua đường cao tốc và đường hầm, gắn điểm dừng vào đường trên mặt đất phù hợp để tấp vào lề.

Ví dụ: Chỉ định vehicleStopover trên một điểm tham chiếu

Ví dụ sau đây minh hoạ cách đặt vehicleStopover: true trên một điểm tham chiếu trung gian trong yêu cầu POST hoàn chỉnh:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Để biết thêm thông tin về các loại và lựa chọn điểm tham chiếu, hãy xem bài viết Các loại và lựa chọn điểm tham chiếu.