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 độ cao của Denver, Colorado, "Thành phố cao một dặm", ở định dạng JSON:
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).
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 API Elevation, 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.
Hướng dẫn dành cho nhà phát triển API Elevation 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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[[["\u003cp\u003eThe Elevation API provides elevation data for all locations on the surface of the earth, including ocean floor depths.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the Elevation API through an HTTP interface using latitude/longitude coordinates, requiring an API key for requests.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be used with client-side Maps JavaScript API or server-side with Java, Python, Go, and Node.js client libraries.\u003c/p\u003e\n"],["\u003cp\u003eA billing account and enabled Elevation API are prerequisites for using the API, and creating multiple project owners/billing administrators is recommended.\u003c/p\u003e\n"]]],[],null,["| **Before you begin:** Before you start using the Elevation API, you need a project with a billing account and the Elevation API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](/maps/documentation/elevation/cloud-setup).\n\nThe Elevation API provides elevation data for all locations on the\nsurface of the earth, including depth locations on the ocean floor (which\nreturn negative values). \nThis service is also available as part of the client-side\n[Maps JavaScript API](/maps/documentation/javascript/elevation),\nor for server-side use with the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/elevation/client-library).\n\nSample request and response\n\nYou access the Elevation API through an HTTP interface, with\nrequests constructed as a URL string, using latitude/longitude coordinates to\nidentify the locations or path vertices. Requests must include your API key.\n\nThe following example requests the elevation for Denver, Colorado, the\n\"Mile High City\", in JSON format: \n\nURL \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\ncURL \n\n```bash\ncurl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'\n```\n\nYou can test this by entering the URL into your web browser (be sure to replace\n`YOUR_API_KEY` with [your actual API key](#get-a-key)).\nThe response includes the elevation at that point, in meters, along with\nthe resolution value (the maximum distance between data points from which the\nelevation was interpolated, in meters).\n\nView the [developer's guide](/maps/documentation/elevation/overview)\nfor more information about\n[building request URLs and available parameters](/maps/documentation/elevation/overview#ElevationRequests)\nand [understanding the response](/maps/documentation/elevation/overview#ElevationResponses).\n\nBelow is a sample response: \n\nJSON \n\n```json\n{\n \"results\":\n [\n {\n \"elevation\": 1608.637939453125,\n \"location\": { \"lat\": 39.7391536, \"lng\": -104.9847034 },\n \"resolution\": 4.771975994110107,\n },\n ],\n \"status\": \"OK\",\n}\n```\n\nXML \n\n```xml\n\u003cElevationResponse\u003e\n \u003cstatus\u003eOK\u003c/status\u003e\n \u003cresult\u003e\n \u003clocation\u003e\n \u003clat\u003e39.7391536\u003c/lat\u003e\n \u003clng\u003e-104.9847034\u003c/lng\u003e\n \u003c/location\u003e\n \u003celevation\u003e1608.6379395\u003c/elevation\u003e\n \u003cresolution\u003e4.7719760\u003c/resolution\u003e\n \u003c/result\u003e\n\u003c/ElevationResponse\u003e\n```\n\nStart coding with our client libraries\n\nClient libraries make\ndeveloping with the Google Maps web service APIs easier by providing simple,\nnative implementations of common tasks, such as authentication, request\nthrottling and automatic retry. The Elevation API is available\nin the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/elevation/client-library).\n\nAuthentication, quotas, pricing, and policies\n\nAuthentication\n\nTo use the Elevation API, you must first enable the API and obtain the proper\nauthentication credentials. For more information, see\n[Get Started with Google Maps Platform](/maps/get-started).\n\nQuotas and pricing\n\nReview the [usage and billing](/maps/documentation/elevation/usage-and-billing)\npage for details on the quotas and pricing set for the Elevation API.\n\nPolicies\n\nUse of the Elevation API must be in accordance with the\n[API policies](/maps/documentation/elevation/policies).\n\nLearn more\n\nThere's more you can do with the Elevation API, like\n[requesting elevation data\nfrom multiple locations](/maps/documentation/elevation/overview#PointElevation). See the [Elevation API Developer's Guide](/maps/documentation/elevation/overview) for more\nexamples and other details.\n\nThe [Elevation API Developer's Guide](/maps/documentation/elevation/overview) is intended for website and\nmobile developers who want to use elevation data within maps provided by one of the\nGoogle Maps Platform APIs. It provides an introduction to using the API and reference\nmaterial on the available parameters."]]
