Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Tổng quan về tính năng tìm dọc theo tuyến đường

Các tính năng tìm dọc theo tuyến đường có trong các API Địa điểm (Mới) sau:

Chỉ Tìm kiếm văn bản (Mới): Tìm địa điểm dọc theo tuyến đường đã xác định trước cho chuyến đi.
Tìm kiếm văn bản (Mới) và Nearby Search (Mới): Tính toán thông tin tóm tắt về định tuyến từ một vị trí điểm khởi hành đã chỉ định đến từng địa điểm trong kết quả tìm kiếm.
Chỉ Tìm kiếm văn bản (Mới): Tính toán thông tin tóm tắt về định tuyến cho từng địa điểm dọc theo tuyến đường đã xác định trước cho chuyến đi.

Tìm dọc theo tuyến đường

Bạn sử dụng API Tuyến đường để tính toán tuyến đường cho chuyến đi giữa 2 địa điểm. API Tuyến đường có thể tính toán tuyến đường cho ô tô, xe đạp, xe 2 bánh, hệ thống giao thông công cộng hoặc cho người đi bộ.

Tìm kiếm văn bản (Mới) cho phép bạn sử dụng tuyến đường đã tính toán này để thực hiện tìm kiếm dọc theo tuyến đường. Với tuỳ chọn này, bạn sẽ truyền tuyến đường đã tính toán trước từ API Tuyến đường sang yêu cầu Tìm kiếm văn bản (Mới). Sau đó, phản hồi sẽ chứa các địa điểm phù hợp với tiêu chí tìm kiếm và cũng nằm gần tuyến đường đã chỉ định.

Việc tìm dọc theo tuyến đường tương tự như việc sử dụng các tuỳ chọn yêu cầu locationRestriction hoặc locationBias để ưu tiên kết quả tìm kiếm. locationRestriction trả về kết quả tìm kiếm nằm trong phạm vi khung nhìn, trong khi locationBias có thể trả về kết quả tìm kiếm nằm ngoài khung nhìn. Tuy nhiên, trong khi các tuỳ chọn locationBias và locationRestriction cho phép bạn chỉ định một khu vực để ưu tiên kết quả tìm kiếm, thì tính năng tìm dọc theo tuyến đường trong Tìm kiếm văn bản cũng cho phép bạn ưu tiên kết quả tìm kiếm để đưa vào những kết quả có thời gian đi đường vòng tối thiểu từ điểm khởi hành đến điểm đến. Bạn có thể ưu tiên kết quả tìm kiếm bằng cách sử dụng locationBias hoặc locationRestriction kết hợp với đường nhiều đoạn.

Ví dụ: hãy xem xét tuyến đường từ điểm khởi hành (được gọi là điểm tham chiếu trong API Tuyến đường) đến điểm đến do API Tuyến đường tính toán:

Tuyến đường từ điểm tham chiếu ban đầu đến điểm đến có kết quả tìm kiếm.

Khi bạn tìm dọc theo tuyến đường, kết quả tìm kiếm sẽ ưu tiên trả về các địa điểm gần tuyến đường có thời gian đi đường vòng tối thiểu từ điểm khởi hành đến điểm đến. Trong ví dụ này, điểm A, B và C là các địa điểm được trả về trong kết quả tìm kiếm.

Tính toán thông tin tóm tắt về tuyến đường

Tìm kiếm văn bản (Mới) và Nearby Search (Mới) có thể tính toán thông tin tóm tắt về tuyến đường (tức là thời lượng và khoảng cách) đến từng địa điểm trong phản hồi dựa trên vị trí điểm khởi hành đã chỉ định trong yêu cầu. Khi bạn chỉ định điểm khởi hành, phản hồi không chỉ chứa danh sách các địa điểm phù hợp với nội dung tìm kiếm mà còn chứa thời lượng và khoảng cách di chuyển từ điểm khởi hành đến từng địa điểm.

