Method: searchAlongRoute

Tìm địa điểm dọc theo tuyến đường đi.

Yêu cầu HTTP

POST https://mapstools.googleapis.com/v1:searchAlongRoute

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 với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of mutually exclusive fields.
}
Trường
textQuery

string

Bắt buộc. Cụm từ tìm kiếm bằng ngôn ngữ tự nhiên (ví dụ: "bộ sạc xe điện", "cà phê").
languageCode

string

Không bắt buộc. Ngôn ngữ cho bản tóm tắt và Place Details. Giá trị mặc định là "en-US".
regionCode

string

Không bắt buộc. Mã quốc gia/khu vực (CLDR) của vị trí (ví dụ: "US").
routingPreference

enum (RoutingPreference)

Không bắt buộc. Lựa chọn ưu tiên về định tuyến (không bắt buộc) chỉ định cách sử dụng dữ liệu lưu lượng truy cập. Giá trị mặc định là TRAFFIC_UNAWARE.
includeExtendedDetails

boolean

Không bắt buộc. Bao gồm thông tin chi tiết mở rộng về Place Details trong phản hồi.

Đặt trường này thành true khi yêu cầu của người dùng cần có thông tin chi tiết định tính phong phú, thông tin linh động theo thời gian thực hoặc thuộc tính thực thể chuyên biệt: – Bài đánh giá định tính, cảm nhận của khách hàng và ý kiến phản hồi. – Các sản phẩm/dịch vụ cụ thể như món trong thực đơn, món ăn, món đặc sản, đồ uống hoặc điểm nổi bật của doanh nghiệp. – Bầu không khí, phong cách trang trí nội thất, tính thẩm mỹ, không gian hoặc tâm trạng chất lượng. – Dữ liệu theo thời gian thực và thông số kỹ thuật của cơ sở chuyên khoa, chính sách/mẹo dành cho khách, thời gian chờ.

Để trống false (mặc định) cho các lượt tìm kiếm thông thường (ví dụ: ẩm thực, loại cửa hàng), lượt tra cứu vị trí/địa chỉ, thông tin liên hệ, giờ hoạt động và siêu dữ liệu/tiện nghi tiêu chuẩn.

Việc bật trường này có thể làm tăng độ trễ.
travelMode

enum (RouteTravelMode)

Không bắt buộc. Chỉ định phương tiện di chuyển dùng để tính toán tuyến đường và đường vòng. Giá trị mặc định là DRIVE. WALK và BICYCLE chỉ được hỗ trợ với routeEndpoints. TRANSIT không được hỗ trợ.
Thông số kỹ thuật của tuyến đường: tuyến đường hiện có, mã thông báo tuyến đường hoặc điểm cuối của điểm xuất phát/điểm đến. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
encodedPolyline

string

Một chuỗi hình nhiều đường được mã hoá đại diện cho tuyến đường. Xem https://developers.google.com/maps/documentation/utilities/polylinealgorithm
retrievalToken

string

Mã truy xuất được trả về từ lệnh gọi v1.computeRoutes trước đó đại diện cho tuyến đường.
routeEndpoints

object (RouteEndpoints)

Điểm cuối của tuyến đường rõ ràng (điểm xuất phát và điểm đến).
Kết thúc các trường loại trừ lẫn nhau.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của SearchAlongRouteResponse.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/maps-platform.mapstools