API tuyến đường cho ô tô

Routes API for Automotive cung cấp các thuộc tính chuyên biệt dành cho những đối tác trong ngành ô tô đang phát triển các tính năng chỉ đường trong ô tô. API này mở rộng API Tuyến đường tiêu chuẩn với các thuộc tính dành riêng cho ngành ô tô.

Nội dung trong tài liệu về Routes API for Automotive

Ngoài tài liệu về API Tuyến đường tiêu chuẩn, API Tuyến đường cho Ô tô còn có thêm các nội dung sau:

Uỷ quyền cho các yêu cầu của bạn

Để cho phép các yêu cầu của bạn truy cập vào annotatePaths, bạn phải sử dụng phương thức OAuth được mô tả ở đây: Sử dụng OAuth (Automotive). Các yêu cầu này yêu cầu bạn sử dụng tính năng mạo danh bằng OAuth, tương tự như cách bạn gọi API Automotive Maps (nhưng có phạm vi khác).

Tuy nhiên, nếu đang gọi phương thức computeRoutes hoặc computeRoutesMatrix, bạn có thể sử dụng một trong hai hình thức uỷ quyền được mô tả trong tài liệu về API tuyến đường thông thường: khoá API hoặc OAuth.

Tài liệu được chia sẻ với API Tuyến đường tiêu chuẩn

Routes API for Automotive chia sẻ tài liệu với API tuyến đường tiêu chuẩn, chẳng hạn như hướng dẫn trong thẻ Hướng dẫn.

Lưu ý rằng khi sử dụng hướng dẫn API Tuyến đường chuẩn, các đường liên kết sẽ trỏ đến tệp tham chiếu chuẩn. Bạn cần chuyển đến đường liên kết tương đương trong Routes API (API Tuyến đường) để tham khảo về Automotive. Bạn có thể thực hiện việc này bằng cách thêm automotive/ sau routes/ trong URL trình duyệt, như sau: routes/automotive/.

Nhận trợ giúp

Vì Routes API for Automotive không được cung cấp công khai, nên chúng tôi đề nghị bạn tránh gửi lỗi dựa trên API này cho Công cụ theo dõi lỗi công khai của chúng tôi. Chúng tôi đã cung cấp cho nhóm của bạn một thành phần Công cụ theo dõi lỗi dành riêng cho công ty để báo cáo lỗi. Hãy liên hệ với người liên hệ của Google nếu bạn có mối lo ngại khác.

Thuật ngữ và quy ước viết hoa Camel

Tài liệu này chủ yếu sử dụng quy ước viết hoa Camel REST (chẳng hạn như annotatePaths) thay vì quy ước viết hoa RPC (AnnotatePaths). Tuy nhiên, cả hai cách viết hoa đều hợp lệ như nhau.

Ngoài ra, mặc dù thông thường gọi annotatePaths, computeRoutes hoặc computeRoutesMatrix là "API", nhưng chúng thực ra là các phương thức tuỳ chỉnh. Tuy nhiên, bạn có thể thấy chúng được gọi là một trong hai phương thức hoặc API.

GA (Phát hành rộng rãi) và Các tính năng thử nghiệm

Phần này mô tả các thuộc tính duy nhất trong Routes API for Automotive. Sau đây là các tính năng được cung cấp rộng rãi.

Thuộc tính cơ sở được hiển thị thông qua API Tuyến đường

Hình nhiều đường E7 (hình nhiều đường được mã hoá tiêu chuẩn được mô tả bằng toạ độ E7 thay vì E5):

Tính năng thử nghiệm

Các tính năng sau đang trong giai đoạn Thử nghiệm và chỉ dành cho một số khách hàng chọn lọc:

Thuộc tính cơ sở được hiển thị thông qua API Tuyến đường

  • Mã thông báo tuyến đường được lấy làm dữ liệu đầu vào không bắt buộc. Xem routeToken trong Route.

Thông tin có thể có dọc theo hình nhiều đường

  • Thời gian chậm trễ do tắc đường được tính bằng phút giao thông. Hãy xem IncidentType.
  • Enum sự cố không có thông tin chi tiết về sự cố bằng văn bản. Hãy xem IncidentInfo.

Hãy xem PolylineDetails.

Các tính năng khác

  • Cao độ dọc theo tuyến đường. Hãy xem AltitudeInfo.
  • Nhóm tốc độ dự đoán trên tuyến đường (8 nhóm, mỗi nhóm có chiều rộng từ 10 đến 20 km/giờ). Hãy xem PredictedSpeedInfo.

Công cụ sửa đổi tuyến đường

Bạn có thể kích hoạt RouteModifiers sau đây từ API. Tuy nhiên, các tuyến này có thể không tuân theo mục tiêu của đối tượng sửa đổi vì chúng vẫn đang trong quá trình phát triển và kiểm thử. Hãy liên hệ với người đại diện của Google nếu bạn có thắc mắc.

  • Tránh sử dụng quảng cáo giữa lần tải trang (avoidVignettes[]). Được hỗ trợ tại 6 quốc gia: Áo, Thuỵ Sĩ, Hungary, Slovenia, Slovakia và Cộng hoà Séc.
  • Cho phép đường dành cho xe chở nhiều người (lái xe chở nhiều người) (hovPreference). Được hỗ trợ ở Hoa Kỳ và Canada.
  • Tránh đường hầm (avoidTunnels).
  • Các tuyến đường dành riêng cho xe kéo (totalAxleCount, totalHeightMm, totalLengthMm, totalWidthMm, totalWeightKg).