Method: computeRoutes

Trả về tuyến đường chính cùng với các tuyến đường thay thế (không bắt buộc), dựa trên một tập hợp các điểm tham chiếu cuối và điểm tham chiếu trung gian.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định một mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách sử dụng tham số URL $fields hoặc fields, hoặc bằng cách sử dụng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề URL có sẵn). Giá trị này là một danh sách đường dẫn đến trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường.

Ví dụ: trong phương thức này:

  • Mặt nạ cho trường của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
  • Mặt nạ cho trường về thời lượng, khoảng cách và đường đa tuyến ở cấp tuyến đường (ví dụ về chế độ thiết lập sản xuất): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google không khuyến khích việc sử dụng mặt nạ cho trường phản hồi có ký tự đại diện (*) hoặc chỉ định mặt nạ cho trường ở cấp cao nhất (routes), vì:

  • Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm các chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
  • Chỉ chọn những trường bạn cần trong công việc sản xuất để đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi.
  • Chỉ chọn những trường bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượng mạng.

Yêu cầu HTTP

POST https://routes.googleapis.com/directions/v2:computeRoutes

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Trường
origin

object (Waypoint)

Bắt buộc. Điểm tham chiếu ban đầu.
destination

object (Waypoint)

Bắt buộc. Điểm tham chiếu trên đường đi.
intermediates[]

object (Waypoint)

Không bắt buộc. Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng lại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
travelMode

enum (RouteTravelMode)

Không bắt buộc. Chỉ định phương tiện giao thông.
routingPreference

enum (RoutingPreference)

Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng lựa chọn ưu tiên về định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên về định tuyến gây ra lỗi hoặc độ trễ quá dài, thì lỗi sẽ được trả về. Bạn chỉ có thể chỉ định lựa chọn này khi travelMode là DRIVE hoặc TWO_WHEELER. Nếu không, yêu cầu sẽ không thành công.
polylineQuality

enum (PolylineQuality)

Không bắt buộc. Chỉ định lựa chọn ưu tiên của bạn về chất lượng của đường nhiều đoạn.
polylineEncoding

enum (PolylineEncoding)

Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho đường nhiều đoạn.
departureTime

string (Timestamp format)

Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời gian bạn đưa ra yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định departureTime trong quá khứ khi RouteTravelMode được đặt thành TRANSIT. Bạn có thể xem các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước đó hoặc 100 ngày sau đó.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

Không bắt buộc. Thời gian đến. LƯU Ý: Trường này sẽ bị bỏ qua khi các yêu cầu chỉ định một RouteTravelMode khác với TRANSIT. Bạn có thể chỉ định departureTime hoặc arrivalTime, nhưng không được chỉ định cả hai. Bạn có thể xem các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước đó hoặc 100 ngày sau đó.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
computeAlternativeRoutes

boolean

Không bắt buộc. Chỉ định có tính toán các tuyến đường thay thế ngoài tuyến đường hay không. Không có tuyến đường thay thế nào được trả về cho các yêu cầu có điểm tham chiếu trung gian.
routeModifiers

object (RouteModifiers)

Không bắt buộc. Một nhóm các điều kiện cần đáp ứng ảnh hưởng đến cách tính toán tuyến đường.
languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem bài viết Mã nhận dạng ngôn ngữ theo chuẩn Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu về tuyến đường.
regionCode

string

Không bắt buộc. Mã vùng, được chỉ định dưới dạng giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem bài viết Miền cấp cao nhất theo mã quốc gia.
units

enum (Units)

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Các trường này bao gồm trường instruction trong NavigationInstruction. Giá trị này không ảnh hưởng đến các đơn vị đo lường được dùng cho tuyến đường, chặng đường, khoảng cách bước và thời lượng. Nếu bạn không cung cấp giá trị này, thì các đơn vị hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.
optimizeWaypointOrder

boolean

