Bắt đầu

Elevation API cung cấp dữ liệu độ cao cho tất cả các vị trí trên bề mặt trái đất, bao gồm cả vị trí độ sâu dưới đá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ụ của 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 một giao diện HTTP, với các yêu cầu được tạo thành một chuỗi URL, sử dụng toạ độ vĩ độ/kinh độ để xác định các vị trí hoặc đỉnh của đường dẫn. Yêu cầu phải có khoá API của bạn.

Ví dụ sau đây yêu cầu độ 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ử 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 tham số có sẵn cũng như cách hiểu phản hồi.

Sau đâ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>
</pre>
      
    

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

Các thư viện ứng dụng giúp việc phát triển bằng các API dịch vụ web của Google Maps trở nên dễ dàng hơn bằng cách cung cấp các phương thức triển khai sẵn có 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à tự động thử lại. Elevation API có 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 này và lấy thông tin xác thực phù hợp. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.

Hạn mức và giá

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

Chính sách

Bạn phải tuân thủ chính sách API khi sử dụng Elevation API.

Tìm hiểu thêm

Bạn có thể làm nhiều việc hơn nữa 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 Elevation API để 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 Elevation API dành cho những nhà phát triển trang web và thiết bị di động muốn sử dụng dữ liệu độ cao trong bản đồ do một trong các API của Google Maps Platform cung cấp. Tài liệu này giới thiệu cách sử dụng API và tài liệu tham khảo về các tham số có sẵn.