Lớp ElevationService
Lớp google.maps.ElevationService
Xác định lớp dịch vụ trao đổi trực tiếp với máy chủ 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 Maps JavaScript API.
Hàm dựng | |
---|---|
ElevationService |
ElevationService() Thông số: Không có
Tạo một bản sao mới của ElevationService để gửi truy vấn độ cao tới máy chủ Google. |
Phương pháp | |
---|---|
getElevationAlongPath |
getElevationAlongPath(request[, callback]) Thông số:
Giá trị trả về:
Promise<PathElevationResponse> Tạo một 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 các 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.
Thuộc tính | |
---|---|
locations optional |
Loại:
Array<LatLng|LatLngLiteral> optional 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
.
Thuộc tính | |
---|---|
results |
Loại:
Array<ElevationResult> Danh sách ElevationResult khớp với các 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 mà các mẫu độ cao cần được lấy ở khoảng cách có khoảng cách đồng đều. Tất cả các đường dẫn từ đỉnh đến đỉnh sử dụng các đoạn của vòng tròn lớn giữa hai điểm đó.
Thuộc tính | |
---|---|
samples |
Loại:
number Bắt buộc. Số điểm bằng 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 có giá trị từ 2 đến 512. |
path optional |
Loại:
Array<LatLng|LatLngLiteral> optional Đường dẫn dùng để 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 các ElevationResult
được cách đều nhau dọc theo đường dẫn của PathElevationRequest
.
Thuộc tính | |
---|---|
results |
Loại:
Array<ElevationResult> 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 yêu cầu ElevationService
, bao gồm tập hợp các toạ độ nâng và giá trị độ cao của chúng. Lưu ý rằng một yêu cầu có thể tạo ra nhiều ElevationResult
.
Thuộc tính | |
---|---|
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. Lưu ý rằng dữ liệu độ cao trở nên thô hơn (giá trị resolution lớn hơn) khi truyền nhiều điểm. Để có được giá trị độ cao chính xác nhất cho một điểm, giá trị đó cần được truy vấn 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. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách dùng tên của hằng số. 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 Maps JavaScript API.
Các hằng số | |
---|---|
INVALID_REQUEST |
Yêu cầu không hợp lệ. |
OK |
Yêu cầu không gặp bất kỳ 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 này không được phép sử dụng dịch vụ độ cao. |
UNKNOWN_ERROR |
Không thể xử lý yêu cầu nâng độ cao, nhưng chưa xác định được lý do chính xác cho lỗi. |