Waypoint
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.
Đóng gói một điểm tham chiếu. Điểm đánh dấu đánh dấu cả điểm bắt đầu và điểm kết thúc của một tuyến đường, đồng thời bao gồm các điểm dừng chân dọc theo tuyến đường.
| Biểu diễn dưới dạng JSON |
{
"via": boolean,
"vehicleStopover": boolean,
"sideOfRoad": boolean,
// Union field location_type can be only one of the following:
"location": {
object (Location)
},
"placeId": string,
"address": string,
"navigationPointToken": string
// End of list of possible types for union field location_type.
} |
| Trường |
via |
boolean
Đánh dấu điểm tham chiếu này là một cột mốc chứ không phải là điểm dừng. Đối với mỗi điểm tham chiếu không phải là điểm dừng qua trong yêu cầu, phản hồi sẽ thêm một mục vào mảng legs để cung cấp thông tin chi tiết về các điểm dừng trong chặng đó của chuyến đi. Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm tham chiếu này mà không dừng lại. Các điểm tham chiếu không khiến một mục được thêm vào mảng legs, nhưng chúng sẽ định tuyến hành trình qua điểm tham chiếu. Bạn chỉ có thể đặt giá trị này trên các điểm đánh dấu là điểm trung gian. Yêu cầu sẽ không thành công nếu bạn đặt trường này trên các điểm tham chiếu cuối. Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true thì bạn không thể đặt trường này thành true; nếu không, yêu cầu sẽ không thành công.
|
vehicleStopover |
boolean
Cho biết rằng điểm tham chiếu này dành cho xe dừng lại, nơi có ý định đón hoặc trả khách. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm tham chiếu không phải via trên những con đường không phù hợp để đón và trả khách. Lựa chọn này chỉ hoạt động cho chế độ di chuyển DRIVE và TWO_WHEELER, đồng thời khi locationType là Location.
|
sideOfRoad |
boolean
Cho biết rằng vị trí của điểm tham chiếu này có nghĩa là xe nên dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở lề đường mà vị trí đó hướng đến từ giữa đường. Lựa chọn này chỉ hoạt động trên DRIVE và TWO_WHEELER RouteTravelMode.
|
Trường nhóm location_type. Các cách thể hiện vị trí. location_type chỉ có thể là một trong những trạng thái sau: |
location |
object (Location)
Một điểm được chỉ định bằng toạ độ địa lý, bao gồm cả hướng (không bắt buộc).
|
placeId |
string
Mã địa điểm của địa điểm yêu thích được liên kết với điểm tham chiếu.
|
address |
string
Địa chỉ mà con người đọc được hoặc plus code. Hãy truy cập vào https://plus.codes để biết thông tin chi tiết.
|
navigationPointToken |
string
Mã thông báo xác định NavigationPoint, nhận được từ phương thức SearchDestinations của Geocoding API.
|
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: 2026-03-05 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2026-03-05 UTC."],[],["Waypoints, marking route start, end, and intermediate stops, are defined using a JSON format. Key properties include `via` (boolean) for non-stopping waypoints, `vehicleStopover` (boolean) for pickup/drop-off locations, and `sideOfRoad` (boolean) for preferred stopping side. A waypoint's `location_type` can be specified via geographic coordinates (`location`), a place ID (`placeId`), or a human-readable address (`address`). `via` cannot be true for terminal waypoints or if `optimize_waypoint_order` is true.\n"]]