Điểm tham chiếu có thể bao gồm các công cụ sửa đổi vị trí để thay đổi cách tính toán tuyến đường, bao gồm cả các chế độ cài đặt cho heading và sideOfRoad.
Sử dụng thuộc tính tiêu đề
Để xác định điểm tham chiếu, bạn cần chỉ định Vị trí (REST) hoặc Vị trí (gRPC) theo vị trí địa lý là cặp vĩ độ và kinh độ.
Dịch vụ vị trí cũng cho phép bạn chỉ định hướng bạn muốn xe chạy đến tại 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 chiếc xe đến cùng bên đường với người tiêu dùng đang chờ đến lấy xe. Khi bạn không chỉ định tiêu đề, xe có thể đi sai đường.
Giá trị tiêu đề là các số nguyên được căn chỉnh theo hướng la bàn và do đó, phạm vi từ 0 đến 359. Ví dụ: Giá trị 0 cho biết hướng của tiêu đề 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
}
},
...
Sử dụng cạnh của bất động sản đường
Bạn biểu thị một vị trí bằng cách tạo đối tượng Pointpoint (REST) hoặc Waypoint (gRPC). Vị trí được xác định theo cặp vĩ độ và kinh độ có thể tương ứng với phần 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 có thể vẫn đặt điểm dừng ở phía đối diện của đường từ vị trí đã chỉ định.
Điểm tham chiếu hỗ trợ thuộc tính sideOfRoad. Thuộc tính này cho biết vị trí điểm tham chiếu có tuỳ chọn để xe dừng ở cùng một con đường như vị trí đã chỉ định.
Hãy chỉ định tuyến đường sử dụng phần ưu tiên của đường 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í để xe có thể dừng ở bên đường mà vị trí được nhắm đến.
Ví dụ sau đây minh họa cách đặt sideOfRoad cho một điểm tham chiếu.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
},
"sideOfRoad": true
},
...