API Độ cao 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 (vị trí trả về giá trị âm).
Dịch vụ này cũng được cung cấp ở phía máy khách API JavaScript của Maps, hoặc để sử dụng phía máy chủ với Ứng dụng Java, Ứng dụng Python, Go Client 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 API Độ cao thông qua giao diện HTTP, với các yêu cầu được tạo dưới dạng 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 bao gồm khoá API của bạn.
Ví dụ sau đây yêu cầu độ cao cho Denver, Colorado, "Mile High City", ở đị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 tra URL này bằng cách nhập URL vào trình duyệt web (hãy 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ề tạo URL yêu cầu và các tham số có sẵn và hiểu câu trả lời.
Dưới đâ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>
Bắt đầu lập trình bằng các thư viện ứng dụng của chúng tôi
Thư viện ứng dụng tạo 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 cách triển khai gốc của các tác vụ phổ biến, chẳng hạn như xác thực, yêu cầu điều tiết và tự động thử lại. API Độ cao được cung cấp trong Ứng dụng Java, Ứng dụng Python, Go Client 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 API độ cao, trước tiên bạn phải bật API và nhận được giá trị thích hợp giấy uỷ nhiệm xác thực. Để biết thêm thông tin, hãy xem Bắt đầu sử dụng Nền tảng Google Maps.
Hạn mức và giá
Xem lại mức sử dụng và thanh toán để biết chi tiết về hạn mức và giá được thiết lập cho API Độ cao.
Chính sách
Việc sử dụng API Độ cao phải tuân thủ Chính sách về API.
Tìm hiểu thêm
Bạn có thể thực hiện nhiều thao tác hơn với API Độ cao, 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 cho nhà phát triển về API nâng cao để tìm hiểu thêm ví dụ và các thông tin chi tiết khác.
Hướng dẫn cho nhà phát triển về API nâng cao dành cho trang web và nhà phát triển thiết bị di động muốn sử dụng dữ liệu độ cao trong bản đồ được cung cấp bởi một trong API của Nền tảng Google Maps. Tài liệu này giới thiệu cách sử dụng API và tài liệu tham khảo khác nhau về các tham số có sẵn.