Elevation

Lớp ElevationService

google.maps.ElevationService lớp
thư viện "elevation"

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.

const {ElevationService} = await google.maps.importLibrary("elevation");
ElevationService
ElevationService()
Tham 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])
Tham số:
Giá trị trả về: Promise<PathElevationResponse>
Tạo yêu cầu về độ cao dọc theo một đường dẫn, trong đó dữ liệu về độ 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])
Tham số:
Giá trị trả về: Promise<LocationElevationResponse>
Đưa ra yêu cầu về độ cao cho danh sách các vị trí riêng biệt.

Giao diện LocationElevationRequest

google.maps.LocationElevationRequest giao diện

Yêu cầu về độ 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
không bắt buộc
Loại: Array<LatLng|LatLngLiteral> optional
Các vị trí riêng biệt để truy xuất độ cao.

Giao diện LocationElevationResponse

google.maps.LocationElevationResponse giao diện

Phản hồi về độ 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

google.maps.PathElevationRequest giao diện

Một 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, nơi các mẫu độ cao được lấy ở các khoảng cách đều nhau. Tất cả đường dẫn từ đỉnh này đến đỉnh kia đề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ố điểm cách đều nhau dọc theo đường đã 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ị từ 2 đến 512 (bao gồm cả 2 và 512).
path
không bắt buộc
Loại: Array<LatLng|LatLngLiteral> optional
Đường dẫn để thu thập giá trị độ cao.

Giao diện PathElevationResponse

google.maps.PathElevationResponse giao diện

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

Giao diện ElevationResult

google.maps.ElevationResult giao diện

Kết quả của 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 sẽ trở nên thô hơn (giá trị resolution lớn hơn) khi có 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
không bắt buộc
Loại: LatLng optional
Vị trí của kết quả độ cao này.

Hằng số ElevationStatus

google.maps.ElevationStatus hằng số
thư viện "elevation"

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

const {ElevationStatus} = await google.maps.importLibrary("elevation");
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 cấp, nhưng chưa rõ lý do chính xác khiến yêu cầu không thành công.