Không bắt buộc. Nếu bạn đặt thành true, dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến đường bằng cách sắp xếp lại các điểm tham chiếu trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu có bất kỳ điểm tham chiếu trung gian nào là điểm tham chiếu via. Sử dụng ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index để tìm thứ tự mới. Nếu ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index không được yêu cầu trong tiêu đề X-Goog-FieldMask, thì yêu cầu sẽ không thành công. Nếu bạn đặt optimizeWaypointOrder thành false, ComputeRoutesResponse.optimized_intermediate_waypoint_index sẽ trống.
requestedReferenceRoutes[]

enum (ReferenceRoute)

Không bắt buộc. Chỉ định những tuyến đường tham chiếu cần tính toán trong yêu cầu ngoài tuyến đường mặc định. Tuyến đường tham chiếu là tuyến đường có mục tiêu tính toán tuyến đường khác với tuyến đường mặc định. Ví dụ: tính toán tuyến đường tham chiếu FUEL_EFFICIENT có tính đến nhiều thông số để tạo ra một tuyến đường tiết kiệm nhiên liệu tối ưu. Khi sử dụng tính năng này, hãy tìm biểu tượng routeLabels trên các tuyến đường kết quả.
extraComputations[]

enum (ExtraComputation)

Không bắt buộc. Danh sách các phép tính bổ sung có thể được dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong mặt nạ trường để được trả về trong phản hồi.
trafficModel

enum (TrafficModel)

Không bắt buộc. Chỉ định các giả định cần sử dụng khi tính toán thời gian di chuyển. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong Route và RouteLeg. Trường này chứa thời gian dự đoán khi có lưu lượng truy cập dựa trên mức trung bình trong quá khứ. TrafficModel chỉ dành cho những yêu cầu đã đặt RoutingPreference thành TRAFFIC_AWARE_OPTIMAL và RouteTravelMode thành DRIVE. Mặc định là BEST_GUESS nếu lưu lượng truy cập được yêu cầu và TrafficModel không được chỉ định.
transitPreferences

object (TransitPreferences)

Không bắt buộc. Chỉ định các lựa chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho các tuyến đường TRANSIT. LƯU Ý: Bạn chỉ có thể chỉ định một transitPreferences khi RouteTravelMode được đặt thành TRANSIT.

Nội dung phản hồi

v2.computeRoutes thông báo phản hồi.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Trường
routes[]

object (Route)

Chứa một mảng các tuyến đường đã tính toán (tối đa 3) khi bạn chỉ định compute_alternatives_routes và chỉ chứa một tuyến đường khi bạn không chỉ định. Khi mảng này chứa nhiều mục, mục đầu tiên là tuyến đường được đề xuất nhiều nhất. Nếu mảng này trống, tức là không tìm thấy tuyến đường nào.
fallbackInfo

object (FallbackInfo)

Trong một số trường hợp, khi máy chủ không thể tính toán kết quả về tuyến đường với tất cả các lựa chọn ưu tiên đầu vào, máy chủ có thể chuyển sang sử dụng một cách tính toán khác. Khi chế độ dự phòng được sử dụng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
geocodingResults

object (GeocodingResults)

Chứa thông tin phản hồi về mã hoá địa lý cho các điểm tham chiếu được chỉ định dưới dạng địa chỉ.

PolylineQuality

Một tập hợp các giá trị chỉ định chất lượng của đường nhiều đoạn.

Enum
POLYLINE_QUALITY_UNSPECIFIED Bạn chưa chỉ định lựa chọn ưu tiên về chất lượng đường nhiều đoạn. Giá trị mặc định là OVERVIEW.
HIGH_QUALITY Chỉ định một đường nhiều đoạn chất lượng cao – được tạo bằng nhiều điểm hơn OVERVIEW, với chi phí là tăng kích thước phản hồi. Hãy sử dụng giá trị này khi bạn cần độ chính xác cao hơn.
OVERVIEW Chỉ định một đường nhiều đoạn tổng quan được tạo thành từ một số ít điểm. Sử dụng giá trị này khi hiển thị thông tin tổng quan về tuyến đường. Khi sử dụng lựa chọn này, độ trễ yêu cầu sẽ thấp hơn so với khi sử dụng lựa chọn HIGH_QUALITY.

