Tổng quan về Elevation API

Elevation API là một 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 nên sử dụng Elevation API

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

Những gì bạn có thể làm với Elevation API

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

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

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

API Độ cao chấp nhận yêu cầu dưới dạng URL được mã hoá với toạ độ vĩ độ/kinh độ được cung cấp dưới dạng 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. Ví dụ: yêu cầu này truy vấn độ cao về trung tâm Colorado, Colorado, chỉ định 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 độ nâng cho một vị trí không có độ cao, cung cấp giá trị trung bình được trả về từ 4 vị trí gần nhất cung cấp dữ liệu về độ cao. Cuối cùng, thuộc tính này xác định độ phân giải tổng thể 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 này trả về.

Tài nguyên về 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 dưới dạng chuỗi theo một lộ trình. Bạn cũng có thể cung cấp các toạ độ đã mã hoá. Truyền tối đa 512 toạ độ.

API Độ cao cung cấp độ cao tính bằng mét so với mực nước 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 âm như được chỉ ra dưới đây:

  • Giá trị dương cho biết các vị trí phía trên LMSL, bao gồm cả vị trí bề mặt hoặc đáy hồ trên cao.
  • Giá trị âm cho biết các vị trí thấp hơn LMSL, bao gồm cả các vị trí 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 Elevation API

1 Thiết lập. Hãy bắt đầu từ việc Thiết lập dự án Google Cloud và hoàn thành các hướng dẫn thiết lập sau đó.
2 Thử một yêu cầu về độ cao Sau khi có khoá API, bạn có thể bắt đầu kiểm thử Elevation API ngay trên trình duyệt của mình. 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í dọc theo một đường dẫn. Hãy 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á các phản hồi về dữ liệu độ cao để chuẩn bị sử dụng dữ liệu về độ cao cho ứng dụng của bạn. Xem phần Phản hồi độ cao để biết thông tin chi tiết.
5 Tích hợp dữ liệu về độ 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 cho hoạt động thể thao hoặc cho dữ liệu khảo sát.

Thư viện ứng dụng có sẵn

Hãy gọi API này bằng ngôn ngữ bạn chọn thông qua một trong các thư viện ứng dụng sau:

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Google Maps là các 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 mẫu này 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