Giới hạn tốc độ

Roads API trả về giới hạn tốc độ được đăng cho một đoạn đường nhất định. Trong trường hợp các đoạn đường có giới hạn tốc độ thay đổi, hệ thống sẽ trả về giới hạn tốc độ mặc định cho đoạn đường đó.

Chúng tôi không thể đảm bảo độ chính xác của dữ liệu giới hạn tốc độ do Roads API trả về. Dữ liệu giới hạn tốc độ được cung cấp không phải là dữ liệu theo thời gian thực và có thể là dữ liệu ước tính, không chính xác, không đầy đủ hoặc đã lỗi thời. Hãy xem thông tin chi tiết về phạm vi phủ sóng để biết các khu vực có dữ liệu giới hạn tốc độ.

Yêu cầu

Gửi yêu cầu về giới hạn tốc độ bằng HTTPS theo hình thức sau: 

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

Cách sử dụng tham số

Tham số bắt buộc

  • Tham số path hoặc placeId.

    • path – Danh sách gồm tối đa 100 cặp vĩ độ/kinh độ đại diện cho một đường đi. Bạn phải phân tách các giá trị vĩ độ và kinh độ bằng dấu phẩy. Bạn phải phân tách các cặp vĩ độ/kinh độ bằng ký tự gạch đứng: "|". Khi bạn cung cấp tham số path, API sẽ trước tiên khớp đường đi với con đường mà xe có khả năng đi nhất (như đối với yêu cầu snapToRoads), sau đó xác định giới hạn tốc độ cho đoạn đường có liên quan. Nếu không muốn API khớp đường dẫn, bạn phải truyền tham số placeId như giải thích bên dưới. Ví dụ sau đây cho thấy tham số path với 3 cặp vĩ độ/kinh độ: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

    • placeId – (Các) mã địa điểm đại diện cho một hoặc nhiều đoạn đường. Hãy đảm bảo rằng mỗi mã địa điểm đều đề cập đến một đoạn đường chứ không phải một loại địa điểm khác. Bạn có thể truyền tối đa 100 mã địa điểm cho mỗi yêu cầu. Phản hồi bao gồm giới hạn tốc độ cho mỗi mã địa điểm trong yêu cầu.

      API không thực hiện việc khớp đường đi trên các mã địa điểm được cung cấp. Bạn có thể gửi yêu cầu snapToRoads hoặc nearestRoads để tìm Mã địa điểm có liên quan, sau đó cung cấp các mã này làm thông tin đầu vào cho yêu cầu speedLimits. Ví dụ sau đây cho thấy tham số placeId với 2 mã địa điểm: placeId=ChIJs5ydyTiuEmsR0fRSlU0C7k0&placeId=ChIJW__r4ERXzpQRgkeRL6P0m3Y

  • key – Khoá API của ứng dụng. Ứng dụng của bạn phải tự xác định mỗi khi gửi yêu cầu đến Roads API bằng cách đưa khoá API vào mỗi yêu cầu. Tìm hiểu cách lấy khoá.

Thông số tùy chọn

  • units – Có trả về giới hạn tốc độ tính bằng ki-lô-mét hay dặm mỗi giờ hay không. Bạn có thể đặt giá trị này thành KPH hoặc MPH. Giá trị mặc định là KPH.

Phản hồi

Các phần tử sau đây có thể xuất hiện trong phản hồi speedLimits:

  • speedLimits – Một mảng siêu dữ liệu về đường. Mỗi phần tử bao gồm các trường sau:
    • placeId – Giá trị nhận dạng duy nhất cho một địa điểm. Tất cả mã địa điểm do Roads API trả về sẽ tương ứng với các đoạn đường.Roads API
    • speedLimit – Giới hạn tốc độ cho đoạn đường đó.
    • units – Trả về KPH hoặc MPH.
  • snappedPoints – một mảng các điểm được khớp. Mảng này chỉ xuất hiện nếu yêu cầu chứa tham số path. Mỗi điểm bao gồm các trường sau:
    • location – chứa giá trị latitude và longitude.
    • originalIndex – Một số nguyên cho biết giá trị tương ứng trong yêu cầu ban đầu. Mỗi giá trị trong yêu cầu phải ánh xạ đến một giá trị được khớp trong phản hồi. Các giá trị này được lập chỉ mục từ 0, vì vậy, một điểm có originalIndex là 4 sẽ là giá trị được khớp của vĩ độ/kinh độ thứ 5 được truyền đến tham số path.
    • placeId – Giá trị nhận dạng duy nhất cho một địa điểm. Tất cả mã địa điểm do Roads API trả về sẽ tương ứng với các đoạn đường.Roads API Bạn có thể truyền placeId trong yêu cầu về giới hạn tốc độ để xác định giới hạn tốc độ dọc theo đoạn đường đó.
  • warning_message – Một chuỗi chứa cảnh báo mà người dùng có thể nhìn thấy.

