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

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

Nội dung có trong tài liệu về Routes API (API Tuyến đường cho ô tô)

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

Cho phép yêu cầu của bạn

Để cho phép các yêu cầu của bạn đến annotatePaths, bạn phải sử dụng phương thức OAuth như mô tả ở đây: Sử dụng OAuth (Automotive). Các yêu cầu này đòi hỏi bạn phải sử dụng hành vi mạo danh với OAuth, tương tự như cách bạn gọi API Automotive Maps (nhưng với 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 loại 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 Standard Routes API (API Tuyến đường tiêu chuẩn)

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

Xin lưu ý rằng khi sử dụng hướng dẫn về API Tuyến đường tiêu chuẩn, các đường liên kết sẽ trỏ đến tệp tham chiếu chuẩn. Bạn cần truy cập đến đường liên kết tương đương trong Routes API (API Tuyến đường) để tham khảo trên Automotive. Bạn có thể thực hiện việc này bằng cách thêm automotive/ sau routes/ trong URL của 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 bạn cần tránh gửi lỗi 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 các 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 có giá trị như nhau.

Ngoài ra, mặc dù mọi người thường gọi annotatePaths, computeRoutes hoặc computeRoutesMatrix là "API", nhưng thực ra đây 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à phương thức hoặc API.

GA (Phạm vi cung cấp chung) và Các tính năng thử nghiệm

Phần này mô tả các thuộc tính riêng biệt trong Routes API for Automotive. Các tính năng sau đây thường được cung cấp rộng rãi.

Các thuộc tính cơ sở được hiển thị thông qua Routes API (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:

Các thuộc tính cơ sở được hiển thị thông qua Routes API (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ể xem dọc theo hình nhiều đường

  • Mức độ 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ố dạ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.
  • Các nhóm tốc độ dự đoán dọc theo 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 định tuyến

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 đố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[]). Hỗ trợ 6 quốc gia: Áo, Thuỵ Sĩ, Hungary, Slovenia, Slovakia và Cộng hoà Séc.
  • Cho phép đường dành cho xe có sức chứa cao (GST) (hovPreference). Được hỗ trợ ở Hoa Kỳ và Canada.
  • Tránh đường hầm (avoidTunnels).
  • Tuyến đường dành riêng cho xe kéo (totalAxleCount, totalHeightMm, totalLengthMm, totalWidthMm, totalWeightKg).