با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Elevation API سرویسی است که داده های ارتفاع را برای یک مکان روی زمین، یا داده های ارتفاع نمونه برداری شده در طول مسیرها را برمی گرداند.
چرا از Elevation API استفاده کنیم؟
با Elevation API، می‌توانید برنامه‌هایی را برای پشتیبانی از مشتریان خود با فعالیت‌های حساس به ارتفاع، برنامه‌های موقعیت‌یابی، یا برنامه‌های کاربردی کم نقشه‌برداری که شامل ارتفاعات و تغییرات ارتفاع در طول مسیرها هستند، توسعه دهید. به عنوان مثال، می‌توانید داده‌های افزایش و تلفات ارتفاع را برای بهبود یک برنامه ورزشی برای فعالیت‌هایی مانند پیاده‌روی، دوچرخه‌سواری یا غواصی ارائه دهید.
کارهایی که می توانید با Elevation API انجام دهید
با Elevation API، می توانید داده های ارتفاع را در برنامه های خود یا روی نقشه قرار دهید. به عنوان مثال:
ارتفاع را برای یک مکان خاص دریافت کنید.
تفاوت ارتفاع در طول یک مسیر یا بین دو نقطه را محاسبه کنید.
Elevation API چگونه کار می کند
Elevation API یک درخواست را به عنوان یک URL رمزگذاری شده با مختصات طول و عرض جغرافیایی می پذیرد که به صورت مکان های مجزا یا به صورت مجموعه ای از مکان ها در امتداد یک مسیر ارائه می شود. این درخواست، برای مثال، ارتفاع مرکز دنور، کلرادو را جستجو می‌کند و بازگشتی را در قالب JSON مشخص می‌کند.
این سرویس ارتفاع را برای مختصات ارائه شده استخراج می کند. همچنین ارتفاع را برای یک مکان بدون ارتفاع درون‌یابی می‌کند و میانگینی را از چهار نزدیک‌ترین مکان که داده‌های ارتفاعی را ارائه می‌دهند، ارائه می‌کند. در نهایت، وضوح کلی مکان را تعیین می کند.
منابع
جدول زیر منابع موجود از طریق Elevation API را به همراه داده هایی که برمی گرداند خلاصه می کند.
منابع داده
داده ها برگردانده شد
فرمت بازگشت
مختصات طول و عرض جغرافیایی
می توانید داده ها را به صورت مجموعه ای از یک یا چند مکان یا به صورت مجموعه ای در طول یک مسیر ارائه دهید. شما همچنین می توانید مختصات رمزگذاری شده را ارائه دهید. تا 512 مختصات را پاس کنید.
Elevation API ارتفاع را بر حسب متر نسبت به سطح متوسط محلی دریا (LMSL) فراهم می کند. ارتفاع را می توان به صورت مقادیر مثبت یا منفی که در زیر نشان داده شده است برگرداند:
مقادیر مثبت مکان‌های بالای LMSL را نشان می‌دهند، از جمله مکان‌های سطحی یا کف دریاچه‌های با ارتفاع بالا.
مقادیر منفی مکان هایی را نشان می دهد که زیر LMSL هستند، از جمله مکان هایی روی سطح یا کف اقیانوس.
وضوح فاصله بین نقطه داده و ارتفاع را بر حسب متر نشان می دهد.
هنگامی که یک کلید API دارید، می توانید آزمایش Elevation API را مستقیماً از مرورگر خود شروع کنید. برای جزئیات بیشتر به نمونه درخواست ها در راهنمای شروع کار مراجعه کنید.
3
درخواست پیچیده تری بنویسید
پس از راه‌اندازی پروژه، درخواستی را امتحان کنید که داده‌های مکان را در طول یک مسیر ارائه می‌کند. برای جزئیات بیشتربه تعیین مسیرها مراجعه کنید.
4
اصول پاسخگویی را درک کنید
برای آماده شدن برای استفاده از داده های ارتفاع برای برنامه خود، پاسخ های داده های ارتفاع را کاوش کنید. برای جزئیات بیشتر به پاسخ های ارتفاعی مراجعه کنید.
5
داده های ارتفاع را در برنامه خود بگنجانید!
می‌توانید از داده‌های ارتفاع برای بهبود برنامه‌های مبتنی بر مکان، مانند برنامه‌های فعالیت‌های ورزشی یا داده‌های نظرسنجی استفاده کنید.
کتابخانه های مشتری موجود
این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:
Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Elevation API provides elevation data for locations on Earth, enabling applications with elevation-sensitive features.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve elevation for single points or calculate elevation differences along paths, useful for activities like hiking or biking.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns elevation data in meters relative to local mean sea level, with resolution information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access the Elevation API through various client libraries (Java, Python, Go, Node.js) and integrate it into their applications.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, set up a Google Cloud project, try sample requests, and explore the documentation for detailed usage instructions.\u003c/p\u003e\n"]]],[],null,["The Elevation API is a service that returns elevation data for\na location on the earth, or sampled elevation data along paths.\n\nWhy use the Elevation API\n\nWith the Elevation API, you can develop applications to support your\ncustomers with elevation-sensitive activities, positioning applications, or low-surveying\napplications that include elevations and elevation changes along routes. For example,\nyou can provide elevation gain and loss data to enhance a sports application for activities such\nas hiking, biking, or scuba diving.\n\nWhat you can do with the Elevation API\n\nWith the Elevation API, you can include elevation data in your\napplications or on a map. For example:\n\n- Get the **elevation** for a particular place.\n- Calculate the **differences** in elevation along a route or between two points.\n\nHow the Elevation API works The Elevation API accepts a request as an encoded URL with latitude/longitude coordinates provided as either discrete locations, or as a series of locations along a path. This request, for example, queries elevation for the center of Denver, Colorado, specifying a return in JSON format. \n\n```scdoc\n https://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\nThe service derives the elevation for the provided coordinates. It also interpolates\nelevation for a location without elevation, providing an average returned from the four\nnearest locations that do provide elevation data. Finally, it determines the overall\nresolution for the location.\n\nResources\n\nThe following table summarizes the resources available through the\nElevation API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Latitude/longitude coordinates** You can provide data as a set of one or more locations, or as a series along a path. You can also provide encoded coordinates. Pass up to 512 coordinates. | The Elevation API provides **elevation in meters** relative to the **local mean sea level** (LMSL). Elevation can be returned as positive or negative values as indicated below: - **Positive values** indicate locations above LMSL, including surface locations or the bottom of high-altitude lakes. - **Negative values** indicate locations that are below LMSL, including locations on the surface or the ocean floor. - **Resolution** indicates the distance between the data point and the elevation, in meters. | - JSON - XML |\n\nHow to use the Elevation API\n\n|---|---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try an elevation request** | Once you have an API key, you can start testing out the Elevation API directly from your browser. See [Sample requests](/maps/documentation/elevation/start#sample-request) in the *Getting started* guide for details. |\n| 3 | **Compose a more complex request** | Once you are set up with a project, try a request that supplies a location data along a path. See [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths) for details. |\n| 4 | **Understand response basics** | Explore the elevation data responses to prepare to use elevation data for your app. See [Elevation responses](/maps/documentation/elevation/requests-elevation#ElevationResponses) for details. |\n| 5 | **Incorporate elevation data into your own app!** | You can use elevation data to enhance location-based apps, such as apps for sports activities or for survey data. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Elevation API** : Go to [Set up your\n Google Cloud project](/maps/documentation/elevation/cloud-setup).\n- **Try getting path-based elevation data** : Go to [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths)\n- **Follow best practices** : Go to [Web Service\n Best Practices](/maps/documentation/elevation/web-service-best-practices)."]]
