Tổng quan về lớp tuyến đường
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Giới thiệu
Lớp Route cung cấp phương thức computeRoutes
để trả về tuyến đường lý tưởng giữa hai vị trí. Cung cấp chỉ đường với thông tin giao thông theo thời gian thực cho phương tiện công cộng, xe đạp, xe ô tô, xe cơ giới 2 bánh hoặc đi bộ giữa nhiều vị trí.
Bạn cần ma trận tuyến đường? Nếu bạn quan tâm đến ma trận tuyến đường, hãy xem Tổng quan về lớp Ma trận tuyến đường.
Bạn có đang di chuyển không? Nếu bạn đang di chuyển từ Directions Service (Legacy) sang lớp Route
, hãy xem phần Di chuyển sang lớp Route.
Tại sao nên sử dụng lớp Route?
Với lớp Route
, bạn có thể định tuyến cho xe hoặc gói hàng theo ý muốn trong khi tối ưu hoá chi phí và chất lượng nhờ nhiều thông tin chi tiết về tuyến đường.
Bạn có thể làm gì với lớp Route?
Phương thức computeRoutes
trả về tuyến đường lý tưởng giữa hai vị trí. Với thư viện Tuyến đường, bạn có thể làm những việc sau:
- Xem đường đi cho nhiều cách di chuyển:
- Phương tiện di chuyển: phương tiện công cộng, lái xe, xe hai bánh, đi bộ hoặc đi xe đạp.
- Một loạt các điểm tham chiếu mà bạn có thể tối ưu hoá để có được thứ tự hiệu quả nhất khi di chuyển đến các điểm đó.
- Sử dụng nhiều cách để chỉ định điểm xuất phát, điểm đến và điểm tham chiếu:
- Chuỗi văn bản. Ví dụ: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" hoặc "CWF6+FWX Mountain View, California"
- Thực thể địa điểm
- Toạ độ vĩ độ và kinh độ, có thể kèm theo hướng di chuyển của xe
- Điều chỉnh các lựa chọn cho tuyến đường dựa trên nhu cầu và mục tiêu của bạn:
- Chọn tuyến đường tiết kiệm nhiên liệu hoặc năng lượng theo loại động cơ xe của bạn: Dầu diesel, Điện, Kết hợp, Xăng.
- Thiết lập các lựa chọn chi tiết để tính toán lưu lượng truy cập, cho phép bạn đưa ra quyết định đánh đổi giữa chất lượng và độ trễ.
- Đặt hướng di chuyển của xe và thông tin về phía đường cho các điểm tham chiếu để tăng độ chính xác của thời gian đến dự kiến.
- Chỉ định vị trí đi qua so với vị trí cuối và vị trí dừng chân an toàn.
- Yêu cầu thông tin về phí cầu đường, cùng với khoảng cách và thời gian đến dự kiến của tuyến đường.
- Kiểm soát độ trễ và chất lượng bằng cách chỉ yêu cầu dữ liệu bạn cần bằng cách sử dụng mặt nạ trường. Điều này giúp bạn tránh thời gian xử lý không cần thiết và mức tính phí yêu cầu cao hơn.
Các bước tiếp theo
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n[](/maps/documentation/javascript/routes/demo)\n\nIntroduction\n\nThe Route class provides the `computeRoutes` method for returning the ideal\nroute between two locations. Provide directions with real-time traffic for transit,\nbiking, driving, 2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Route Matrix class overview](/maps/documentation/javascript/routes/route-matrix-class-overview).\n\n**Migrating?** If you are migrating from the Directions Service (Legacy)\nto the `Route` class, see\n[Migrate to the Route class](/maps/documentation/javascript/routes/routes-js-migration).\n\nWhy use the Route class?\n\nWith the `Route` class, with a wide range of route details you can\nroute your vehicles or packages according to your preferences while optimizing for cost and\nquality.\n\nWhat can you do with the Route class?\n\nThe `computeRoutes` method returns the ideal route between two\nlocations. With the Routes library, you can do the following things:\n\n- **Get directions for different ways to travel** :\n - Modes of transportation: transit, driving, two-wheel vehicles, walking, or bicycling.\n - A series of waypoints that you can optimize for the most efficient order in which to travel to them.\n- **Use multiple ways to specify origins, destinations, and waypoints** :\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800 Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain View, California\"\n - Place instances\n - Latitude and longitude coordinates, optionally with vehicle heading\n- **Fine-tune your route options** based on your needs and goals:\n - Select fuel or energy-efficient routes for your vehicle's engine type: Diesel, Electric, Hybrid, Gas.\n - Set fine-grained options for traffic calculation, letting you make quality versus latency trade off decisions.\n - Set vehicle heading (direction of travel) and side-of-road information for waypoints to increase ETA accuracy.\n - Specify pass-through versus terminal locations and safe stopover locations.\n - Request toll information, along with route distance and ETA.\n- **Control your latency and quality** by requesting only the data you need using a field mask, which helps you avoid unnecessary processing time and higher request billing rates.\n\nNext steps\n\n- [Try the demo](/maps/documentation/javascript/routes/demo)\n- [Get started](/maps/documentation/javascript/routes/start)\n- [Get a route](/maps/documentation/routes/get-a-route)\n- [Reference documentation](/maps/documentation/javascript/reference/route)"]]