Làm việc với đường nhiều đoạn

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Phương thức computeRoutes trả về tuyến đường được biểu thị bằng một đường nhiều đường trong phản hồi. Bạn có thể yêu cầu hai loại đường nhiều đoạn:

  • Đường nhiều đường cơ bản (mặc định), biểu thị một tuyến đường nhưng không có thông tin giao thông được nhúng trong đường nhiều đường. Những yêu cầu trả về một đường nhiều đoạn cơ bản sẽ được tính phí theo mức giá của tuyến đường cơ bản. Tìm hiểu thêm về việc thanh toán cho Routes API.
  • Đường nhiều đoạn có tính năng nhận biết tình trạng giao thông, chứa thông tin về tình trạng giao thông dọc theo tuyến đường. Tình trạng giao thông được thể hiện bằng các danh mục tốc độ (NORMAL, SLOW, TRAFFIC_JAM) áp dụng cho một khoảng thời gian nhất định của đường đa tuyến. Các yêu cầu về đường nhiều đoạn có nhận biết lưu lượng truy cập được tính phí theo mức giá của tuyến đường ưu tiên. Tìm hiểu thêm về việc thanh toán cho Routes API.
  • Đường nhiều đoạn đa phương thức, chứa thông tin chi tiết về phương tiện công cộng cũng như thông tin về giao thông. Các yêu cầu về đường nhiều đoạn đa phương thức được tính phí theo mức giá của tuyến đường ưu tiên. Tìm hiểu thêm về việc thanh toán cho Routes API.

Đường cơ bản (mặc định)

Đường nhiều đoạn được biểu thị bằng một đối tượng Polyline; đường dẫn là một mảng gồm các toạ độ LatLngAltitude. Để trả về một đường nhiều đoạn cơ bản, hãy gọi phương thức computeRoutes với thuộc tính fields được đặt thành path, sau đó gọi phương thức createPolylines trên thực thể tuyến đường để lấy một đối tượng Polyline.

Ví dụ sau đây cho thấy cách yêu cầu một đường nhiều đoạn cơ bản:

// Define a basic routes request.
const requestWithBasicPolyline = {
  origin: '155 Steuart St, San Francisco, CA 94105',
  destination: '450 Powell St, San Francisco, CA 94102',
  travelMode: 'WALKING',
  fields: ['path'],  // Request path field to get a polyline.
};

Đường nhiều đoạn có thông tin giao thông

Để yêu cầu một đường nhiều đoạn có thông tin giao thông, hãy thêm các thuộc tính sau vào yêu cầu của bạn:

  1. Đặt thuộc tính travelMode thành DRIVING.
  2. Đặt thuộc tính routingPreference thành TRAFFIC_AWARE.
  3. Đặt thuộc tính extraComputations thành TRAFFIC_ON_POLYLINE.
  4. Chỉ định các trường path, speedPaths và routeLabels.

Ví dụ sau đây minh hoạ cách yêu cầu một đường nhiều đoạn có nhận biết lưu lượng truy cập:

// Define a traffic aware routes request.
const requestWithTraffic = {
  origin: '200 King St San Francisco, CA 94107',
  destination: 'Pier 41, San Francisco, CA 94133',
  travelMode: 'DRIVING',
  routingPreference: 'TRAFFIC_AWARE',
  extraComputations: ['TRAFFIC_ON_POLYLINE'],
  fields: ['speedPaths'],
};

Hiển thị nhiều đường trên bản đồ

Để hiển thị đường nhiều đoạn trên bản đồ, hãy gọi createPolylines trên đối tượng tuyến đường, sau đó sử dụng phương thức setMap để đặt bản đồ của đường nhiều đoạn thành đối tượng bản đồ. Đối tượng bản đồ được dùng để hiển thị đường nhiều đoạn trên bản đồ.

Ví dụ sau đây minh hoạ cách hiện một đường nhiều đoạn trên bản đồ:

  // Call createPolylines to create polylines for the first route.
  mapPolylines = routes[0].createPolylines();
  // Add polylines to the map.
  mapPolylines.forEach((polyline) => polyline.setMap(map));