PolylineEncoding

Chỉ định loại đường nhiều đường ưu tiên sẽ được trả về.

Enum
POLYLINE_ENCODING_UNSPECIFIED Không chỉ định lựa chọn ưu tiên về loại đường nhiều đoạn. Giá trị mặc định là ENCODED_POLYLINE.
ENCODED_POLYLINE Chỉ định một đường nhiều đoạn được mã hoá bằng thuật toán mã hoá đường nhiều đoạn.
GEO_JSON_LINESTRING Chỉ định một đường nhiều đoạn bằng cách sử dụng định dạng GeoJSON LineString

ReferenceRoute

Một tuyến đường tham chiếu được hỗ trợ trên ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Không được dùng. Những yêu cầu có chứa giá trị này sẽ không thành công.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu.
SHORTER_DISTANCE

Tuyến đường có quãng đường di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

Đối với các yêu cầu DRIVE, tính năng này ưu tiên khoảng cách ngắn hơn so với sự thoải mái khi lái xe. Ví dụ: tính năng này có thể ưu tiên đường địa phương thay vì đường cao tốc, đi đường đất, đi qua bãi đỗ xe, v.v. Tính năng này không trả về bất kỳ thao tác nào mà Google Maps biết là bất hợp pháp.

Đối với các yêu cầu BICYCLE và TWO_WHEELER, tính năng này trả về các tuyến đường tương tự như các tuyến đường được trả về khi bạn không chỉ định requestedReferenceRoutes.

Tính năng này không tương thích với bất kỳ phương thức di chuyển nào khác, thông qua các điểm tham chiếu trung gian hoặc optimizeWaypointOrder; những yêu cầu như vậy sẽ không thành công. Tuy nhiên, bạn có thể sử dụng đối tượng này với bất kỳ routingPreference nào.

ExtraComputation

Các phép tính bổ sung cần thực hiện trong khi hoàn tất yêu cầu.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Không được dùng. Những yêu cầu có chứa giá trị này sẽ không thành công.
TOLLS Thông tin về phí cầu đường cho(các) tuyến đường.
FUEL_CONSUMPTION Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường.
TRAFFIC_ON_POLYLINE Đường nhiều đoạn có thông tin giao thông cho(các) tuyến đường.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions được trình bày dưới dạng một chuỗi văn bản HTML được định dạng. Nội dung này chỉ được dùng để hiển thị và không được chỉnh sửa. Đừng phân tích cú pháp theo phương thức lập trình.
FLYOVER_INFO_ON_POLYLINE Thông tin về đường trên cao cho(các) tuyến đường. Bạn phải chỉ định routes.polyline_details.flyover_info fieldmask để trả về thông tin này. Hiện tại, dữ liệu này sẽ chỉ được điền sẵn cho một số khu vực đô thị ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm và SKU/phí có thể thay đổi.
NARROW_ROAD_INFO_ON_POLYLINE Thông tin về đường hẹp cho(các) tuyến đường. Bạn phải chỉ định routes.polyline_details.narrow_road_info fieldmask để trả về thông tin này. Hiện tại, dữ liệu này sẽ chỉ được điền sẵn cho một số khu vực đô thị ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm và SKU/phí có thể thay đổi.

Tuyến đường

Chứa một tuyến đường, bao gồm một chuỗi các đoạn đường được kết nối với nhau, nối các điểm bắt đầu, điểm kết thúc và điểm tham chiếu trung gian.

Biểu diễn dưới dạng JSON 
{
  "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)
  }
}
Trường
routeLabels[]

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.
legs[]

