API Tuyến đường hiện đang ở chế độ Xem trước (trước GA). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không được hỗ trợ hạn chế. Đồng thời, các thay đổi đối với sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Điều khoản dành riêng cho dịch vụ nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả giai đoạn ra mắt.

Định cấu hình chất lượng và độ trễ

Khi đưa ra yêu cầu, bạn có thể phải đưa ra quyết định về việc có nên trả về kết quả chính xác nhất có thể hay không hoặc trả về kết quả nhanh nhất có thể. API Tuyến đường cho phép bạn kiểm soát chất lượng của dữ liệu phản hồi so với độ trễ của phản hồi.

Thiết lập mức dữ liệu lưu lượng truy cập

API tuyến đường cung cấp routePreference (REST) và routePreference (gRPC) cho phép bạn chỉ định các tùy chọn định tuyến để tính toán tuyến đường. Các tuỳ chọn này khác nhau ở mức độ mà chúng xem xét các điều kiện giao thông khi tính toán tuyến đường. Mỗi tuỳ chọn định tuyến tạo ra các kết quả khác nhau về độ liên quan đến chất lượng tuyến đường, ETA ước tính và độ trễ phản hồi.

Tình trạng giao thông biểu thị tốc độ của luồng giao thông. Ví dụ:

  • Khi không có tình trạng tắc nghẽn, tình trạng giao thông được coi là bình thường và lưu lượng truy cập với tốc độ không bị cản trở thông thường.
  • Khi sắp đến giờ cao điểm, mật độ giao thông tăng lên, làm cho lưu lượng truy cập chậm lại, tạo ra ánh sáng ở mức vừa phải và điều kiện giao thông.
  • Trong lưu lượng truy cập từ đoạn quảng cáo đệm đến đoạn quảng cáo đệm, tốc độ dòng chảy sẽ tạm dừng, tạo ra tình trạng giao thông đông đúc.

Lưu lượng truy cập không nhận biết

Khi bạn đặt tuỳ chọn định tuyến TRAFFIC_UNAWARE, các tuyến đường sẽ được tính toán mà không tính đến điều kiện giao thông hiện tại. Tuỳ chọn định tuyến này cung cấp độ trễ phản hồi thấp nhất (phản hồi được trả về nhanh nhất).

TRAFFIC_UNAWARE là chế độ cài đặt mặc định.

Trong phản hồi:

  • ETA nằm trong thuộc tính phản hồi duration.

  • Các thuộc tính phản hồi durationstaticDuration chứa cùng một giá trị.

Hãy sử dụng tùy chọn định tuyến này khi bạn muốn phản hồi được trả về nhanh nhất và chi tiết định tuyến gần đúng là đủ tốt.

Biết rõ tình hình giao thông

Khi bạn đặt tuỳ chọn định tuyến TRAFFIC_AWARE, các tuyến đường sẽ được tính toán cho các điều kiện giao thông hiện tại. Do đó, tuyến đường và thông tin chi tiết về tuyến đường sẽ phản ánh chính xác hơn tình trạng thực tế. Vì sự gia tăng về chất lượng dữ liệu cũng đi kèm với độ trễ phản hồi, nên việc tối ưu hoá hiệu suất sẽ được áp dụng để giảm phần lớn độ trễ.

Trong phản hồi:

  • ETA xem xét lưu lượng truy cập theo thời gian thực có trong thuộc tính phản hồi duration.

  • Thuộc tính phản hồi staticDuration chứa thời lượng di chuyển trong tuyến đường mà không tính đến điều kiện giao thông.

Hãy sử dụng tuỳ chọn định tuyến này khi bạn muốn thông tin chi tiết chính xác hơn về định tuyến so với TRAFFIC_UNAWARE, nhưng bạn không ngại gì khi phản hồi được trả về với độ trễ tăng vừa phải.

Nhận biết lưu lượng truy cập tối ưu

Khi bạn đặt tuỳ chọn định tuyến TRAFFIC_AWARE_OPTIMAL, các tuyến đường sẽ được tính toán cho các điều kiện giao thông hiện tại, nhưng sẽ không áp dụng tính năng tối ưu hoá hiệu suất nào. Ở chế độ này, máy chủ thực hiện tìm kiếm toàn diện hơn về mạng lưới đường bộ để tìm tuyến đường tối ưu.

