Bắt đầu

Elevation API cung cấp dữ liệu độ cao cho tất cả vị trí trên bề mặt trái đất, bao gồm cả vị trí độ sâu trên đáy đại dương (trả về giá trị âm).

Dịch vụ này cũng có trong API JavaScript của Maps phía máy khách hoặc để sử dụng phía máy chủ với Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Google Maps.

Yêu cầu và phản hồi mẫu

Bạn truy cập vào Elevation API thông qua giao diện HTTP, với các yêu cầu được tạo dưới dạng chuỗi URL, sử dụng toạ độ vĩ độ/kinh độ để xác định vị trí hoặc đỉnh đường dẫn. Yêu cầu phải bao gồm khoá API của bạn.

Ví dụ sau đây yêu cầu thông tin độ cao của Denver, Colorado, "Thành phố cao một dặm", ở định dạng JSON:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

Bạn có thể kiểm thử điều này bằng cách nhập URL vào trình duyệt web (nhớ thay thế YOUR_API_KEY bằng khoá API thực tế của bạn). Phản hồi bao gồm độ cao tại điểm đó, tính bằng mét, cùng với giá trị độ phân giải (khoảng cách tối đa giữa các điểm dữ liệu mà từ đó độ cao được nội suy, tính bằng mét).

Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về cách tạo URL yêu cầu và các thông số có sẵn cũng như tìm hiểu phản hồi.

Dưới đây là một phản hồi mẫu:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

Bắt đầu lập trình bằng thư viện ứng dụng của chúng tôi

Thư viện ứng dụng giúp bạn phát triển bằng API dịch vụ web của Google Maps dễ dàng hơn bằng cách cung cấp các phương thức triển khai gốc, đơn giản cho các tác vụ phổ biến, chẳng hạn như xác thực, điều tiết yêu cầu và thử lại tự động. Elevation API có sẵn trong Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Google Maps.

Xác thực, hạn mức, giá và chính sách

Xác thực

Để sử dụng Elevation API, trước tiên, bạn phải bật API và lấy thông tin xác thực thích hợp. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.

Hạn mức và giá

Xem trang hạn mức sử dụng và thanh toán để biết thông tin chi tiết về hạn mức và mức giá được đặt cho API Elevation.

Chính sách

Việc sử dụng API Elevation phải tuân thủ chính sách về API.

Tìm hiểu thêm

Bạn có thể làm nhiều việc khác với Elevation API, chẳng hạn như yêu cầu dữ liệu độ cao từ nhiều vị trí. Hãy xem Hướng dẫn dành cho nhà phát triển về API độ cao để biết thêm ví dụ và thông tin chi tiết khác.

Hướng dẫn dành cho nhà phát triển về Elevation API dành cho các nhà phát triển trang web và nhà phát triển ứng dụng di động muốn sử dụng dữ liệu độ cao trong bản đồ do một trong các API Nền tảng Google Maps cung cấp. Tài liệu này cung cấp nội dung giới thiệu về cách sử dụng API và tài liệu tham khảo về các tham số có sẵn.