Điểm tham chiếu 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 heading và sideOfRoad.
Chỉ định hướng của xe
Để xác định một điểm tham chiếu, 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 mà bạn muốn xe đi khi đến mỗi điểm tham chiếu. Bạn có thể sử dụng tính năng này để đảm bảo rằng xe đến cùng phía đường với người tiêu dùng đang đợi được đón. Khi bạn không chỉ định hướng, xe có thể đến ở sai bên đường.
Giá trị hướng là số nguyên phù hợp với hướng la bàn, do đó, giá trị này nằm trong khoảng từ 0 đến 359. Ví dụ: giá trị 0 cho biết hướng của tiêu đề là hướng Bắc.
Ví dụ sau đây minh hoạ cách đặt heading cho một điểm đánh dấu.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
},
"heading": 127
}
},
...Chỉ định lựa chọn ưu tiên về lề đườ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 phía cụ thể của đường. Tuy nhiên, để hỗ trợ tính năng tối ưu hoá tuyến đường, một 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 đánh dấu hỗ trợ thuộc tính sideOfRoad. Thuộc tính này cho biết vị trí của điểm đánh dấu có lựa chọn ưu tiên cho 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 phía đường ưu tiên bằng cách đặt thuộc tính Waypoint sideOfRoad thành true. Sau đó, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở lề đường gần vị trí đó nhất.
Ví dụ sau đây minh hoạ cách đặt sideOfRoad cho một điểm tham chiếu.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
},
"sideOfRoad": true
},
...