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ả các vị trí có độ sâu dưới đáy đại dương (trả về giá trị âm).

Dịch vụ này cũng có sẵn trong Maps JavaScript API phía máy khách, hoặc để sử dụng phía máy chủ với Java Client, Python Client, Go Client và Node.js Client 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 một 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 các vị trí hoặc đỉnh của đường dẫn. Các yêu cầu phải bao gồm khoá API của bạn.

Ví dụ sau đây yêu cầu độ cao cho Denver, Colorado, "Mile High City" (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 và cách hiểu phản hồi.

Sau đây là 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 viết mã 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 dễ dàng hơn bằng các API dịch vụ web của Google Maps bằng cách cung cấp các cách triển khai tích hợp sẵ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à tự động thử lại. Elevation API có trong Java Client, Python Client, Go Client và Node.js Client 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ắt đầu sử dụng Google Maps Platform.

Hạn mức và giá

Xem trang 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

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

Tìm hiểu thêm

Bạn có thể làm nhiều việc hơn 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 Guide để 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 các nhà phát triển trang web và ứng dụng 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. Hướng dẫn này 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.