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

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Đ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 heading và sideOfRoad.

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

Để xác định một điểm tham chiếu, bạn cần chỉ định Vị trí địa lý (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 mà bạn muốn xe đi khi đến 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 bên đường với người tiêu dùng đang chờ đó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 đó nằm trong khoảng từ 0 đến 359. Ví dụ: giá trị 0 cho biết hướng đi là hướng Bắc.

Ví dụ sau đây 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 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). 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 cụ thể của đường. 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 ở phía đối diện của đường so với vị trí được 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 ưu tiên cho xe dừng ở cùng một bên đường như được chỉ định theo vị trí.

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 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í này thiên về.

Ví dụ sau đây cho thấy cách đặt sideOfRoad cho một điểm tham chiếu.

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