object (RouteLeg)

Một tập hợp các đoạn đường (đoạn đường 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 via Waypoints. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian chỉ có một đoạn đường. Một tuyến đường có một điểm via trung gian không phải là điểm đến có hai chặng. Một tuyến đường có một điểm tham chiếu trung gian via sẽ có một chặng. Thứ tự của các chặng trùng khớp với thứ tự của các điểm tham chiếu từ origin đến intermediates đến destination.
distanceMeters

integer

Quãng đường di chuyển của tuyến đường, tính bằng mét.
duration

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 có 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".
staticDuration

string (Duration format)

Thời gian di chuyển trên 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".
polyline

object (Polyline)

Đường nhiều đường tổng thể của tuyến đường. Đường nhiều đoạn này là đường nhiều đoạn kết hợp của tất cả legs.
description

string

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

string

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

object (Viewport)

Hộp bao quanh khung nhìn của đường nhiều đường.
travelAdvisory

object (RouteTravelAdvisory)

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

integer

Nếu bạn đặt optimizeWaypointOrder thành true, thì 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 sẽ trống. Ví dụ: nếu bạn nhập Điểm xuất phát: Los Angeles; Điểm đến trung gian: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm đến 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 tham chiếu trung gian đầu tiên được cung cấp trong dữ liệu đầu vào.
localizedValues

object (RouteLocalizedValues)

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

string

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

LƯU Ý: Route.route_token chỉ dùng được cho những 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 đánh dấu Đường qua.
polylineDetails

object (PolylineDetails)

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

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.

Enum
ROUTE_LABEL_UNSPECIFIED Mặc định – không được dùng.
DEFAULT_ROUTE Tuyến đường "tốt nhất" mặc định được trả về cho quá trình tính toán tuyến đường.
DEFAULT_ROUTE_ALTERNATE Một lựa chọn thay thế cho tuyến đường "tốt nhất" mặc định. Những tuyến đường như thế này sẽ được trả về khi bạn chỉ định computeAlternativeRoutes.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu. Những tuyến đường được gắn nhãn bằng giá trị này được xác định là tuyến đường tối ưu hoá cho các thông số về Môi trường, chẳng hạn như mức tiêu thụ nhiên liệu.
SHORTER_DISTANCE Tuyến đường có khoảng cách di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

RouteLeg

Chứa một đoạn đường giữa các điểm đánh dấu không phải là via.

Biểu diễn dưới dạng JSON 
{
  "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)
  }
}
Trường
distanceMeters

integer

Quãng đường di chuyển của đoạn đường, tính bằng mét.
duration

string (Duration format)

Khoảng thời gian cần thiết để di chuyển trên chặng đường. Nếu route_preference được đặt 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 được tính có 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".
staticDuration

string (Duration format)

Thời gian di chuyển qua chặng đường, được tính mà không xem xét 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".
polyline

object (Polyline)

Đường nhiều đường tổng thể cho chặng này, bao gồm đường nhiều đường của từng step.
startLocation

object (Location)

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

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 mà bạn cung cấp. Ví dụ: khi destination được cung cấp không nằm gần đường, thì đây là một điểm trên đường.
steps[]

object (RouteLegStep)

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

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ó về khu vực giao thông, trên một đoạn đường.
localizedValues

object (RouteLegLocalizedValues)

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

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 CÔNG CỘNG.

Hình nhiều đường

Đóng gói một đường nhiều đường được mã hoá.

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường nhóm polyline_type. Đóng gói loại đường nhiều đường. Giá trị mặc định là encoded_polyline. polyline_type chỉ có thể là một trong những trạng thái sau:
encodedPolyline

string

Chuỗi mã hoá của đường nhiều đoạn bằng thuật toán mã hoá đường nhiều đoạn
geoJsonLinestring

object (Struct format)

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

RouteLegStep

