API Tuyến đường cải thiện hiệu suất trong việc tính toán đường đi, khoảng cách và thời gian di chuyển, khiến việc thay thế các ứng dụng hiện đang sử dụng API Chỉ đường và API Ma trận khoảng cách trở nên đáng giá. Hầu hết chức năng của API tuyến đường tương thích ngược với cả API hướng dẫn và API ma trận khoảng cách.
Hãy sử dụng hướng dẫn này để tìm hiểu những điểm khác biệt chính trong Routes API so với các sản phẩm mà API này thay thế, cùng với cách xử lý những thay đổi cần thiết. Để biết thêm thông tin chi tiết về các tính năng khác của API Tuyến, hãy xem nội dung tổng quan về sản phẩm.
Các điểm cải tiến chính
Phần này trình bày một số tính năng nâng cao mà bạn có thể mong đợi khi sử dụng API Tuyến đường trong ứng dụng của mình.
Tăng hạn mức về yêu cầu
| API Tuyến đường |
|
| API Ma trận khoảng cách |
|
Phản hồi yêu cầu nhanh hơn
Tính năng ma trận tuyến tính toán có các điểm cải thiện về độ trễ như sau:
- Nhận các phần tử truyền trực tuyến của phản hồi trước khi tính toán toàn bộ ma trận.
- Sử dụng mặt nạ trường để tuỳ chỉnh các chi tiết phản hồi, chỉ yêu cầu dữ liệu bạn cần, một phương pháp hay nhất cũng giúp bạn giảm chi phí.
- Tính toán nâng cao tuyến đường cho lưu lượng truy cập, để bạn có thể cân bằng giữa chất lượng dữ liệu và thời gian phản hồi.
Cải tiến về định tuyến
Tính năng định tuyến điện toán mang đến những cải tiến về định tuyến sau đây:
- Thông tin về phí cầu đường ngoài khoảng cách và giờ đến dự kiến.
- Tuyến đường xe 2 bánh.
- Xác định các điểm dừng chân để đảm bảo an toàn.
- Tăng độ chính xác của Giờ đến dự kiến bằng cách đặt hướng di chuyển và lề đường cho các điểm tham chiếu.
Chỉ yêu cầu dữ liệu bạn cần
Bây giờ, bạn sẽ chỉ định các trường cần trả về, giúp giảm thời gian xử lý và phí thanh toán.
| API Tuyến đường | Yêu cầu của bạn phải sử dụng mặt nạ trường để chỉ định những trường mà bạn muốn
được trả về trong phản hồi. Tính năng tạo mặt nạ trường đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, nhờ đó tránh được thời gian xử lý và các khoản phí thanh toán không cần thiết.
Để biết thêm thông tin, hãy xem phần Chọn các trường cần trả về. |
| Direction API API Ma trận khoảng cách |
Trả về danh sách các trường mặc định, ngay cả khi ứng dụng của bạn không thực sự cần các trường đó. Điều này có thể dẫn đến thời gian xử lý và các khoản phí thanh toán không cần thiết. |
Tính toán tuyến đường nâng cao cho giao thông
API Tuyến hỗ trợ 3 lựa chọn ưu tiên về định tuyến mà bạn có thể dùng để cân bằng giữa độ trễ phản hồi và chất lượng dữ liệu khi yêu cầu thông tin về lưu lượng truy cập.
Để biết thêm thông tin, hãy xem bài viết Định cấu hình chất lượng và độ trễ.
TRAFFIC_UNAWARE (mặc định) |
Sử dụng dữ liệu lưu lượng truy cập trung bình không phụ thuộc vào thời gian, chứ không phải dữ liệu lưu lượng truy cập trực tiếp, để tính toán tuyến đường, mang lại độ trễ phản hồi thấp nhất. Chế độ cài đặt này tương đương với khi không sử dụng lưu lượng truy cập trong API hướng dẫn và API ma trận từ xa. |
TRAFFIC_AWARE (mới) |
Chất lượng lưu lượng truy cập trực tiếp được tối ưu hoá cho hiệu suất để giảm độ trễ. Trái ngược với TRAFFIC_AWARE_OPTIMAL, chế độ cài đặt này áp dụng các biện pháp tối ưu hoá để giảm đáng kể độ trễ.
Chế độ cài đặt này cũng là chế độ mới đối với Routes API (API Tuyến đường) mà không có chế độ cài đặt tương đương trong Navigation API (API Chỉ đường) hoặc Distance Matrix API (API Ma trận khoảng cách).
|
TRAFFIC_AWARE_OPTIMAL |
Dữ liệu lưu lượng truy cập toàn diện, chất lượng cao. Chế độ cài đặt này tạo ra độ trễ cao nhất và tương đương với chế độ cài đặt departure_time trong API Chỉ dẫn và API Ma trận từ xa. Lựa chọn ưu tiên này tương đương với chế độ được maps.google.com và ứng dụng Google Maps sử dụng cho thiết bị di động. |
So sánh số liệu tính toán tuyến đường
Bảng sau đây so sánh các tuỳ chọn định tuyến giữa Routes API và dịch vụ Directions API và Distance Matrix API.
| Lựa chọn giao thông | Routes API | Direction API API Ma trận khoảng cách |
Độ trễ |
|---|---|---|---|
| Không có thông tin giao thông theo thời gian thực | TRAFFIC_UNAWARE |
Chưa đặt thuộc tính departure_time |
Độ trễ nhanh nhất trong 3 chế độ. |
| Đã áp dụng tình trạng giao thông trực tiếp | TRAFFIC_AWARE |
Không có phiên bản mới | Chế độ mới do API Tuyến đường thêm vào. API này có độ trễ lớn hơn một chút so với API này có độ trễ thấp hơn nhiều so với |
| Đã áp dụng dữ liệu lưu lượng truy cập trực tiếp toàn diện, chất lượng cao | TRAFFIC_AWARE_OPTIMAL |
Đã đặt thuộc tính departure_time |
Tương đương với chế độ được maps.google.com và ứng dụng Google Maps dành cho thiết bị di động sử dụng. Đối với Ma trận định tuyến tính toán, số lượng phần tử trong một yêu cầu (số nguồn gốc × số lượng đích đến) không được vượt quá 100. |
Điểm khác biệt chính
Phần này trình bày những điểm khác biệt chính giữa API Tuyến và các dịch vụ mà API này thay thế, cùng với cách bạn có thể giải quyết những khác biệt này khi di chuyển từ các dịch vụ này trong các ứng dụng hiện có.
Gọi một thay vì hai dịch vụ
| API Tuyến đường | Chỉ bật một dịch vụ trong Bảng điều khiển API để ứng dụng của bạn sử dụng Tuyến điện toán và Ma trận tuyến tính toán.
Để biết thêm thông tin, hãy xem phần Thiết lập trong Bảng điều khiển API của Google. |
| Direction API API Ma trận khoảng cách |
Bật 2 dịch vụ: API hướng dẫn và API ma trận khoảng cách dưới dạng các dịch vụ riêng biệt trong Bảng điều khiển API. |
Sử dụng HTTPS POST yêu cầu
| API Tuyến đường | Truyền các tham số vào nội dung yêu cầu hoặc trong tiêu đề theo yêu cầu HTTP POST. Để xem các ví dụ, hãy xem bài viết: – Tính toán một tuyến đường – Tính toán ma trận tuyến đường |
| Direction API API Ma trận khoảng cách |
Truyền tham số URL bằng yêu cầu HTTP GET. |
Sự khác biệt về phản hồi ETA
Routes API trả về thời gian đến dự kiến và sử dụng thuộc tính phản hồi duration khác với dịch vụ API hướng dẫn và API ma trận khoảng cách như trình bày trong bảng bên dưới.
| Loại giờ đến dự kiến | Routes API | Direction API API Ma trận khoảng cách |
|---|---|---|
| ETA không biết về lưu lượng truy cập, không phụ thuộc vào thời gian. | Đặt bằng
|
Tương ứng với
|
| ETA xem xét lưu lượng truy cập theo thời gian thực. | Đặt bằng
|
Đặt bằng
|
Điểm tham chiếu hình nhiều đường
Với dịch vụ này, bạn không cần phải chuyển đổi vĩ độ/kinh độ thành các điểm nhiều đường. Dịch vụ này hỗ trợ nội dung yêu cầu POST và do đó không còn bị ảnh hưởng bởi các giới hạn chuỗi URL. Một số người dùng API Ma trận khoảng cách đã giải quyết vấn đề giới hạn yêu cầu bằng cách chuyển đổi các điểm vĩ độ/kinh độ thành các điểm tham chiếu nhiều đường.
Địa chỉ được định dạng (ngược mã địa lý)
API Tuyến đường không cung cấp địa chỉ được định dạng trong phản hồi. Để nhận các địa chỉ được định dạng, hãy sử dụng API Mã hoá địa lý được xây dựng cho trường hợp sử dụng này và cung cấp kết quả có chất lượng cao hơn.
Các phương tiện đi lại có thể sử dụng
Tương tự như với API hướng dẫn, API tuyến đường sử dụng DRIVE làm chế độ mặc định khi yêu cầu về tuyến đường không chỉ định phương tiện đi lại. Tuy nhiên, khi một yêu cầu chỉ định một phương tiện đi lại cho một tuyến đường, API tuyến đường sẽ không trả về một loạt các phương tiện đi lại có sẵn làm lựa chọn thay thế cho yêu cầu. Nếu trường hợp sử dụng của bạn cần đến tính năng này, hãy gửi vấn đề đến cách bạn sử dụng tính năng để chúng tôi có thể liên hệ lại với bạn.
XML làm định dạng phản hồi
API Tuyến không cung cấp XML làm định dạng phản hồi. Bạn có thể tìm trực tuyến một số trình chuyển đổi JSON sang XML phù hợp với mục đích của mình.