Trong hình sau, điểm A, B và C là các địa điểm được trả về trong phản hồi tìm kiếm:

Điểm A, B và C là những địa điểm được trả về trong phản hồi tìm kiếm.

Đối với từng địa điểm trong kết quả, phản hồi sẽ chứa thời lượng và khoảng cách di chuyển từ điểm khởi hành đến địa điểm đó (nếu có).

Theo mặc định, thời lượng và khoảng cách di chuyển được tính toán bằng cách sử dụng tuỳ chọn TRAFFIC_UNAWARE trong API Tuyến đường. Bạn có thể tuỳ ý đặt các lựa chọn ưu tiên về định tuyến để xem xét tình trạng giao thông theo thời gian thực TRAFFIC_AWARE_OPTIMALhoặc tình trạng giao thông theo thời gian thực có độ trễ thấp TRAFFIC_AWAREtrong quá trình tính toán.

Lưu ý: TRAFFIC_AWARE và TRAFFIC_OPTIMAL chỉ áp dụng cho các phương thức di chuyển DRIVE và TWO_WHEELER. Nếu bạn chỉ định một trong các lựa chọn ưu tiên về tuyến đường với một phương thức di chuyển không được hỗ trợ, thì quá trình tính toán thông tin tóm tắt về tuyến đường sẽ mặc định sử dụng tuỳ chọn TRAFFIC_UNAWARE. Nếu bạn chỉ định TWO_WHEELER ở một khu vực không được hỗ trợ, thì API sẽ trả về thông tin tóm tắt về tuyến đường trống.

Khi bạn đặt TRAFFIC_AWARE lựa chọn ưu tiên về tuyến đường, các tuyến đường sẽ được tính toán có tính đến tình trạng giao thông. Do đó, tuyến đường và thông tin chi tiết về tuyến đường sẽ phản ánh chính xác hơn tình hình thực tế. Vì việc tăng chất lượng dữ liệu này sẽ làm tăng độ trễ của phản hồi, nên chúng tôi đã áp dụng các phương pháp tối ưu hoá hiệu suất để giảm đáng kể độ trễ. Khi bạn đặt lựa chọn ưu tiên về tuyến đường là TRAFFIC_AWARE_OPTIMAL, các tuyến đường sẽ được tính toán có tính đến tình hình giao thông, nhưng không áp dụng phương pháp tối ưu hoá hiệu suất nào. Ở chế độ này, máy chủ sẽ tìm kiếm kỹ hơn trong mạng lưới đường bộ để tìm tuyến đường tối ưu.

Giới thiệu về tuyến đường, chặng và điểm tham chiếu

Một tuyến đường bao gồm nhiều thành phần, do API Tuyến đường tính toán:

Một tuyến đường bao gồm các thành phần sau:

Waypoint: Để tính toán tuyến đường, bạn phải chỉ định tối thiểu vị trí của điểm khởi hành và điểm đến. Bạn xác định các vị trí này là điểm tham chiếu trên tuyến đường. Điểm tham chiếu trung gian là các vị trí nằm giữa điểm khởi hành và điểm đến mà bạn muốn tuyến đường đi qua.
Tuyến đường: Toàn bộ chuyến đi từ điểm tham chiếu khởi hành, qua mọi điểm tham chiếu trung gian, đến điểm tham chiếu đích. Một tuyến đường bao gồm một hoặc nhiều chặng.

Khi truyền một tuyến đường sang Tìm kiếm văn bản, bạn sẽ truyền hình nhiều đường được mã hoá của tuyến đường do API Tuyến đường trả về. Đường nhiều đoạn được mã hoá là danh sách được mã hoá gồm các điểm vĩ độ và kinh độ, cho phép bạn biểu thị đường nhiều đoạn của tuyến đường dưới dạng chuỗi.
Chặng: Đường đi từ một điểm tham chiếu trong tuyến đường đến điểm tham chiếu tiếp theo trong tuyến đường. Mỗi chặng bao gồm một hoặc nhiều bước riêng biệt.

