Elevation

Lớp ElevationService

Lớp google.maps.ElevationService

Xác định một lớp dịch vụ giao tiếp trực tiếp với máy chủ của Google để yêu cầu dữ liệu độ cao.

Truy cập bằng cách gọi const {ElevationService} = await google.maps.importLibrary("elevation"). Xem phần Thư viện trong API Maps JavaScript.
ElevationService
ElevationService()
Thông số:  Không có
Tạo một thực thể mới của ElevationService để gửi truy vấn độ cao đến máy chủ của Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Thông số: 
Giá trị trả về:  Promise<PathElevationResponse>
Tạo yêu cầu độ cao dọc theo một đường dẫn, trong đó dữ liệu độ cao được trả về dưới dạng mẫu dựa trên khoảng cách dọc theo đường dẫn đó.
getElevationForLocations
getElevationForLocations(request[, callback])
Thông số: 
Giá trị trả về:  Promise<LocationElevationResponse>
Tạo yêu cầu độ cao cho danh sách các vị trí riêng biệt.

Giao diện LocationElevationRequest

Giao diện google.maps.LocationElevationRequest

Yêu cầu độ cao do ElevationService gửi, chứa danh sách các toạ độ riêng biệt (LatLng) để trả về dữ liệu độ cao.
locations optional
Loại:  Array<LatLng|LatLngLiteral> optional
Các vị trí riêng biệt để truy xuất độ cao.

Giao diện LocationElevationResponse

Giao diện google.maps.LocationElevationResponse

Phản hồi độ cao do ElevationService trả về, chứa danh sách ElevationResult khớp với vị trí của LocationElevationRequest.
results
Danh sách ElevationResult khớp với vị trí của LocationElevationRequest.

Giao diện PathElevationRequest

Giao diện google.maps.PathElevationRequest

Truy vấn độ cao do ElevationService gửi, chứa đường dẫn để trả về dữ liệu được lấy mẫu. Yêu cầu này xác định một đường dẫn liên tục dọc theo trái đất, theo đó, các mẫu độ cao sẽ được lấy ở khoảng cách đều nhau. Tất cả các đường dẫn từ đỉnh này đến đỉnh khác đều sử dụng các đoạn của vòng tròn lớn giữa hai điểm đó.
samples
Loại:  number
Bắt buộc. Số lượng điểm cách đều nhau dọc theo đường dẫn đã cho để truy xuất dữ liệu độ cao, bao gồm cả các điểm cuối. Số lượng mẫu phải là một giá trị nằm trong khoảng từ 2 đến 512.
path optional
Loại:  Array<LatLng|LatLngLiteral> optional
Đường dẫn để thu thập các giá trị độ cao.

Giao diện PathElevationResponse

Giao diện google.maps.PathElevationResponse

Phản hồi độ cao do ElevationService trả về, chứa danh sách ElevationResult được đặt cách đều nhau dọc theo đường dẫn của PathElevationRequest.
results
Danh sách ElevationResult khớp với các mẫu của PathElevationRequest.

Giao diện ElevationResult

Giao diện google.maps.ElevationResult

Kết quả của một yêu cầu ElevationService, bao gồm tập hợp toạ độ độ cao và giá trị độ cao của các toạ độ đó. Xin lưu ý rằng một yêu cầu có thể tạo ra nhiều ElevationResult.
elevation
Loại:  number
Độ cao của điểm này trên Trái Đất, tính bằng mét so với mực nước biển.
resolution
Loại:  number
Khoảng cách (tính bằng mét) giữa các điểm mẫu mà từ đó độ cao được nội suy. Thuộc tính này sẽ bị thiếu nếu không xác định được độ phân giải. Xin lưu ý rằng dữ liệu độ cao trở nên thô hơn (giá trị resolution lớn hơn) khi nhiều điểm được truyền. Để có được giá trị độ cao chính xác nhất cho một điểm, bạn nên truy vấn điểm đó một cách độc lập.
location optional
Loại:  LatLng optional
Vị trí của kết quả đo độ cao này.

Hằng số ElevationStatus

Hằng số google.maps.ElevationStatus

Trạng thái do ElevationService trả về sau khi hoàn tất yêu cầu nâng cao. 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.ElevationStatus.OK

Truy cập bằng cách gọi const {ElevationStatus} = await google.maps.importLibrary("elevation"). Xem phần Thư viện trong API Maps JavaScript.
INVALID_REQUEST Yêu cầu không hợp lệ.
OK Yêu cầu không gặp lỗi nào.
OVER_QUERY_LIMIT Trang web đã vượt quá giới hạn yêu cầu trong một khoảng thời gian quá ngắn.
REQUEST_DENIED Trang web không được phép sử dụng dịch vụ độ cao.
UNKNOWN_ERROR Không thể xử lý thành công yêu cầu nâng cao, nhưng không rõ lý do chính xác khiến yêu cầu không thành công.