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 các 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 Thư viện trong Maps JavaScript API.
ElevationService
ElevationService()
Tham số:  Không có
Tạo một phiên bản mới của ElevationService gửi các truy vấn về độ cao đến máy chủ của Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
Tham số: 
Giá trị trả về:  Promise<PathElevationResponse>
Đưa ra yêu cầu về độ 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])
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.LocationElevationRequestgiao diện

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

Giao diện LocationElevationResponse

google.maps.LocationElevationResponsegiao diện

Phản hồi về độ cao do ElevationService trả về, chứa danh sách các 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.PathElevationRequestgiao diện

Một truy vấn độ cao do ElevationService gửi, chứa đường dẫn mà theo đó dữ liệu được lấy mẫu sẽ được trả về. 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 sẽ được lấy ở khoảng cách đều nhau. Tất cả các đường đi từ đỉnh đến đỉnh đều sử dụng các đoạn của đườ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 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

google.maps.PathElevationResponsegiao diện

Phản hồi về độ cao do ElevationService trả về, chứa danh sách các ElevationResult được phân bổ đều 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

google.maps.ElevationResultgiao diện

Kết quả của một yêu cầu ElevationService, bao gồm tập hợp các toạ độ độ cao và giá trị độ cao của các toạ độ đó. Xin lưu ý rằng một yêu cầu duy nhất 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 bạn truyền nhiều điểm. Để có được giá trị độ cao chính xác nhất cho một điểm, bạn nên truy vấn độc lập.
location optional
Loại:  LatLng optional
Vị trí của kết quả độ 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 cấp. 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

Truy cập bằng cách gọi const {ElevationStatus} = await google.maps.importLibrary("elevation").
Xem Thư viện trong Maps JavaScript API.
INVALID_REQUEST Yêu cầu không hợp lệ.
OK Yêu cầu không gặp phải 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 xử lý được yêu cầu nâng cấp, nhưng không rõ lý do chính xác gây ra lỗi này.