Chứa một phân đoạn của RouteLeg. Một bước tương ứng với một chỉ dẫn điều hướng duy nhất. Các chặng đường bao gồm các bước.

Biểu diễn dưới dạng JSON 
{
  "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)
}
Trường
distanceMeters

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ị.
staticDuration

string (Duration format)

Thời gian di chuyển qua bước này mà không xét đế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".
polyline

object (Polyline)

Đường nhiều đoạn liên kết với bước này.
startLocation

object (Location)

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

object (Location)

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

object (NavigationInstruction)

Hướng dẫn cách đi theo chỉ dẫn.
travelAdvisory

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

object (RouteLegStepLocalizedValues)

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

object (RouteLegStepTransitDetails)

Thông tin chi tiết liên quan đến bước này nếu chế độ di chuyển là TRANSIT.
travelMode

enum (RouteTravelMode)

Phương tiện di chuyển được dùng cho bước này.

Maneuver

Một tập hợp các giá trị chỉ định hành động điều hướng cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, hợp nhất hoặc đi thẳng).

Enum
MANEUVER_UNSPECIFIED Không được dùng.
TURN_SLIGHT_LEFT Rẽ chếch sang trái.
TURN_SHARP_LEFT Rẽ trái đột ngột.
UTURN_LEFT Quay đầu sang trái.
TURN_LEFT Rẽ trái.
TURN_SLIGHT_RIGHT Rẽ chếch sang phải.
TURN_SHARP_RIGHT Rẽ ngoặt sang phải.
UTURN_RIGHT Quay đầu xe sang phải.
TURN_RIGHT Rẽ phải.
STRAIGHT Đi thẳng.
RAMP_LEFT Đi theo đường dẫn bên trái.
RAMP_RIGHT Đi vào đường dẫn bên phải.
MERGE Nhập vào dòng xe.
FORK_LEFT Đi theo ngã rẽ bên trái.
FORK_RIGHT Đi theo ngã rẽ bên phải.
FERRY Đi phà.
FERRY_TRAIN Đi tàu để lên phà.
ROUNDABOUT_LEFT Rẽ trái tại vòng xuyến.
ROUNDABOUT_RIGHT Đến vòng xuyến, hãy rẽ phải.
DEPART Thao tác ban đầu.
NAME_CHANGE Dùng để cho biết tên đường đã thay đổi.

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ể có đối với một bước trong chặng đường.

Biểu diễn dưới dạng JSON 
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Trường
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

Biểu diễn văn bản của một số thuộc tính.

Biểu diễn dưới dạng JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Trường
distance

object (LocalizedText)

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

object (LocalizedText)

Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.

RouteLegStepTransitDetails

Thông tin bổ sung cho RouteLegStep liên quan đến các tuyến đường TRANSIT.

Biểu diễn dưới dạng JSON 
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Trường
stopDetails

object (TransitStopDetails)

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

object (TransitDetailsLocalizedValues)

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

string

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

string (Duration format)

Chỉ định thời gian dự kiến dưới dạng 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ụ: nếu giá trị thời gian giữa các chuyến là 600 giây, thì 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".
transitLine

object (TransitLine)

Thông tin về tuyến phương tiện công cộng được dùng trong bước này.
stopCount

integer

Số điểm dừng từ điểm dừng khởi hành đến điểm dừng đế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 đi. Ví dụ: nếu tuyến đường của bạn bắt đầu từ Điểm dừng A, đi qua các điểm dừng B và C, rồi đến điểm dừng D,

stopCount

trả về 3.
tripShortText

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 này phải xác định duy nhất một chuyến đi trong một ngày dịch vụ. Ví dụ: "538" là tripShortText của 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.

TransitStopDetails

Thông tin chi tiết về các trạm dừng của phương tiện công cộng RouteLegStep.

Biểu diễn dưới dạng JSON 
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Trường
arrivalStop

object (TransitStop)

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

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
departureStop

object (TransitStop)

Thông tin về điểm dừng khởi hành của bước.
departureTime

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

