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
- Dịch vụ cần bật:
routes.googleapis.com - Xác thực: Khoá API, OAuth 2.0, Tài khoản dịch vụ
- Bắt đầu: Thiết lập Routes API
- Tài liệu tham khảo: Tài liệu tham khảo Routes API
- Giá: Mức sử dụng và thanh toán cho Routes API
- Chính sách: Chính sách về Routes API
- Ghi chú phát hành: Ghi chú phát hành về Routes API
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: sản phẩm có liên quan
- Thay thế: Directions API, Distance Matrix API
- Thường dùng với: Navigation SDK cho Android, Navigation SDK cho iOS, Route Optimization API, Geocoding API, Places API (Mới)
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-FieldMaskhoặ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
routingPreferencelà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ụngTRAFFIC_AWARE_OPTIMALhoặ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.
- Trả về thông tin đường đi giữa hai hoặc nhiều toạ độ vĩ độ/kinh độ dưới dạng một loạt toạ độ cho từng bước dọc theo tuyến đường.
- Trả về thông tin đường đi giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ dưới dạng một loạt nội dung mô tả thao tác cho các bước dọc theo tuyến đường.
- Trả về khoảng cách giữa mỗi bước dọc theo tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về thời gian di chuyển giữa mỗi bước dọc theo một tuyến đường giữa hai hoặc nhiều nhóm toạ độ vĩ độ/kinh độ.
- Trả về một hình nhiều đường được mã hoá giữa mỗi bước dọc theo tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về khoảng cách cho một tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về thời gian di chuyển cho một tuyến đường giữa hai hoặc nhiều nhóm toạ độ vĩ độ/kinh độ.
- Trả về một đa tuyến được mã hoá cho tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Trả về thông tin về phí cầu đường cho một tuyến đường giữa hai hoặc nhiều tập hợp toạ độ vĩ độ/kinh độ.
- Chỉ định phương tiện di chuyển (lái xe, phương tiện công cộng, đi bộ, xe hai bánh) cho một yêu cầu về tuyến đường. Lưu ý: Trong dịch vụ web Routes API (computeRoutes), hãy truyền travelMode trong phần nội dung JSON của HTTP POST bằng RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT hoặc TRUCK có routeModifiers.vehicleInfo) và thêm tiêu đề X-Goog-FieldMask bắt buộc thay vì tham số truy vấn chế độ GET cũ. Trong thư viện Routes của Maps JavaScript API, hãy truyền travelMode và các trường trên ComputeRoutesRequest.
- Chỉ định điểm dừng hoặc điểm đi qua cho một yêu cầu về tuyến đường.
- Chỉ định cách sử dụng dữ liệu lưu lượng truy cập trong yêu cầu về tuyến đường.
- Chỉ định các đối tượng cần tránh, chẳng hạn như đường cao tốc hoặc trạm thu phí, cho một yêu cầu về tuyến đường.
- Đặt điểm tham chiếu dọc theo tuyến đường.
- Đặt điểm tham chiếu trung gian dọc theo tuyến đường.
- Đặt một điểm để tuyến đường đi qua.
- Chỉ định hướng xe và lề đường cho một tuyến đường.
- Tối ưu hoá thứ tự các điểm dừng trên tuyến đường.
- Chỉ định tuyến đường thân thiện với môi trường cho một yêu cầu về tuyến đường. Xem trước
- Chỉ định khoảng cách ngắn hơn hoặc tuyến đường thay thế cho yêu cầu về tuyến đường. Lưu ý: Trong Routes API, việc yêu cầu tuyến đường tham chiếu có khoảng cách ngắn hơn (SHORTER_DISTANCE) là tính năng Thử nghiệm, trong khi việc yêu cầu tuyến đường thay thế (computeAlternativeRoutes) là tính năng Phát hành rộng rãi (GA).
- Trả về khoảng cách cho một ma trận tuyến đường giữa nhiều điểm xuất phát và điểm đến.
- Trả về thời gian di chuyển cho một ma trận tuyến đường giữa nhiều điểm xuất phát và điểm đến.
- Trả về thông tin về phí cầu đường cho một ma trận tuyến đường giữa nhiều điểm xuất phát và điểm đến.
- Chỉ định phương thức di chuyển (lái xe, phương tiện công cộng, đi bộ, xe hai bánh) cho yêu cầu ma trận tuyến đường. Lưu ý: Trong dịch vụ web Routes API (computeRouteMatrix), hãy truyền travelMode trong phần nội dung JSON của HTTP POST bằng RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT hoặc TRUCK với origins[].routeModifiers.vehicleInfo; BICYCLE không được hỗ trợ cho ma trận tuyến đường) và thêm tiêu đề X-Goog-FieldMask bắt buộc. Trong thư viện Tuyến đường của API JavaScript cho Maps, hãy truyền travelMode và các trường trên ComputeRouteMatrixRequest.