Tùy chọn định tuyến TRAFFIC_AWARE_OPTIMAL tương đương với chế độ mà maps.google.com và ứng dụng Google Maps dành cho thiết bị di động sử dụng.

Khi sử dụng tùy chọn này với Ma trận tuyến đường, số lượng phần tử trong một yêu cầu (số điểm gốc × số đích) không được vượt quá 100. Để biết thêm về các giới hạn của Ma trận tuyến đường, hãy xem phần Tính toán ma trận tuyến.

Trong phản hồi:

  • ETA xem xét lưu lượng truy cập theo thời gian thực có trong thuộc tính phản hồi duration.

  • Thuộc tính phản hồi staticDuration chứa thời lượng di chuyển trong tuyến đường mà không tính đến điều kiện giao thông.

Tuỳ chọn định tuyến này cung cấp độ trễ phản hồi cao nhất (tức là các phản hồi trả về với độ trễ lâu nhất). Hãy sử dụng tùy chọn định tuyến này khi bạn muốn kết quả có chất lượng cao nhất, bất kể thời gian phản hồi.

Ảnh hưởng của việc thiết lập thời gian khởi hành

Bạn có thể tuỳ ý sử dụng thuộc tính departureTime để đặt thời gian mong muốn cho chuyến đi. Nếu bạn không đặt thuộc tính departureTime, thuộc tính này sẽ mặc định theo thời gian bạn thực hiện yêu cầu.

  • Đối với TRAFFIC_UNAWARE, bạn không thể đặt departureTime vì lựa chọn tuyến đường và thời lượng dựa trên mạng lưới đường bộ và các điều kiện giao thông trung bình không phụ thuộc vào thời gian.

  • Đối với TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL, khi xem xét các điều kiện lưu lượng truy cập trực tiếp, lưu lượng truy cập trực tiếp càng trở nên quan trọng khi departureTime ở gần hơn. Bạn đặt thời gian khởi hành càng xa trong tương lai, thì điều kiện giao thông trước đây càng được xem xét kỹ lưỡng hơn.

Ví dụ về tuỳ chọn định tuyến chế độ cài đặt

Mã JSON sau đây minh hoạ cách đặt tuỳ chọn định tuyến trong nội dung thông báo yêu cầu.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

Định cấu hình chất lượng hình nhiều đường

API tuyến đường cho phép bạn yêu cầu thông tin về tình trạng giao thông cùng với một đa đường nhận biết lưu lượng truy cập. Vui lòng xem phần Yêu cầu thông tin lưu lượng truy cập trên nhiều đường để biết thêm thông tin.

Chất lượng của hình nhiều đường có thể được mô tả theo các thuật ngữ sau:

  • Số điểm tạo nên hình nhiều đường

    Càng có nhiều điểm, polyline càng mượt mà (đặc biệt là trong đường cong).

  • Độ chính xác của dấu phẩy động của các điểm

    Điểm được chỉ định dưới dạng giá trị vĩ độ và kinh độ, được biểu thị bằng định dạng dấu phẩy động có độ chính xác đơn. Điều này phù hợp với các giá trị nhỏ (có thể được biểu thị chính xác), nhưng độ chính xác sẽ giảm khi giá trị tăng lên do lỗi làm tròn dấu phẩy động.

Phương thức computeRoutes (REST) và phương thức ComputeRoutes (gRPC) hỗ trợ tuỳ chọn yêu cầu polylineQuality để kiểm soát chất lượng đa hình.

Ví dụ về cách thiết lập chất lượng hình nhiều đường

polylineQuality chỉ định chất lượng của polyline là HIGH_QUALITY hoặc OVERVIEW (mặc định). Với OVERVIEW, đường đa hình được soạn một số điểm nhỏ và có độ trễ yêu cầu thấp hơn HIGH_QUALITY.

Ví dụ: trong nội dung yêu cầu:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE",
  "polylineQuality": "HIGH_QUALITY",
  "polylineEncoding": "ENCODED_POLYLINE", 
  "departureTime": "2023-10-15T15:01:23.045123456Z",
  ...
}