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 nguồn gốc và đích đến.

Truy cập bằng cách gọi const {DistanceMatrixService} = await google.maps.importLibrary("routes"). Xem Thư viện trong API JavaScript Maps.
DistanceMatrixService
DistanceMatrixService()
Tham số: Không có
Tạo một thực thể mới của DistanceMatrixService để gửi các truy vấn ma trận khoảng cách đến các máy chủ của Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Các 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 vị trí điểm khởi hành và vị trí đích cùng nhiều tuỳ chọn để tính toán chỉ số.
destinations
Loại:  Array<string|LatLng|LatLngLiteral|Place>
Một mảng chứa chuỗi địa chỉ đích, hoặc các đối tượng LatLng hoặc Place để tính 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 chuỗi địa chỉ gốc, cá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 đã 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ụ Ma trận khoảng cách tránh đường cao tốc nếu 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ụ 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 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 đi lại khác.
language optional
Loại:  string optional
Giá trị nhận dạng ngôn ngữ của 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 sai lệch cho các yêu cầu mã hoá đị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 các mã ccTLD (miền cấp cao nhất theo mã quốc gia) đều giống với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD (miền cấp cao nhất theo mã quốc gia) của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 của quốc gia này là "gb" (về mặt kỹ thuật, tên này là "Vương quốc Anh và Bắc Ireland").
transitOptions optional
Loại:  TransitOptions optional
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 đi lại khác.
unitSystem optional
Loại:  UnitSystem optional
Hệ thống đơ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 một yêu cầu DistanceMatrixService, bao gồm địa chỉ gốc và địa chỉ đích đã định dạng và một chuỗi DistanceMatrixResponseRow, bao gồm một chuỗi cho mỗi đị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 các địa chỉ gốc.

Giao diện DistanceMatrixResponseRow

Giao diện google.maps.DistanceMatrixResponseRow

Một hàng phản hồi cho 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 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ử duy nhấ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 gốc đến một đích đến.
distance
Loại:  Distance
Khoảng cách 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 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 quá trình ghép nối điểm khởi hành-điểm đến này. Thuộc tính này có thể không xác định vì có thể không xác định được thời lượng.
duration_in_traffic
Loại:  Duration
Thời gian của quá trình ghép nối điểm xuất phát-điểm đến này, có tính đến điều kiện lưu lượng truy cập do thuộc tính trafficModel chỉ định. Thuộc tính này có thể undefined vì không xác định được thời lượng. Chỉ dành cho khách hàng sử dụng Gói cao cấp khi drivingOptions được xác định khi yêu cầu.
fare
Loại:  TransitFare
Tổng giá vé cho cặp điểm khởi hành – điểm đến này. Chỉ áp dụng cho yêu cầu về phương tiện công cộng.
status
Trạng thái của cặp điểm khởi hành-đ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 được DistanceMatrixService trả về sau khi hoàn tất một yêu cầu ma trận khoảng cách. Hãy chỉ định các biến này theo giá trị hoặc bằng cách sử dụng tên của hằng số. 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 Thư viện trong API JavaScript Maps.
INVALID_REQUEST Yêu cầu đã đưa ra 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 Tích của nguồn gốc và đích đến vượt quá giới hạn cho mỗi truy vấn.
OK Phản hồi chứa một 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 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 khởi hành-đích đến cụ thể do DistanceMatrixService trả về sau khi hoàn tấ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'.

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