Tổng quan về Elevation API

API độ cao là dịch vụ trả về dữ liệu độ cao cho một vị trí trên trái đất hoặc dữ liệu độ cao được lấy mẫu dọc theo các đường dẫn.

Lý do sử dụng API nâng cao

Với API nâng cao, bạn có thể phát triển các ứng dụng để hỗ trợ khách hàng có các hoạt động nhạy cảm với độ cao, ứng dụng định vị hoặc khảo sát thấp các ứng dụng bao gồm độ cao và sự thay đổi cao độ dọc theo tuyến đường. Ví dụ: bạn có thể cung cấp dữ liệu tăng và giảm độ cao để cải thiện ứng dụng thể thao cho các hoạt động như như đi bộ đường dài, đạp xe hoặc lặn có bình dưỡng khí.

Những việc bạn có thể làm với API Độ cao

Với API Độ cao, bạn có thể đưa dữ liệu độ cao vào hoặc trên bản đồ. Ví dụ:

  • Nhận độ cao cho một địa điểm cụ thể.
  • Tính những điểm khác biệt về độ cao dọc theo một tuyến đường hoặc giữa hai tuyến đường .

Cách hoạt động của API Độ cao

API Độ cao chấp nhận yêu cầu dưới dạng URL được mã hoá có toạ độ vĩ độ/kinh độ được cung cấp dưới dạng các vị trí riêng biệt hoặc dưới dạng một loạt vị trí dọc theo một đường dẫn. Yêu cầu này, ví dụ: độ cao truy vấn cho trung tâm Denver, Colorado, chỉ định giá trị trả về ở định dạng JSON. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

Dịch vụ lấy độ cao cho toạ độ đã cung cấp. Hàm này cũng nội suy độ cao cho một vị trí không có độ cao, cung cấp giá trị trung bình được trả về từ bốn độ cao các vị trí gần nhất cung cấp dữ liệu độ cao. Cuối cùng, quy tắc này xác định tổng thể độ phân giải cho vị trí đó.

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua API Độ cao cùng với dữ liệu mà API trả về.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Vĩ độ/kinh độ

Bạn có thể cung cấp dữ liệu dưới dạng một hoặc nhiều vị trí hoặc theo một chuỗi dọc theo một đường dẫn. Bạn cũng có thể cung cấp toạ độ được mã hoá. Truyền lên tới 512 toạ độ.

API Độ cao cung cấp độ cao tính theo mét tương đối đến mực nước biển trung bình tại địa phương (LMSL). Độ cao có thể được trả về dưới dạng giá trị dương hoặc giá trị âm như được chỉ ra dưới đây:

  • Giá trị dương cho biết vị trí trên LMSL, bao gồm cả vị trí trên bề mặt hoặc đáy của các hồ có độ cao lớn.
  • Giá trị âm cho biết các vị trí thấp hơn LMSL, bao gồm trên bề mặt hoặc đáy đại dương.
  • Độ phân giải cho biết khoảng cách giữa điểm dữ liệu và cao độ, tính bằng mét.
  • JSON
  • XML

Cách sử dụng API Độ cao

1 Thiết lập. Hãy bắt đầu bằng việc Thiết lập Dự án trên Google Cloud và hoàn tất quá trình thiết lập tiếp theo.
2 Thử yêu cầu về độ cao Sau khi có khoá API, bạn có thể bắt đầu thử nghiệm API Độ cao trực tiếp từ trình duyệt của bạn. Hãy xem phần Yêu cầu mẫu trong hướng dẫn Bắt đầu để biết thông tin chi tiết.
3 Soạn một yêu cầu phức tạp hơn Sau khi thiết lập một dự án, hãy thử yêu cầu cung cấp dữ liệu vị trí cùng đường dẫn. Xem phần Chỉ định đường dẫn để biết thông tin chi tiết.
4 Tìm hiểu thông tin cơ bản về câu trả lời Khám phá phản hồi dữ liệu độ cao để chuẩn bị sử dụng dữ liệu độ cao cho ứng dụng của bạn. Xem Phản hồi của độ cao để biết thông tin chi tiết.
5 Tích hợp dữ liệu độ cao vào ứng dụng của riêng bạn! Bạn có thể sử dụng dữ liệu độ cao để cải thiện các ứng dụng dựa trên vị trí, chẳng hạn như ứng dụng thể thao hoặc cho dữ liệu khảo sát.

Thư viện ứng dụng hiện có

Gọi API này bằng ngôn ngữ của thông qua một trong các thư viện ứng dụng sau đây:

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Google Maps Các dịch vụ là thư viện ứng dụng được cộng đồng hỗ trợ, nguồn mở theo Giấy phép Apache 2.0. Tải các tệp đó xuống từ GitHub, nơi bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Các bước tiếp theo