Distance Matrix

Lớp DistanceMatrixService

Lớp google.maps.DistanceMatrixService

Dịch vụ tính toán khoảng cách giữa nhiều điểm xuất phát và điểm đến.

Truy cập bằng cách gọi const {DistanceMatrixService} = await google.maps.importLibrary("routes"). Xem phần Thư viện trong API Maps JavaScript.
DistanceMatrixService
DistanceMatrixService()
Thông số:  Không có
Tạo một thực thể mới của DistanceMatrixService để gửi các truy vấn về ma trận khoảng cách đến 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 về ma trận khoảng cách.

Giao diện DistanceMatrixRequest

Giao diện google.maps.DistanceMatrixRequest

Truy vấn ma trận khoảng cách do DistanceMatrixService gửi, chứa các mảng vị trí xuất phát và đích đến, cũng như nhiều tuỳ chọn để tính toán các chỉ số.
destinations
Loại:  Array<string|LatLng|LatLngLiteral|Place>
Một mảng chứa chuỗi địa chỉ đích hoặc đối tượng LatLng hoặc Place để tính toán khoảng cách và thời gian. Bắt buộc.
origins
Loại:  Array<string|LatLng|LatLngLiteral|Place>
Một mảng chứa các chuỗi địa chỉ gốc hoặc đối tượng LatLng hoặc Place để tính khoảng cách và thời gian. Bắt buộc.
travelMode
Loại:  TravelMode
Loại định tuyến được yêu cầu. Bắt buộc.
avoidFerries optional
Loại:  boolean optional
Nếu true, hãy hướng dẫn dịch vụ Ma trận khoảng cách tránh phà khi có thể. Không bắt buộc.
avoidHighways optional
Loại:  boolean optional
Nếu true, hãy hướng dẫn dịch vụ Distance Matrix 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ãy hướng dẫn dịch vụ Distance Matrix tránh các đường có trạm thu phí khi có thể. Không bắt buộc.
drivingOptions optional
Loại:  DrivingOptions optional
Chế độ cài đặt chỉ áp dụng cho các 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 di chuyển 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ã khu vực được dùng làm độ lệch cho các yêu cầu mã hoá địa lý. Mã khu vực chấp nhận giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD giống với mã ISO 3166-1, ngoại 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à cho thực thể "Vương quốc Anh và Bắc Ireland").
transitOptions optional
Loại:  TransitOptions optional
Các chế độ cài đặt chỉ áp dụng cho các yêu cầu có travelMode là TRANSIT. Đối tượng này sẽ không ảnh hưởng đến các phương tiện di chuyển khác.
unitSystem optional
Loại:  UnitSystem optional
Hệ đơn vị ưu tiên để 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 yêu cầu DistanceMatrixService, bao gồm địa chỉ nguồn và đích được định dạng, cùng với một chuỗi DistanceMatrixResponseRow, mỗi địa chỉ nguồn tương ứng với một DistanceMatrixResponseRow.
destinationAddresses
Loại:  Array<string>
Địa chỉ đích được định dạng.
originAddresses
Loại:  Array<string>
Địa chỉ gố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 của phản hồi cho yêu cầu DistanceMatrixService, bao gồm một trình tự DistanceMatrixResponseElement, một cho mỗi địa chỉ đích tương ứng.
elements
Các phần tử 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 yêu cầu DistanceMatrixService, chứa thời lượng và khoảng cách từ một điểm xuất phát đến một điểm đến.
distance
Loại:  Distance
Khoảng cách cho cặp điểm xuất phát-điểm đến này. Thuộc tính này có thể không đượ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 điểm khởi hành – điểm đến này. Thuộc tính này có thể không được xác định vì thời lượng có thể không xác định.
duration_in_traffic
Loại:  Duration
Thời lượng của cặp nguồn-đích này, có tính đến các điều kiện giao thông do thuộc tính trafficModel cho biết. 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 Premium khi drivingOptions được xác định khi đưa ra yêu cầu.
fare
Loại:  TransitFare
Tổng giá vé cho cặp điểm xuất phát – điểm đến này. Chỉ áp dụng cho các yêu cầu đi phương tiện công cộng.
status
Trạng thái của cặp điểm xuất phát-điểm đến 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 do DistanceMatrixService trả về sau khi hoàn tất yêu cầu về ma trận khoảng cách. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. Ví dụ: 'OK' hoặc google.maps.DistanceMatrixStatus.OK

Truy cập bằng cách gọi const {DistanceMatrixStatus} = await google.maps.importLibrary("routes"). Xem phần Thư viện trong API Maps JavaScript.
INVALID_REQUEST Yêu cầu được cung cấp không hợp lệ.
MAX_DIMENSIONS_EXCEEDED Yêu cầu chứa hơn 25 điểm xuất phát hoặc hơn 25 điểm đến.
MAX_ELEMENTS_EXCEEDED Sản phẩm của các điểm xuất phát và điểm đến vượt quá giới hạn trên mỗi truy vấn.
OK Phản hồi chứa kết quả hợp lệ.
OVER_QUERY_LIMIT Có quá nhiều phần tử được yêu cầu 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 một thời gian.
REQUEST_DENIED Dịch vụ này đã từ chối việc trang web của bạn sử dụng dịch vụ Distance Matrix.
UNKNOWN_ERROR Không thể xử lý yêu cầu về Bảng 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 xuất phát-điểm đến cụ thể do DistanceMatrixService trả về sau khi hoàn tất yêu cầu về 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'.

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