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,
  "polylineDetails": {
    object (PolylineDetails)
  }
}

enum (RouteLabel)

Nhãn cho Route hữu ích để 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 đường khác.

object (RouteLeg)

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

integer

Quãng đường đ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 theo tuyến đường. Nếu bạn đặt 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, có 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 theo 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, có 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 của tuyến đường tổng thể. Đường đa tuyến này là đường đa tuyến kết hợp của tất cả legs.

string

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

string

Một mảng cảnh báo sẽ hiển thị khi hiển thị tuyến đường.

object (Viewport)

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

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

object (RouteLocalizedValues)

Biểu diễn văn bản của các thuộc tính của Route.

string

Mã thông báo mờ có thể được truyền đến Navigation SDK để tái tạo tuyến đường trong quá trình điều hướng và trong trường hợp định tuyến lại, hãy tuân thủ ý định ban đầu khi tạo tuyến đường. Xem mã thông báo này là một blob mờ. Đừng so sánh giá trị của thuộc tính này trên các yêu cầu vì giá trị của thuộc tính này có thể thay đổi ngay cả khi dịch vụ trả về cùng một tuyến.

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 trung gian Via.

object (PolylineDetails)

Chứa thông tin về các chi tiết dọc theo đường đa tuyến.

{
  "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 đường, tính bằng mét.

string (Duration format)

Khoảng thời gian cần thiết để di chuyển chặng bay. 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 toán dựa trên điều kiện giao thông.

Thời lượng tính bằng giây, có 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ặng, đượ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, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

object (Polyline)

Đường đa tuyến tổng thể cho chặng này bao gồm đường đa tuyến của mỗi step.

object (Location)

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

object (Location)

Vị trí kết thúc của chặng này. Vị trí này có thể khác với destination đã cung cấp. Ví dụ: khi destination được cung cấp không ở gần đườ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ặng này. Mỗi bước đại diện cho một hướng dẫn điều hướng.

object (RouteLegTravelAdvisory)

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ế có thể có trong khu vực giao thông, trên một chặng đường.

object (RouteLegLocalizedValues)

Biểu diễn văn bản của 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 PHƯƠNG TIỆN CÔNG CỘNG.

{

  // 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 của đa tuyến bằng thuật toán mã hoá đa tuyến

object (Struct format)

Chỉ định một đa tuyến bằ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

Quãng đường 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, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

object (Polyline)

Đường đa tuyến 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 điều hướng.

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ế có thể có đối với khu vực giao thông, trong một bước của chặng.

object (RouteLegStepLocalizedValues)

Biểu diễn văn bản của 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 chế độ đi lại là TRANSIT.

enum (RouteTravelMode)

Phương thức di chuyển được sử dụng cho bước này.

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

enum (Maneuver)

Đóng gói các hướng dẫn điều hướng cho bước hiện tại (ví dụ: rẽ trái, nhập 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 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 sẵn.

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

object (LocalizedText)

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

object (LocalizedText)

Thời lượng mà không xem xét đến điều kiện lưu lượng truy cập, đượ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 đến và điểm khởi hành của bước.

object (TransitDetailsLocalizedValues)

Biểu diễn văn bản của các thuộc tính của RouteLegStepTransitDetails.

string

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

string (Duration format)

Chỉ định thời gian dự kiến dưới dạng thời lượng 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ị khoảng thời gian giữa các chuyến xe là 600 giây, bạn sẽ phải chờ 10 phút nếu lỡ chuyến xe buýt.

Thời lượng tính bằng giây, có 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ề tuyến phương tiện công cộng đượ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 đến. Số lượng này bao gồm điểm dừng đến nhưng không bao gồm điểm dừng khởi hành. Ví dụ: nếu tuyến xe buýt của bạn khởi hành từ Bến A, đi qua Bến B và C rồi đến Bến D,

stopCount

trả về 3.

string

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

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

object (TransitStop)

Thông tin về điểm dừng đến của bước.

string (Timestamp format)

Thời gian đến dự kiến của bước.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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 của bước.

string (Timestamp format)

Thời gian khởi hành ước tính cho bước này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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 phương tiện công cộng.

object (Location)

Vị trí của trạm dừng được biểu thị bằng toạ độ vĩ độ/kinh độ.

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

object (LocalizedTime)

Thời gian được thể hiện dưới dạng văn bản được định dạng với múi giờ tương ứng.

object (LocalizedTime)

Thời gian được thể hiện dưới dạng văn bản được định dạng 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 một chuỗi theo múi giờ nhất định.

string

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

{
  "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 vận tải) vận hành tuyến phương tiện công cộng này.

string

Tên đầy đủ của tuyến phương tiện công cộng này. Ví dụ: "8 Avenue Local".

string

URI cho tuyến phương tiện công cộng này do công ty vận tải cung cấp.

string

Màu sắc thường dùng trong biển báo cho tuyến đườ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 tuyến phương tiện công cộng này. Tên này thường là số dòng, chẳng hạn như "M7" hoặc "355".

string

Màu thường dùng trong văn bản trên biển báo cho tuyến 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 tuyến phương tiện công cộng 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ủa công ty vận tải công cộng được định dạng theo ngôn ngữ của địa phương.

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 xe này, viết hoa.

enum (TransitVehicleType)

Loại xe được sử dụng.

string

URI cho một 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 xe này, dựa trên biển báo phương tiện giao thông địa phương.

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

object (TollInfo)

Chứa thông tin về phí cầu đường trên RouteLeg cụ thể. Trường này chỉ được điền nếu chúng tôi dự kiến có đường thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng không điền trường phụ estimatedPrice, thì chúng tôi cho rằng đường đó có thu phí 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ì không có phí cầu đường trên RouteLeg.

object (SpeedReadingInterval)

Khoảng thời gian đọc nhanh 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 ưu tiên định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao phủ toàn bộ đường đa tuyến của RouteLeg mà không bị chồng chéo. Điểm bắt đầu của một 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 di chuyển được thể hiện ở dạng văn bản.

object (LocalizedText)

Thời lượng, được biểu thị ở dạng văn bản và được bản địa hoá theo khu vực của cụm từ tìm kiếm. Cân nhắc tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin về lưu lượng truy cập, thì giá trị này sẽ giống với staticDuration.

object (LocalizedText)

Thời lượng mà không xem xét đến điều kiện lưu lượng truy cập, đượ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 không được điền nếu RouteLeg không chứa bất kỳ phân đoạn đa phương thức nào trong các bước.

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

object (NavigationInstruction)

NavigationInstruction cho phân đoạn đa phương thức.

enum (RouteTravelMode)

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

integer

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

integer

Chỉ mục RouteLegStep tương ứng là phần cuối của một 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 di chuyển được thể hiện ở dạng văn bản.

object (LocalizedText)

Thời lượng, được biểu thị ở dạng văn bản và được bản địa hoá theo khu vực của cụm từ tìm kiếm. Cân nhắc tình trạng giao thông. 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 staticDuration.

object (LocalizedText)

Thời lượng mà không xem xét đến điều kiện lưu lượng truy cập, đượ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.

{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}

object (FlyoverInfo)

Thông tin chi tiết về đường bay dọc theo đường đa tuyến.

object (NarrowRoadInfo)

Thông tin chi tiết về đường hẹp dọc theo đường đa tuyến.

{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}

enum (RoadFeatureState)

Chỉ có đầu ra. Cho biết liệu có cầu vượt cho một đoạn đường đa tuyến nhất định hay không.

object (PolylinePointIndex)

Vị trí của thông tin liên quan đến chế độ xem đường bay dọc theo đường đa tuyến.

{
  "startIndex": integer,
  "endIndex": integer
}

integer

Chỉ mục bắt đầu của chi tiết này trong đường đa tuyến.

integer

Chỉ mục kết thúc của chi tiết này trong đường đa tuyến.

{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}

enum (RoadFeatureState)

Chỉ có đầu ra. Cho biết liệu có một con đường hẹp cho một đoạn đường cụ thể của đường đa tuyến hay không.

object (PolylinePointIndex)

Vị trí của thông tin liên quan đến đường hẹp dọc theo đường đa tuyến.

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

object (GeocodedWaypoint)

Điểm trung gian được mã hoá địa lý của điểm xuất phát.

object (GeocodedWaypoint)

Điểm trung gian được mã hoá địa lý của điểm đến.

object (GeocodedWaypoint)

Danh sách các điểm trung gian được mã hoá địa lý, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên số 0 của điểm trung gian 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 liên kết địa lý.

string

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

boolean

Cho biết trình dịch đị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ù có thể khớp một phần của địa chỉ được yêu cầu. Bạn nên kiểm tra yêu cầu ban đầu để xem có lỗi chính tả và/hoặc địa chỉ chưa hoàn chỉnh hay không.

string

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

integer

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