TransitStop

Thông tin về một trạm dừng phương tiện công cộng.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "location": {
    object (Location)
  }
}
Trường
name

string

Tên của điểm dừng phương tiện công cộng.
location

object (Location)

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

TransitDetailsLocalizedValues

Nội dung mô tả được bản địa hoá về các giá trị cho RouteTransitDetails.

Biểu diễn dưới dạng JSON 
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Trường
arrivalTime

object (LocalizedTime)

Thời gian ở dạng văn bản được định dạng cùng với múi giờ tương ứng.
departureTime

object (LocalizedTime)

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

LocalizedTime

Nội dung mô tả được bản địa hoá về thời gian.

Biểu diễn dưới dạng JSON 
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Trường
time

object (LocalizedText)

Thời gian được chỉ định dưới dạng một chuỗi trong một múi giờ nhất định.
timeZone

string

Chứa múi giờ. Giá trị này 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_York".

TransitLine

Chứa thông tin về tuyến phương tiện công cộng được dùng trong bước này.

Biểu diễn dưới dạng JSON 
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Trường
agencies[]

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.
name

string

Tên đầy đủ của tuyến giao thông công cộng này, ví dụ: "8 Avenue Local".
uri

string

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

string

Màu 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.
iconUri

string

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

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ố hiệu tuyến, chẳng hạn như "M7" hoặc "355".
textColor

string

Màu thường dùng trong văn bản trên biển báo cho tuyến đường này. Được biểu thị bằng hệ thập lục phân.
vehicle

object (TransitVehicle)

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

TransitAgency

Công ty vận tải vận hành một tuyến đường của phương tiện công cộng.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Trường
name

string

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

string

Số điện thoại được định dạng theo ngôn ngữ cụ thể của cơ quan vận tải công cộng.
uri

string

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

TransitVehicle

Thông tin về một phương tiện được sử dụng trong các tuyến đường vận chuyển.

Biểu diễn dưới dạng JSON 
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Trường
name

object (LocalizedText)

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

enum (TransitVehicleType)

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

string

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

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 báo giao thông địa phương.

TransitVehicleType

Loại phương tiện cho các tuyến đường công cộng.

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Không sử dụng.
BUS Xe buýt.
CABLE_CAR Phương tiện hoạt động bằng cáp, thường là trên mặt đất. Cáp treo trên không có thể thuộc loại GONDOLA_LIFT.
COMMUTER_TRAIN Tàu chở khách đi làm.
FERRY Phà.
FUNICULAR Phương tiện được kéo lên dốc cao bằng cáp. Tàu cáp treo thường có 2 toa, mỗi toa đóng vai trò là đối trọng cho toa còn lại.
GONDOLA_LIFT Cáp treo trên không.
HEAVY_RAIL Đường sắt hạng nặng.
HIGH_SPEED_TRAIN Tàu cao tốc.
INTERCITY_BUS Xe buýt liên tỉnh.
LONG_DISTANCE_TRAIN Tàu đường dài.
METRO_RAIL Hệ thống vận chuyển bằng xe điện.
MONORAIL Xe lửa một ray.
OTHER Tất cả các loại xe khác.
RAIL Đường sắt.
SHARE_TAXI Xe taxi đi chung là một loại xe buýt có thể đón và trả khách ở bất cứ đâu trên tuyến đường của mình.
SUBWAY Xe điện ngầm.
TRAM Xe điện trên mặt đất.
TROLLEYBUS Xe điện bánh hơi.

RouteLegTravelAdvisory

Chứa thông tin bổ sung mà người dùng cần được thông báo về một bước trong chặng đường, chẳng hạn như các quy định hạn chế có thể có về khu vực giao thông.

