Chỉ định hướng xe và lề đường

Điểm trung gian có thể bao gồm các đối tượng sửa đổi vị trí để thay đổi cách tính toán tuyến đường, bao gồm cả chế độ cài đặt cho headingsideOfRoad.

Chỉ định hướng của xe

Để xác định một điểm trung gian, bạn chỉ định Vị trí (REST) hoặc Vị trí (gRPC) địa lý dưới dạng một cặp toạ độ vĩ độ/kinh độ.

Vị trí cũng cho phép bạn chỉ định hướng bạn muốn xe đi theo khi đến từng điểm trung gian. Bạn có thể sử dụng tính năng này để đảm bảo rằng xe đến cùng bên đường với người dùng đang chờ được đón. Khi bạn không chỉ định hướng, xe có thể đến sai bên đường.

Giá trị hướng là các số nguyên phù hợp với hướng la bàn, do đó dao động từ 0 đến 359. Ví dụ: giá trị 0 cho biết hướng chính Bắc.

Ví dụ sau đây minh hoạ cách đặt heading cho một điểm trung gian.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      },
      "heading": 127
    }
  },
  ...

Chỉ định lựa chọn ưu tiên về bên đường

Bạn biểu thị một vị trí bằng cách tạo đối tượng Waypoint (REST) hoặc Waypoint (gRPC). Một vị trí được xác định bằng một cặp vĩ độ và kinh độ có thể tương ứng với một bên đường cụ thể. Tuy nhiên, để hỗ trợ tính năng tối ưu hoá tuyến đường, tuyến đường vẫn có thể đặt điểm dừng chân ở phía đối diện của đường so với vị trí đã chỉ định.

Điểm trung gian hỗ trợ thuộc tính sideOfRoad, cho biết vị trí điểm trung gian có ưu tiên để xe dừng ở cùng một bên đường như vị trí đã chỉ định.

Chỉ định rằng tuyến đường sử dụng bên đường ưu tiên bằng cách đặt thuộc tính Điểm trung gian sideOfRoad thành true. Sau đó, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở bên đường mà vị trí đó nghiêng về.

Ví dụ sau đây cho thấy cách đặt sideOfRoad cho một điểm trung gian.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    },
    "sideOfRoad": true
  },
  ...