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

Điểm tham chiếu có thể bao gồm công cụ 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 điểm tham chiếu, hãy chỉ định vị trí địa lý Vị trí (REST) hoặc Vị trí (gRPC) 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 khi mã sẽ đế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 chiếc xe đến ở cùng phía đường khi người tiêu dùng đang chờ đã chọn. Khi bạn không chỉ định hướng, xe có thể đến trên sai bên đường.

Giá trị tiêu đề là các số nguyên phù hợp với hướng la bàn và do đó có phạm vi từ 0 đến 359. Ví dụ: giá trị 0 cho biết tiêu đề hướng đến hạn: Bắc.

Ví dụ sau đây minh hoạ cách đặt giá trị heading làm đ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ểm tham chiếu (REST) hoặc Waypoint (gRPC) . Vị trí được xác định bởi 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ối ưu hoá tuyến, một tuyến có thể vẫn đặt điểm dừng ở phía đối diện của đường với đường được chỉ định vị trí.

Điểm tham chiếu hỗ trợ thuộc tính sideOfRoad cho biết rằng vị trí điểm tham chiếu yêu cầu xe dừng tại cùng phía đường được chỉ định bởi vị trí.

Chỉ định rằng tuyến đường sử dụng đoạn đường ưu tiên bằng cách đặt giá trị Thuộc tính tham chiếu sideOfRoad đến true. Sau đó, tuyến đường này đi qua vị trí để xe có thể dừng ở bên đường tại vị trí đó có xu hướng rõ ràng.

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
  },
  ...