Tổng quan về API độ cao

API Độ cao 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.

Tại sao nên sử dụng Elevation API

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

Những gì 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 các ứng dụng của mình hoặc trên bản đồ. Ví dụ:

  • Lấy độ 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 API Độ cao

API Độ cao chấp nhận yêu cầu dưới dạng URL được mã hoá với cá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 các vị trí dọc theo một đường dẫn. Ví dụ: yêu cầu này nâng độ cao của cụm từ tìm kiếm ở trung tâm Denver, Colorado, chỉ định một yêu cầu 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ụ này lấy cao độ cho các toạ độ được cung cấp. Hệ thống cũng nội suy độ cao cho một vị trí không có độ cao, cung cấp giá trị trung bình trả về từ bốn vị trí gần nhất cung cấp dữ liệu độ cao. Cuối cùng, thành phần 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 Elevation cùng với dữ liệu mà API này 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 theo một nhóm gồm một hoặc nhiều vị trí hoặc theo chuỗi. Bạn cũng có thể cung cấp các toạ độ được mã hoá. Truyền tối đa 512 toạ độ.

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

  • Giá trị dương cho biết các vị trí phía trên Hệ thống quản lý học tập (LMS), bao gồm cả vị trí bề mặt hoặc đáy của các hồ trên cao.
  • Giá trị âm cho biết các vị trí nằm dưới 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 API độ cao

1 Thiết lập. Hãy bắt đầu bằng việc Thiết lập dự án Google Cloud của bạn và hoàn thành những hướng dẫn thiết lập tiếp theo.
2 Thử yêu cầu độ cao Sau khi có khóa API, bạn có thể bắt đầu kiểm tra Elevation API trực tiếp từ trình duyệt của mình. Hãy xem 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 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. Xem phần Chỉ định đường dẫn để biết thông tin chi tiết.
4 Tìm hiểu kiến thức 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 về độ cao cho ứng dụng của bạn. Xem phản hồi độ cao để biết chi tiết.
5 Kết 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 về độ cao để cải thiện ứng dụng dựa trên vị trí, chẳng hạn như ứng dụng dành cho các hoạt động thể thao hoặc 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ữ mà bạn chọn thông qua một trong những 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 của Google Maps là các thư viện ứng dụng được cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Tải các chương trình này xuống từ GitHub. Tại đây, 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