Distance Matrix (deprecated)

Lớp DistanceMatrixService

lớp google.maps.DistanceMatrixService
thư viện "routes" 

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
DistanceMatrixService
DistanceMatrixService()
Tham 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 máy chủ của Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Tham 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

Một 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à vị trí đích, cùng nhiều lựa chọn để tính toán các chỉ số.
destinations
Một mảng chứa các 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 các chuỗi địa chỉ điểm xuất phát 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
không bắt buộc
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
không bắt buộc
Loại: boolean optional
Nếu true, hãy hướng dẫn dịch vụ Distance Matrix tránh đường cao tốc nếu có thể. Không bắt buộc.
avoidTolls
không bắt buộc
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 các đường có thu phí nếu có thể. Không bắt buộc.
drivingOptions
không bắt buộc
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 có hiệu lực đối với các phương thức di chuyển khác.
language
không bắt buộc
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
không bắt buộc
Loại: string optional
Mã vùng được dùng làm tiêu chí 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 hai ký tự 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, 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 của quốc gia này là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Liên hiệp Anh và Bắc Ireland").
transitOptions
không bắt buộc
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 có hiệu lực đối với các phương thức di chuyển khác.
unitSystem
không bắt buộc
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à hệ mét.

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ỉ điểm xuất phát và điểm đến được định dạng, cùng một chuỗi DistanceMatrixResponseRow, một chuỗi cho mỗi địa chỉ điểm xuất phát 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ỉ xuất phát.

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 chuỗi DistanceMatrixResponseElement, một chuỗi 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ử 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 xuất phát – điểm đến này. Thuộc tính này có thể không xác định được vì có thể không biết khoảng cách.
duration
Loại: Duration
Thời gian 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ì thời lượng có thể không xác định được.
duration_in_traffic
Loại: Duration
Thời gian 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 được chỉ định bằng thuộc tính trafficModel. Thuộc tính này có thể là undefined vì thời lượng có thể không xác định được. 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ặ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 xuất phát – điểm đến cụ thể này.

Hằng số DistanceMatrixStatus

hằng số google.maps.DistanceMatrixStatus
thư viện "routes"

Trạng thái cấp cao nhất về yêu cầu nói chung do DistanceMatrixService trả về 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

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại DistanceMatrixStatusString.

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
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 điểm xuất phát hoặc hơn 25 điểm đến.
MAX_ELEMENTS_EXCEEDED Tích của số điểm xuất phát và số điểm đến vượt quá giới hạn cho mỗi truy vấn.
OK Câu trả lời chứa kết quả hợp lệ.
OVER_QUERY_LIMIT 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 khoảng thời gian.
REQUEST_DENIED Dịch vụ này đã từ chối cho phép 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 Distance Matrix do lỗi phía 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
thư viện "routes"

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'.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại DistanceMatrixElementStatusString.

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
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 Câu trả lờ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 xuất phát và điểm đến.