Elevation

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.

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

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.

results
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 đó.

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.

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

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.

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.