Tài liệu tham khảo nhanh về Routes API

Routes API là một dịch vụ web có hai phương thức: Compute Routes trả về một tuyến đường giữa hai vị trí có các điểm tham chiếu trung gian không bắt buộc và Compute Route Matrix trả về khoảng cách và thời gian di chuyển cho các tổ hợp điểm xuất phát và điểm đến (tối đa 625 phần tử tuyến đường).

Routes API: dữ kiện chính

  • Sản phẩm: Routes API
  • Còn được gọi là: Routes API phiên bản 2, Compute Routes, Compute ma trận tuyến đường
  • Danh mục: Tuyến đường
  • Nền tảng: Dịch vụ web (REST)
  • Chạy trên: Máy chủ (mã phụ trợ)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về Routes API
  • Phạm vi cung cấp theo khu vực: Toàn cầu. Tính năng định tuyến cho xe hai bánh, tuyến đường thân thiện với môi trường và tính phí cầu đường chỉ được hỗ trợ ở một số quốc gia và thành phố. Các lãnh thổ phụ thuộc có mã CLDR riêng sẽ không được hỗ trợ, trừ phi có trong danh sách. Đối với địa chỉ thanh toán ở Khu vực kinh tế Châu Âu (EEA), các điều khoản của EEA tại https://developers.google.com/maps/comms/eea/routes nghiêm cấm việc sử dụng nội dung mô tả hoặc các bước của tuyến đường với bất kỳ bản đồ nào. (thông tin chi tiết về phạm vi bảo hiểm)

Routes API: trường hợp sử dụng

Sử dụng Routes API khi:

  • Bạn cần có một tuyến đường giữa điểm xuất phát và điểm đến, có thể có các điểm tham chiếu trung gian, cho việc lái xe, đi bộ, đạp xe, đi xe hai bánh hoặc đi phương tiện công cộng.
  • Bạn cần có khoảng cách và thời gian di chuyển cho nhiều cặp điểm xuất phát – điểm đến trong một yêu cầu (tối đa 625 phần tử).
  • Bạn cần thông tin ước tính phí cầu đường (một số thành phố), tuyến đường thân thiện với môi trường (một số khu vực), hình nhiều đường có thông tin giao thông hoặc thông tin định tuyến cho xe lớn (phạm vi cung cấp có hạn).
  • Bạn đang di chuyển một ứng dụng máy chủ khỏi Directions API hoặc Distance Matrix API cũ.

Không sử dụng Routes API khi:

  • Bạn cần tối ưu hoá việc chỉ định tải và dừng đặt hàng cho toàn bộ đội xe. Thay vào đó, hãy sử dụng Route Optimization API.
  • Bạn cần có tính năng chỉ đường từng chặng trong ứng dụng trên Android theo một tuyến đường được tính toán. Hãy sử dụng Navigation SDK cho Android.
  • Bạn cần có tính năng đường đi từng chặng trong ứng dụng trên iOS theo một tuyến đường được tính toán. Thay vào đó, hãy sử dụng Navigation SDK cho iOS.

Routes API: thiết lập

Các gói Routes API chính thức:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

Routes API: lỗi thường gặp

  • Vấn đề: Không có danh sách mặc định cho các trường được trả về; các yêu cầu không có mặt nạ trường (tiêu đề X-Goog-FieldMask hoặc tham số $fields) sẽ trả về lỗi. Cách khắc phục: Luôn gửi mặt nạ trường liệt kê các trường phản hồi mà bạn cần. Xem /maps/documentation/routes/choose_fields.
  • Vấn đề: Việc sử dụng mặt nạ trường ký tự đại diện (*) trong môi trường thực tế sẽ làm tăng chi phí và độ trễ, đồng thời chi phí có thể tăng đột ngột khi các tính năng nâng cao mới được thêm vào phản hồi. Cách khắc phục: Chỉ sử dụng * trong quá trình phát triển; trong quá trình phát hành công khai, chỉ yêu cầu các trường bạn cần. Xem /maps/documentation/routes/choose_fields.
  • Vấn đề: Thông tin về phí cầu đường và mức tiêu thụ nhiên liệu không được trả về chỉ bằng cách thêm chúng vào mặt nạ trường; kể từ khi GA, các thông tin này phải được bật một cách rõ ràng. Cách khắc phục: Thêm mảng extraComputations (ví dụ: TOLLS, FUEL_CONSUMPTION) vào yêu cầu ngoài mặt nạ trường. Xem /maps/documentation/routes/migrate-routes-preview.
  • Vấn đề: Compute Route Matrix cho phép 625 phần tử, nhưng chỉ cho phép 100 phần tử khi routingPreference là TRAFFIC_AWARE_OPTIMAL. Cách khắc phục: Giữ số lượng điểm xuất phát x điểm đến ở mức 100 trở xuống khi sử dụng TRAFFIC_AWARE_OPTIMAL hoặc chia nhỏ yêu cầu. Xem /maps/documentation/routes/compute_route_matrix.

Những việc bạn có thể làm với Routes API

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.