Biểu diễn dưới dạng JSON 
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Trường
tollInfo

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 sẵn nếu chúng tôi dự kiến có phí cầu đường trên RouteLeg và TOLLS có trong ComputeRoutesRequest.extra_computations của yêu cầu. Nếu bạn đặt trường này nhưng không điền vào trường phụ estimatedPrice, thì chúng tôi dự kiến đường có thu phí nhưng chúng tôi không biết giá ước tính. Nếu tollInfo không tồn tại, thì RouteLeg sẽ không có phí cầu đường.
speedReadingIntervals[]

object (SpeedReadingInterval)

Khoảng thời gian đọc tốc độ cho biết mật độ giao thông. Trường này chỉ được điền sẵn cho các yêu cầu khi yêu cầu có giá trị TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference và TRAFFIC_ON_POLYLINE được đưa vào ComputeRoutesRequest.extra_computations. Các khoảng thời gian này bao phủ toàn bộ đường nhiều đoạn của RouteLeg mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể 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).

RouteLegLocalizedValues

Biểu diễn văn bản của một số thuộc tính.

Biểu diễn dưới dạng JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Trường
distance

object (LocalizedText)

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

object (LocalizedText)

Thời lượng, được biểu thị dưới 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. Tính đến tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin giao thông, thì giá trị này sẽ giống với giá trị staticDuration.
staticDuration

object (LocalizedText)

Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.

StepsOverview

Cung cấp thông tin tổng quan về danh sách RouteLegStep.

Biểu diễn dưới dạng JSON 
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Trường
multiModalSegments[]

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 sẵn nếu RouteLeg không chứa bất kỳ đoạn đường đa phương thức nào trong các bước.

MultiModalSegment

Cung cấp 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. Một đoạn đường có nhiều phương thức được xác định là một hoặc nhiều RouteLegStep liền kề có cùng RouteTravelMode. Trường này không được điền sẵn nếu RouteLeg không chứa bất kỳ đoạn đường đa phương thức nào trong các bước.

Biểu diễn dưới dạng JSON 
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Trường
navigationInstruction

object (NavigationInstruction)

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

enum (RouteTravelMode)

Phương tiện đi lại của đoạn đường kết hợp nhiều phương tiện.
stepStartIndex

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.
stepEndIndex

integer

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

Khung nhìn

Một khung hiển thị vĩ độ và kinh độ, được biểu thị dưới dạng hai điểm low và high đối diện theo đường chéo. Khung nhìn được coi là một vùng khép kín, tức là bao gồm cả ranh giới của vùng đó. Phạm vi vĩ độ phải nằm trong khoảng từ -90 đến 90 độ (bao gồm cả hai giá trị này), còn phạm vi kinh độ phải nằm trong khoảng từ -180 đến 180 độ (bao gồm cả hai giá trị này). Một số trường hợp như:

  • Nếu low = high, khung nhìn sẽ bao gồm điểm duy nhất đó.

  • Nếu low.longitude > high.longitude, thì phạm vi kinh độ sẽ bị đảo ngược (khung nhìn vượt qua đường kinh độ 180 độ).

  • Nếu low.longitude = -180 độ và high.longitude = 180 độ, thì khung nhìn sẽ bao gồm tất cả các kinh độ.

  • Nếu low.longitude = 180 độ và high.longitude = -180 độ, thì phạm vi kinh độ sẽ trống.

  • Nếu low.latitude > high.latitude, thì phạm vi vĩ độ sẽ trống.

Bạn phải điền cả low và high, đồng thời không được để trống hộp được biểu thị (như được chỉ định theo các định nghĩa ở trên). Một khung hiển thị trống sẽ dẫn đến lỗi.

Ví dụ: khung hiển thị này bao trọn Thành phố New York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Biểu diễn dưới dạng JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Trường
low

object (LatLng)

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

object (LatLng)

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

RouteLocalizedValues

Biểu diễn văn bản của một số thuộc tính.

Biểu diễn dưới dạng JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Trường
distance

object (LocalizedText)

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

object (LocalizedText)

