Các điểm tham chiếu có thể bao gồm đố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 tiêu đề xe
Để xác định một điểm tham chiếu, bạn chỉ định Vị trí (REST) địa lý hoặc Vị trí (gRPC) là một cặp toạ độ vĩ độ/kinh độ.
Thông tin vị trí cũng cho phép bạn chỉ định hướng mà bạn muốn xe đi khi xe đến tại từng đ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 một phía đường khi người tiêu 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ị tiêu đề là các số nguyên phù hợp với hướng của la bàn và do đó nằm trong khoảng từ 0 đến 359. Ví dụ: giá trị 0 cho biết hướng tiêu đề là hướng Bắc đến hạn.
Ví dụ sau minh hoạ cách đặt heading cho một điểm tham chiếu.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
},
"heading": 127
}
},
...
Chỉ định một bên của tuỳ chọn đường
Bạn biểu thị một vị trí bằng cách tạo đối tượng Điểm tham chiếu (REST) hoặc Điểm tham chiếu (gRPC). Vị trí được xác định bằng cặp vĩ độ và kinh độ có thể tương ứng với một cạnh cụ thể của con đường. Tuy nhiên, để hỗ trợ việc tối ưu hoá tuyến đường, một tuyến đường vẫn có thể đặt một điểm dừng ở phía đối diện đường từ vị trí đã chỉ định.
Điểm tham chiếu hỗ trợ thuộc tính sideOfRoad, cho biết rằng vị trí điểm tham chiếu cho phép xe dừng ở cùng phía đường mà vị trí đã chỉ định.
Hãy chỉ định rằng tuyến đường sử dụng đoạn đường ưu tiên bằng cách đặt thuộc tính Điểm tham chiếu sideOfRoad thành true. Sau đó, tuyến đường sẽ đi qua vị trí này để xe có thể dừng ở bên đường mà vị trí thiên vị.
Ví dụ sau đây cho thấy cách thiết lập sideOfRoad cho một điểm tham chiếu.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
},
"sideOfRoad": true
},
...