Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum (RouteLabel)

Các nhãn cho Route rất hữu ích trong việc xác định các thuộc tính cụ thể của tuyến đường để so sánh với các tuyến khác.

object (RouteLeg)

Một tập hợp các chân (đoạn đường dẫn giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai chặng không phải là via Waypoints. Ví dụ: tuyến đường không có điểm trung gian chỉ có một chặng. Tuyến đường có một điểm tham chiếu trung gian không phải via có hai chân. Tuyến đường có một điểm tham chiếu trung gian via có một chân. Thứ tự của các chân khớp với thứ tự của các điểm tham chiếu từ origin đến intermediates đến destination.

integer

Khoảng cách đi lại của tuyến đường, tính bằng mét.

string (Duration format)

Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập routingPreference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với staticDuration. Nếu bạn đặt routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

string (Duration format)

Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

object (Polyline)

Hình nhiều đường chung của tuyến đường. Hình nhiều đường này là hình nhiều đường kết hợp của tất cả legs.

string

Nội dung mô tả về tuyến đường.

string

Một mảng các cảnh báo sẽ xuất hiện khi cho thấy tuyến đường.

object (Viewport)

Hộp giới hạn khung nhìn của hình nhiều đường.

object (RouteTravelAdvisory)

Thông tin bổ sung về tuyến đường.

integer

Nếu bạn đặt optimizeWaypointOrder thành true, trường này sẽ chứa thứ tự được tối ưu hoá của các điểm tham chiếu trung gian. Nếu không, trường này trống. Ví dụ: nếu bạn cung cấp dữ liệu đầu vào là Origin: LA; Điểm tham chiếu trung gian: Dallas, Bangor, Phoenix; Destination: New York; và thứ tự điểm tham chiếu được tối ưu hoá là Phoenix, Dallas, Bangor, thì trường này chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm tham chiếu trung gian đầu tiên được cung cấp trong đầu vào.

object (RouteLocalizedValues)

Văn bản đại diện cho các thuộc tính của Route.

string

Mã thông báo tuyến đường được mã hoá base64 an toàn cho web, có thể được chuyển đến SDK điều hướng, cho phép SDK điều hướng tạo lại tuyến đường trong khi điều hướng và trong trường hợp định tuyến lại, hãy thực hiện ý định ban đầu khi bạn tạo tuyến đường bằng cách gọi v2.computeRoutes. Khách hàng nên coi mã thông báo này là một blob mờ. Tệp này không nhằm mục đích đọc hoặc thay đổi. LƯU Ý: Route.route_token chỉ dùng được cho các yêu cầu đã đặt ComputeRoutesRequest.routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL. Route.route_token không được hỗ trợ cho các yêu cầu có Điểm tham chiếu.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

Khoảng cách di chuyển của chặng tuyến đường, tính bằng mét.

string (Duration format)

Khoảng thời gian cần thiết để di chuyển chân. Nếu bạn đặt route_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với staticDuration. Nếu route_preference là TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính có tính đến điều kiện lưu lượng truy cập.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

string (Duration format)

Thời gian di chuyển qua chân, được tính toán mà không tính đến tình trạng giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

object (Polyline)

Hình nhiều đường chung cho chân này bao gồm hình nhiều đường của mỗi step.

object (Location)

Vị trí bắt đầu của chân này. Vị trí này có thể khác với origin được cung cấp. Ví dụ: khi origin được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.

object (Location)

Vị trí kết thúc của chân này. Vị trí này có thể khác với destination được cung cấp. Ví dụ: khi destination được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.

object (RouteLegStep)

Một mảng các bước biểu thị các phân đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn di chuyển.

object (RouteLegTravelAdvisory)

Chứa thông tin bổ sung mà người dùng phải được thông báo, chẳng hạn như các khu vực hạn chế giao thông có thể xảy ra ở một chặng của tuyến đường.

object (RouteLegLocalizedValues)

Văn bản đại diện cho các thuộc tính của RouteLeg.

object (StepsOverview)

Thông tin tổng quan về các bước trong RouteLeg này. Trường này chỉ được điền sẵn cho các tuyến đường TRANSIT.

{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}

string

Mã hoá chuỗi cho hình nhiều đường bằng thuật toán mã hoá nhiều đường

object (Struct format)

Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoJSON LineString.

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

Khoảng cách di chuyển của bước này (tính bằng mét). Trong một số trường hợp, trường này có thể không có giá trị.

string (Duration format)

Thời gian di chuyển qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

object (Polyline)

Hình nhiều đường liên kết với bước này.

object (Location)

Vị trí bắt đầu của bước này.

object (Location)

Vị trí kết thúc của bước này.

object (NavigationInstruction)

Hướng dẫn di chuyển.

object (RouteLegStepTravelAdvisory)

Chứa thông tin bổ sung mà người dùng cần được thông báo (chẳng hạn như các quy định hạn chế về vùng giao thông có thể xảy ra) ở bước chân.

object (RouteLegStepLocalizedValues)

Văn bản đại diện cho các thuộc tính của RouteLegStep.

object (RouteLegStepTransitDetails)

Thông tin chi tiết liên quan đến bước này nếu phương tiện đi lại là TRANSIT.

enum (RouteTravelMode)

Phương tiện đi lại dùng cho bước này.

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

Đóng gói hướng dẫn điều hướng cho bước hiện tại (ví dụ: rẽ trái, hợp nhất hoặc đi thẳng). Trường này xác định biểu tượng nào sẽ hiển thị.

string

Hướng dẫn cách thực hiện bước này.

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

LƯU Ý: Trường này hiện chưa được điền.

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

Quãng đường đi được thể hiện dưới dạng văn bản.

object (LocalizedText)

Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản.

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object (TransitStopDetails)

Thông tin về điểm dừng đến và đi cho bước này.

object (TransitDetailsLocalizedValues)

Văn bản đại diện cho các thuộc tính của RouteLegStepTransitDetails.

string

Xác định hướng di chuyển trên tuyến đường này (được đánh dấu trên xe hoặc tại điểm khởi hành). Hướng thường là ga cuối.

string (Duration format)

Chỉ định thời gian dự kiến là khoảng thời gian giữa các chuyến khởi hành từ cùng một điểm dừng tại thời điểm này. Ví dụ: với giá trị số giây phía trước là 600, bạn sẽ phải chờ 10 phút nếu lỡ xe buýt.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

object (TransitLine)

Thông tin về đường chuyển tuyến được sử dụng trong bước này.

integer

Số điểm dừng từ điểm khởi hành đến điểm dừng đến. Con số này bao gồm điểm dừng đến, nhưng không bao gồm điểm khởi hành. Ví dụ: nếu tuyến đường của bạn khởi hành từ Trạm dừng A, đi qua điểm dừng B và C, và đến điểm dừng D, thì StopCount sẽ trả về giá trị 3.

string

Văn bản xuất hiện trong lịch trình và biển hiệu để xác định chuyến đi bằng phương tiện công cộng của hành khách. Văn bản này phải xác định duy nhất một chuyến đi trong một ngày sử dụng dịch vụ. Ví dụ: "538" là tripShortText của chuyến tàu Amtrak khởi hành từ San Jose, CA lúc 15:10 các ngày trong tuần đến đó, California.

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

Thông tin về điểm dừng đến cho bước này.

string (Timestamp format)

Thời gian đến dự kiến cho bước này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (TransitStop)

Thông tin về điểm dừng khởi hành cho bước này.

string (Timestamp format)

Thời gian khởi hành dự kiến cho bước này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

Tên của điểm dừng chuyển tuyến.

object (Location)

Vị trí của điểm dừng được thể hiện bằng vĩ độ/kinh độ.

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng.

object (LocalizedTime)

Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

Thời gian được chỉ định dưới dạng chuỗi theo múi giờ đã cho.

string

Chứa múi giờ. Giá trị là tên của múi giờ như được xác định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_Israel".

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

Công ty vận tải (hoặc các công ty quảng cáo) điều hành đường chuyển tuyến này.

string

Tên đầy đủ của đường chuyển tuyến này, ví dụ: "8 Avenue Local".

string

URI cho đường chuyển tuyến này do công ty vận tải cung cấp.

string

Màu sắc thường được sử dụng trong bảng hiệu cho đường này. Được biểu thị bằng hệ thập lục phân.

string

URI cho biểu tượng liên kết với dòng này.

string

Tên ngắn của đường chuyển tuyến này. Tên này thường là số dòng, chẳng hạn như "M7" hoặc "355".

string

Màu sắc thường được sử dụng trong văn bản trên bảng hiệu cho dòng này. Được biểu thị bằng hệ thập lục phân.

object (TransitVehicle)

Loại phương tiện hoạt động trên đường chuyển tuyến này.

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

Tên của công ty vận tải này.

string

Số điện thoại có định dạng dành riêng cho từng khu vực của công ty vận tải.

string

URI của công ty vận tải.

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

Tên của chiếc xe này, được viết hoa.

enum (TransitVehicleType)

Loại phương tiện được sử dụng.

string

URI cho biểu tượng liên kết với loại xe này.

string

URI cho biểu tượng liên kết với loại phương tiện này, dựa trên biển hiệu phương tiện giao thông địa phương.

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

Chứa thông tin về việc thu phí cầu đường cụ thể trên RouteLeg. Trường này chỉ được điền nếu chúng ta cho rằng có phí cầu đường trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ Giá ước tính chưa được điền, chúng tôi dự kiến rằng con đường đó có phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu trường này không tồn tại thì RouteLeg sẽ không thu phí.

object (SpeedReadingInterval)

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn định tuyến ưu tiên của TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của RouteLeg mà không chồng chéo. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

Quãng đường đi được thể hiện dưới dạng văn bản.

object (LocalizedText)

Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, thì giá trị này sẽ giống với giá trị staticDuration.

object (LocalizedText)

Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản.

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

Thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của RouteLeg.steps. Trường này sẽ không được điền nếu RouteLeg không chứa phân đoạn đa phương thức trong các bước.

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

NavigationIn hướng dẫn cho phân đoạn đa phương thức.

enum (RouteTravelMode)

Phương thức đi lại của đoạn đa phương thức.

integer

Chỉ mục RouteLegStep tương ứng là điểm bắt đầu của phân khúc đa phương thức.

integer

Chỉ mục RouteLegStep tương ứng là phần cuối của phân đoạn đa phương thức.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Bắt buộc. Điểm thấp của khung nhìn.

object (LatLng)

Bắt buộc. Điểm cao của khung nhìn.

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

Quãng đường đi được thể hiện dưới dạng văn bản.

object (LocalizedText)

Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, thì giá trị này sẽ bằng với staticDuration.

object (LocalizedText)

Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản.

object (LocalizedText)

Giá vé phương tiện công cộng được thể hiện ở dạng văn bản.

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

Điểm tham chiếu được mã hoá địa lý tại nguồn gốc.

object (GeocodedWaypoint)

Điểm tham chiếu được mã hoá địa lý cho đích đến.

object (GeocodedWaypoint)

Danh sách các điểm tham chiếu được mã hoá địa lý trung gian, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên 0 của điểm tham chiếu theo thứ tự được chỉ định trong yêu cầu.

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

Cho biết mã trạng thái do thao tác mã hoá địa lý tạo ra.

string

(Các) loại kết quả, ở dạng 0 hoặc nhiều thẻ loại. Các loại được hỗ trợ: Loại địa chỉ và loại thành phần địa chỉ.

boolean

Cho biết rằng bộ mã hoá địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù bộ mã hoá có thể khớp với một phần địa chỉ được yêu cầu. Bạn có thể kiểm tra lỗi chính tả trong yêu cầu ban đầu và/hoặc địa chỉ chưa hoàn chỉnh.

string

Mã địa điểm cho kết quả này.

integer

Chỉ mục của điểm tham chiếu trung gian tương ứng trong yêu cầu. Chỉ được điền nếu điểm tham chiếu tương ứng là điểm tham chiếu trung gian.