Thời lượng, được biểu thị dưới 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. Tính đến tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin giao thông, giá trị này sẽ giống với giá trị của staticDuration.
staticDuration

object (LocalizedText)

Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.
transitFare

object (LocalizedText)

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

PolylineDetails

Thông tin chi tiết tương ứng với một chỉ mục hoặc đoạn liên tục của một đường nhiều đoạn. Cho trước một đường nhiều đoạn có các điểm P_0, P_1, ... , P_N (chỉ mục từ 0), PolylineDetails xác định một khoảng thời gian và siêu dữ liệu được liên kết.

Biểu diễn dưới dạng JSON 
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
Trường
flyoverInfo[]

object (FlyoverInfo)

Thông tin chi tiết về đường bay dọc theo đường nhiều đoạn.
narrowRoadInfo[]

object (NarrowRoadInfo)

Thông tin chi tiết về đường hẹp dọc theo đường nhiều đoạn.

FlyoverInfo

Đóng gói thông tin về các đường bay dọc theo đường nhiều đường.

Biểu diễn dưới dạng JSON 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Trường
flyoverPresence

enum (RoadFeatureState)

Chỉ có đầu ra. Cho biết liệu có đường trên cao cho một đoạn đường nhất định của đường nhiều đường hay không.
polylinePointIndex

object (PolylinePointIndex)

Vị trí của thông tin liên quan đến chế độ xem từ trên cao dọc theo đường nhiều đường.

RoadFeatureState

Đóng gói trạng thái của các đối tượng trên đường dọc theo một đoạn đường nhiều đường.

Enum
ROAD_FEATURE_STATE_UNSPECIFIED Trạng thái của đối tượng đường không được tính toán (giá trị mặc định).
EXISTS Đối tượng đường tồn tại.
DOES_NOT_EXIST Đối tượng đường không tồn tại.

PolylinePointIndex

Đóng gói chỉ mục bắt đầu và kết thúc cho chi tiết đường nhiều đoạn. Đối với những trường hợp dữ liệu tương ứng với một điểm duy nhất, startIndex và endIndex sẽ bằng nhau.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Trường
startIndex

integer

Chỉ mục bắt đầu của thông tin chi tiết này trong đường nhiều đường.
endIndex

integer

Chỉ mục cuối của thông tin chi tiết này trong đường nhiều đường.

NarrowRoadInfo

Đóng gói thông tin về đường hẹp dọc theo đường nhiều đoạn.

Biểu diễn dưới dạng JSON 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Trường
narrowRoadPresence

enum (RoadFeatureState)

Chỉ có đầu ra. Cho biết liệu có đường hẹp cho một đoạn đường nhất định của đường nhiều đường hay không.
polylinePointIndex

object (PolylinePointIndex)

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

GeocodingResults

Chứa GeocodedWaypoints cho điểm xuất phát, điểm đến và các điểm tham chiếu trung gian. Chỉ được điền sẵn cho các điểm tham chiếu địa chỉ.

Biểu diễn dưới dạng JSON 
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Trường
origin

object (GeocodedWaypoint)

Điểm tham chiếu được mã hoá địa lý của điểm xuất phát.
destination

object (GeocodedWaypoint)

Điểm tham chiếu được mã hoá địa lý của điểm đến.
intermediates[]

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.

GeocodedWaypoint

Thông tin chi tiết về các vị trí được dùng làm điểm tham chiếu. Chỉ được điền sẵn cho các điểm tham chiếu địa chỉ. Bao gồm thông tin chi tiết về kết quả mã hoá địa lý cho mục đích xác định địa chỉ được mã hoá địa lý.

Biểu diễn dưới dạng JSON 
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Trường
geocoderStatus

object (Status)

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

string

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

boolean

Cho biết rằng trình 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ù trình mã hoá này 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ỉ không đầy đủ hay không.
placeId

string

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

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 sẵn nếu điểm tham chiếu tương ứng là điểm tham chiếu trung gian.