Một tuyến đường chứa một chặng riêng cho đường đi từ mỗi điểm tham chiếu đến điểm tham chiếu tiếp theo. Ví dụ: nếu tuyến đường chứa một điểm tham chiếu khởi hành và một điểm tham chiếu đích , thì tuyến đường đó sẽ chứa một chặng.

Đối với mỗi điểm tham chiếu bổ sung mà bạn thêm vào tuyến đường sau điểm khởi hành và điểm đến (được gọi là điểm tham chiếu trung gian), API sẽ thêm một chặng riêng.

Để biết thêm thông tin về tuyến đường và cách tính toán tuyến đường, hãy xem API Tuyến đường.

Tính toán thông tin tóm tắt về tuyến đường bằng tính năng tìm dọc theo tuyến đường

Bạn có thể kết hợp việc tính toán thông tin tóm tắt về tuyến đường với tính năng tìm dọc theo tuyến đường. Trong trường hợp này, Tìm kiếm văn bản (Mới) sẽ trả về thời lượng di chuyển và khoảng cách đến từng địa điểm trong phản hồi, rồi từ từng địa điểm đến điểm đến cuối cùng của tuyến đường. Hãy xem xét việc tính toán này như là việc cung cấp thời lượng và khoảng cách di chuyển nếu bạn đi đường vòng từ tuyến đường đã chỉ định để đến một địa điểm trong kết quả tìm kiếm, rồi tiếp tục đến điểm đến cuối cùng.

Ví dụ: hãy xem xét tuyến đường sau từ điểm khởi hành đến điểm đến do API Tuyến đường tính toán. Truyền tuyến đường này sang API Tìm kiếm văn bản (Mới) cùng với tiêu chí tìm kiếm của bạn.

Tuyến đường từ điểm đánh dấu điểm khởi hành đến điểm đến có đường vòng để tìm kiếm kết quả.

Trong ví dụ này, vị trí A là một địa điểm được trả về trong kết quả tìm kiếm của tính năng Tìm kiếm văn bản (Mới). Đối với từng địa điểm trong phản hồi, kết quả tìm kiếm sẽ bao gồm thời lượng và khoảng cách cần thiết để đi đường vòng đến địa điểm đó dưới dạng chuyến đi 2 chặng:

Chặng đầu tiên chứa thời lượng và khoảng cách di chuyển từ điểm khởi hành đến địa điểm. Trong ví dụ này, từ điểm khởi hành đến địa điểm A.
Chặng thứ hai chứa thời lượng và khoảng cách di chuyển từ địa điểm đến điểm đến. Trong ví dụ này, từ A đến điểm đến.

Từ thông tin trong phản hồi, bạn có thể tính toán thời lượng và khoảng cách đi đường vòng, trong đó:

$t_{OD}$ là thời lượng chuyến đi từ điểm khởi hành đến điểm đến, $s_{OD}$ là khoảng cách chuyến đi từ điểm khởi hành đến điểm đến
$t_{OA}$ là thời lượng chuyến đi từ điểm khởi hành đến A; $s_{OA}$ là khoảng cách chuyến đi từ điểm khởi hành đến A
$t_{AD}$ là thời lượng chuyến đi từ A đến điểm đến; $s_{AD}$ là khoảng cách chuyến đi từ A đến điểm đến

Thời lượng đi đường vòng là thời lượng chênh lệch giữa chuyến đi ban đầu (từ điểm khởi hành đến điểm đến) và chuyến đi mới (từ điểm khởi hành đến điểm đến qua A):

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

Khoảng cách đi đường vòng là khoảng cách chênh lệch giữa chuyến đi ban đầu (từ điểm khởi hành đến điểm đến) và chuyến đi mới (từ điểm khởi hành đến điểm đến qua A):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$

Tiếp

Tìm dọc theo tuyến đường