Yêu cầu mẫu sử dụng đường dẫn

Yêu cầu này lấy giới hạn tốc độ cho từng đoạn đường gần nhất với các cặp vĩ độ/kinh độ được chỉ định trong một đường đi băng qua cầu Vasco da Gama ở Lisbon, Bồ Đào Nha.

Yêu cầu

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

Phản hồi

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

Hãy lưu ý thông báo cảnh báo về mật độ điểm trong phản hồi ở trên. Nếu đang yêu cầu giới hạn tốc độ cho các đoạn đường gần nhất tại các điểm tuỳ ý, bạn phải gọi speedLimits bằng mã địa điểm được truy xuất từ điểm cuối nearestRoads.

Yêu cầu mẫu sử dụng mã địa điểm

Thay vì sử dụng các cặp vĩ độ/kinh độ, bạn có thể truyền mã địa điểm của các đoạn đường. Bạn nên lấy mã địa điểm cho các đoạn đường bằng yêu cầu snapToRoads hoặc nearestRoads. Khi bạn truyền mã địa điểm, API sẽ trả về giới hạn tốc độ cho đoạn đường được biểu thị bằng mỗi mã địa điểm. API không áp dụng bất kỳ thao tác khớp đường đi nào cho các mã địa điểm được cung cấp.

Ví dụ sau đây yêu cầu giới hạn tốc độ cho một số đoạn đường băng qua cầu Vasco da Gama ở Lisbon, Bồ Đào Nha.

Yêu cầu

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

Phản hồi

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

Đề xuất về cách sử dụng

Để giảm thiểu số lượng lệnh gọi đến dịch vụ Giới hạn tốc độ, bạn nên lấy mẫu vị trí của tài sản theo khoảng thời gian từ 5 đến 15 phút (giá trị chính xác phụ thuộc vào tốc độ di chuyển của tài sản). Nếu tài sản đứng yên, thì một mẫu vị trí là đủ (không cần thực hiện nhiều lệnh gọi).

Để giảm thiểu độ trễ tổng thể, bạn nên gọi dịch vụ Giới hạn tốc độ sau khi đã tích luỹ được một số dữ liệu, thay vì gọi API mỗi khi nhận được vị trí của một tài sản di động.

Tại sao một số/tất cả giới hạn tốc độ bị thiếu?

Nguyên nhân phổ biến nhất khiến speedLimits bị thiếu là do bạn yêu cầu giới hạn tốc độ của một địa điểm không phải là đoạn đường.

Ví dụ trên sử dụng cầu Vasco da Gama để minh hoạ các khái niệm; cầu này hỗ trợ đường E90 băng qua sông Rio Tejo. Bản thân cây cầu có mã địa điểm là ChIJUzt97ZEwGQ0RM1JzQfqoDtU. Đoạn đường đầu tiên trong phản hồi ở trên là một phần của đường E90 và có mã địa điểm là ChIJX12duJAwGQ0Ra0d4Oi4jOGE. Trong yêu cầu mẫu, nếu bạn thay thế mã địa điểm của đường bằng mã địa điểm của cầu, thì trong phản hồi sẽ chỉ có 2 giới hạn tốc độ trong mảng speedLimits vì mã địa điểm của cầu không đề cập đến một đoạn đường riêng lẻ. Hơn nữa, nếu không có mã địa điểm nào dành cho các đoạn đường, thì phản hồi sẽ không chứa bất kỳ giới hạn tốc độ nào.

Khi đưa ra yêu cầu về giới hạn tốc độ bằng mã địa điểm, hãy đảm bảo rằng mỗi mã địa điểm đều đề cập đến một đoạn đường chứ không phải một loại địa điểm khác. Bạn nên truy xuất mã địa điểm cho từng đoạn đường bằng yêu cầu snapToRoads hoặc nearestRoads. Mỗi yêu cầu này có thể trả về nhiều mã địa điểm từ một lệnh gọi.

Điều gì xảy ra nếu một đoạn đường đăng giới hạn tốc độ riêng cho ô tô và xe tải?

Roads API trả về giới hạn tốc độ tối đa được đăng cho ô tô.