Distance Matrix

Lớp DistanceMatrixService

Lớp google.maps.DistanceMatrixService

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

DistanceMatrixService
DistanceMatrixService()
Thông số: Không có
Tạo một bản sao mới của DistanceMatrixService để gửi truy vấn 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 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 điểm xuất phát và vị trí đích, cũng như nhiều tùy chọn chỉ số điện toán.

destinations
Một mảng chứa các 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
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 yêu cầu định tuyến. 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à nếu 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 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ụ 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ó travelModeDRIVING. Đối tượng này sẽ không ảnh hưởng đến các phương tiện đi lại khác.
Betalanguage 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 các ngôn ngữ được hỗ trợ.
region optional
Loại: string optional
Mã vùng được dùng làm độ chệch cho các yêu cầu mã hóa địa lý. Mã vùng chấp nhận một giá trị hai ký tự gồm ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đề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 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à pháp nhân "Vương quốc Anh và Bắc Ireland".
transitOptions optional
Loại: TransitOptions optional
Các tùy chọn cài đặt chỉ áp dụng cho những yêu cầu mà travelMode ĐƯỢC CHUYỂN ĐỔ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 địa chỉ gốc và địa chỉ đích được định dạng, và trình tự cho mỗi DistanceMatrixResponseRow, một trình tự cho mỗi địa chỉ gốc tương ứng.

destinationAddresses
Loại: Array<string>
Địa chỉ điểm đến đượ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 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ử 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 nguồn gốc đến một đích.

distance
Loại: Distance
Khoảng cách để ghép nối đích xuất phát này. Có thể bạn không xác định được thuộc tính này vì khoảng cách có thể chưa được xác định.
duration
Loại: Duration
Thời lượng của quá trình ghép nối đích đến gốc này. Thuộc tính này có thể không xác định được vì thời lượng có thể không xác định.
duration_in_traffic
Loại: Duration
Thời lượng của quá trình ghép nối đích đến ban đầu này, có tính đến các đ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ể là 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 đưa ra yêu cầu.
fare
Loại: TransitFare
Tổng giá vé cho các cặp điểm xuất phát điểm khởi hành này. Chỉ áp dụng cho những 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 đến gốc 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. Hãy chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên hằng số. Ví dụ: 'OK' hoặc google.maps.DistanceMatrixStatus.OK.

INVALID_REQUEST Yêu cầu được cung cấp không hợp lệ.
MAX_DIMENSIONS_EXCEEDED Yêu cầu có chứa hơn 25 nguồn gốc hoặc hơn 25 đích đến.
MAX_ELEMENTS_EXCEEDED Sản phẩm của điểm xuất phát 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 Quá nhiều yếu 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 khoảng thời gian.
REQUEST_DENIED Dịch vụ của bạn không cho phép 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ề cặp ghép đích đến gốc cụ thể được DistanceMatrixService trả về sau khi hoàn tất yêu cầu ma trận khoảng cách. Những giá trị này được xác định là các chuỗi, ví dụ: 'OK'.

NOT_FOUND Không thể mã hoá địa lý nguồn và/hoặc đích đến của cặp dữ liệu ghé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 nào giữa điểm khởi hành và điểm đến.