Đặ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 điểm dừng dọc theo một tuyến đường, chẳng hạn như để đón hoặc trả khách, theo một trong hai cách:

  • Thêm điểm tham chiếu trung gian: Đây là lựa chọn mặc định. Thêm một điểm tham chiếu trung gian giữa điểm khởi hành 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 gần nhất có thể đi 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 một 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 cho việc dừng xe (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 một điểm tham chiếu trung gian

Để đặt một điểm dừng dọc theo tuyến đường, hãy thêm một đ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 một điểm tham chiếu trung gian sẽ có những tác động sau:

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

Đố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, tính năng này không xác định xem đoạn đường đó có phù hợp để tấp vào lề đường hay không, chẳng hạn như khi đường gần nhất là đường cao tốc hoặc đường hầm.

Ví dụ: Thêm một đ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 một điểm tham chiếu trung gian trong yêu cầu computeRoutes POST:

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ề các điểm tham chiếu trung gian và đoạn đường, hãy xem phần Đặt điểm tham chiếu trung gian.

Chỉ định một vehicleStopover để xác định mức độ phù hợp cho việc đón và trả khách

Mặc dù điểm tham chiếu trung gian tiêu chuẩn sẽ khớp với con đường gần nhất, nhưng con đường đó không phải lúc nào cũng phù hợp để xe dừng lại. Khi bạn muốn công cụ định tuyến thực hiện thêm quy trình 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 đề xuất và cố gắng tránh những con đường không phù hợp để dừng xe, 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 ngay phía trên đường cao tốc bên trong một đường hầm: * Điểm tham chiếu trung gian tiêu chuẩn: Chụp nhanh đường cao tốc hoặc đường hầm bên dưới nếu đường cao tốc hoặc đường hầm đó 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 phân tích bổ sung để bỏ qua đường cao tốc và đường hầm, điều chỉnh điểm dừng thành đường trên mặt đất phù hợp để dừng xe.

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

Ví dụ sau đây minh hoạ cách thiết lập vehicleStopover: true trên một điểm tham chiếu trung gian trong một 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 cho điểm tham chiếu, hãy xem bài viết Các loại và lựa chọn cho điểm tham chiếu.