Distance Matrix

Lớp DistanceMatrixService

Lớp google.maps.DistanceMatrixService

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

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

Giao diện DistanceMatrixRequest

google.maps.DistanceMatrixRequestgiao diện

Một truy vấn ma trận khoảng cách do DistanceMatrixService gửi, chứa các mảng vị trí của điểm xuất phát và điểm đến, cũng như nhiều lựa chọn để tính toán các chỉ số.
destinations
Loại:  Array<string|LatLng|LatLngLiteral|Place>
Một mảng chứa các chuỗi địa chỉ đích đến, hoặc LatLng, hoặc các đối tượng 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 các chuỗi địa chỉ gốc, hoặc LatLng, hoặc các đối tượng 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ụ 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 thu phí nếu có thể. Không bắt buộc.
drivingOptions optional
Loại:  DrivingOptions optional
Các 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 thức 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ề (nếu 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 hệ số thiên vị cho các yêu cầu mã hoá địa lý. Mã khu vực chấp nhận giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đáng chú ý. Ví dụ: ccTLD 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 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 những yêu cầu có travelMode là TRANSIT. Đối tượng này sẽ không ảnh hưởng đến các phương thức di chuyển khác.
unitSystem optional
Loại:  UnitSystem optional
Hệ đơn vị ưu tiên 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

google.maps.DistanceMatrixResponsegiao diện

Phản hồi cho yêu cầu DistanceMatrixService, bao gồm địa chỉ nơi xuất phát và địa chỉ đích được định dạng, cùng một chuỗi DistanceMatrixResponseRow, mỗi chuỗi tương ứng với một địa chỉ nơi xuất phát.
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ỉ xuất phát.

Giao diện DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRowgiao diện

Một hàng của phản hồi cho yêu cầu DistanceMatrixService, bao gồm một chuỗi 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 đến.

Giao diện DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElementgiao diện

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 xuất phát đến một điểm đến.
distance
Loại:  Distance
Khoảng cách cho 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ì khoảng cách có thể không xác định.
duration
Loại:  Duration
Thời lượng cho 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ì thời lượng có thể không xác định.
duration_in_traffic
Loại:  Duration
Thời lượng cho cặp điểm xuất phát – điểm đến này, có tính đến tình trạng giao thông do thuộc tính trafficModel cho biết. Thuộc tính này có thể là undefined vì bạn có thể không biết thời lượng. 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 về 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 ma trận khoảng cách. Chỉ định các giá trị 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 Maps JavaScript API.
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 nguồn hoặc hơn 25 đích đến.
MAX_ELEMENTS_EXCEEDED Tích của điểm khởi hành và điểm đế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 Bạn đã yêu cầu quá nhiều phần 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 một khoảng 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 xử lý được yêu cầu Distance Matrix 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 nguồn gốc – đí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 Maps JavaScript API.
NOT_FOUND Không thể mã hoá địa lý điểm khởi hành và/hoặc điểm đến 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.