Distance Matrix

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.

Lớp DistanceMatrixService

Lớp google.maps.DistanceMatrixService

Dịch vụ để tính khoảng cách giữa nhiều điểm khởi hành và điểm đến.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {DistanceMatrixService} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.
DistanceMatrixService
DistanceMatrixService()
Thông số: Không có
Tạo một thực thể mới của DistanceMatrixService để gửi truy vấn ma trận khoảng cách đến các máy chủ của Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Thông số:
Giá trị trả về: Promise<DistanceMatrixResponse>
Đưa ra yêu cầu ma trận khoảng cách.

Giao diện DistanceMatrixRequest

Giao diện google.maps.DistanceMatrixRequest

Một truy vấn ma trận khoảng cách do DistanceMatrixService gửi chứa các mảng xuất phát và vị trí đích, cũng như nhiều tuỳ chọn cho các chỉ số điện toán.
destinations
Một mảng chứa chuỗi địa chỉ đích, hoặc đối tượng LatLng hoặc Place, để tính khoảng cách và thời gian. Bắt buộc.
origins
Một mảng chứa chuỗi địa chỉ gốc hoặc đối tượng LatLng hoặc Place, từ đó bạn sẽ tính khoảng cách và thời gian. Bắt buộc.
travelMode
Loại: TravelMode
Loại yêu cầu định tuyến. Bắt buộc.
avoidFerries optional
Loại: boolean optional
Nếu true, hướng dẫn dịch vụ Ma trận khoảng cách để tránh phà nếu có thể. Không bắt buộc.
avoidHighways optional
Loại: boolean optional
Nếu true, hướng dẫn dịch vụ Ma trận khoảng cách để tránh đường cao tốc khi có thể. Không bắt buộc.
avoidTolls optional
Loại: boolean optional
Nếu true, hướng dẫn dịch vụ Ma trận khoảng cách để tránh đường có thu phí nếu có thể. Không bắt buộc.
drivingOptions optional
Loại: DrivingOptions optional
Chế độ cài đặt chỉ áp dụng cho những yêu cầu có travelMode là DRIVING. Đối tượng này sẽ không ảnh hưởng đến các phương tiện đi lại khác.
language optional
Loại: string optional
Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà kết quả sẽ được trả về khi có thể. Xem danh sách ngôn ngữ được hỗ trợ.
region optional
Loại: string optional
Mã vùng được dùng làm xu hướng yêu cầu mã hóa địa lý. Mã vùng chấp nhận giá trị hai ký tự của ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD giống với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 là "gb" (về mặt kỹ thuật là thực thể của "Vương quốc Anh và Bắc Ireland").
transitOptions optional
Loại: TransitOptions optional
Chế độ cài đặt chỉ áp dụng cho những yêu cầu trong đó travelMode là thuận lợi. Đối tượng này sẽ không ảnh hưởng đến các phương tiện đi lại khác.
unitSystem optional
Loại: UnitSystem optional
Hệ thống đơn vị ưa thích để sử dụng khi hiển thị khoảng cách. Không bắt buộc; mặc định là chỉ số.

Giao diện DistanceMatrixResponse

Giao diện google.maps.DistanceMatrixResponse

Phản hồi cho một yêu cầu DistanceMatrixService, bao gồm nguồn gốc và địa chỉ đích của định dạng, cũng như trình tự DistanceMatrixResponseRow, mỗi chuỗi cho một địa chỉ gốc tương ứng.
destinationAddresses
Loại: Array<string>
Địa chỉ đích được định dạng.
originAddresses
Loại: Array<string>
Địa chỉ gốc được định dạng.
rows
Các hàng của ma trận, tương ứng với địa chỉ gốc.

Giao diện DistanceMatrixResponseRow

Giao diện google.maps.DistanceMatrixResponseRow

Một hàng phản hồi cho một yêu cầu DistanceMatrixService, bao gồm một chuỗi DistanceMatrixResponseElement, mỗi chuỗi cho một địa chỉ đích tương ứng.
elements
Các thành phần của hàng, tương ứng với địa chỉ đích.

Giao diện DistanceMatrixResponseElement

Giao diện google.maps.DistanceMatrixResponseElement

Một phần tử của phản hồi cho một yêu cầu DistanceMatrixService, chứa thời lượng và khoảng cách từ một điểm đến đến một điểm đến.
distance
Loại: Distance
Khoảng cách để ghép nối đích đến nguồn gốc này. Có thể thuộc tính này chưa được xác định vì khoảng cách có thể không xác định.
duration
Loại: Duration
Thời lượng của cặp ghép đích-đích này. Có thể không xác định được thuộc tính này vì thời lượng có thể không xác định.
duration_in_traffic
Loại: Duration
Thời lượng ghép nối giữa điểm khởi hành và điểm đến này có tính đến điều kiện lưu lượng truy cập do tài sản trafficModel chỉ định. Thuộc tính này có thể là undefined vì thời lượng có thể không xác định. Chỉ dành cho khách hàng sử dụng Gói cao cấp khi drivingOptions được xác định khi đưa ra yêu cầu.
fare
Loại: TransitFare
Giá vé tổng cộng của cặp điểm đến gốc này. Chỉ áp dụng cho các yêu cầu về phương tiện công cộng.
status
Trạng thái của quá trình ghép nối đích-đích cụ thể này.

Hằng số DistanceMatrixStatus

Hằng số google.maps.DistanceMatrixStatus

Trạng thái cấp cao nhất về yêu cầu nói chung mà DistanceMatrixService trả về sau khi hoàn tất một yêu cầu ma trận khoảng cách. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách dùng tên của hằng số. Ví dụ: 'OK' hoặc google.maps.DistanceMatrixStatus.OK.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {DistanceMatrixStatus} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.
INVALID_REQUEST Yêu cầu đã cung cấp không hợp lệ.
MAX_DIMENSIONS_EXCEEDED Yêu cầu chứa hơn 25 nguồn gốc hoặc hơn 25 đích đến.
MAX_ELEMENTS_EXCEEDED Sản phẩm có nguồn gốc và điểm đến vượt quá giới hạn cho mỗi cụm từ tìm kiếm.
OK Phản hồi chứa kết quả hợp lệ.
OVER_QUERY_LIMIT Bạn đã yêu cầu quá nhiều yếu tố trong khoảng thời gian cho phép. Yêu cầu đó sẽ thành công nếu bạn thử lại sau giây lát.
REQUEST_DENIED Dịch vụ này đã từ chối trang web của bạn sử dụng dịch vụ Ma trận khoảng cách.
UNKNOWN_ERROR Không thể xử lý yêu cầu Ma trận khoảng cách do lỗi máy chủ. Yêu cầu có thể thành công nếu bạn thử lại.

Hằng số DistanceMatrixElementStatus

Hằng số google.maps.DistanceMatrixElementStatus

Trạng thái cấp phần tử về một cặp điểm đến đích cụ thể do DistanceMatrixService trả về sau khi hoàn tất một yêu cầu ma trận khoảng cách. Các giá trị này được chỉ định dưới dạng chuỗi, ví dụ: 'OK'.

Khi sử dụng v=beta, bạn có thể truy cập vào bằng cách gọi const {DistanceMatrixElementStatus} = await google.map.importLibrary("routes"). Xem phần Thư viện trong Maps JavaScript API.
NOT_FOUND Không thể mã hoá địa lý nguồn gốc và/hoặc điểm đến của cặp ghép này.
OK Phản hồi chứa kết quả hợp lệ.
ZERO_RESULTS Không thể tìm thấy tuyến đường nào giữa điểm khởi hành và điểm đến.