نظرة عامة على Elevation API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
واجهة برمجة التطبيقات Elevation API هي خدمة تعرض بيانات المسقط الرأسي
أو موقع على الأرض أو بيانات الارتفاع المأخوذة على طول المسارات.
مميزات استخدام واجهة برمجة التطبيقات Elevation API
باستخدام واجهة برمجة التطبيقات Eliffation API، يمكنك تطوير التطبيقات التي تدعم
العملاء الذين لديهم أنشطة حساسة للتقدم، أو تطبيقات تحديد الموضع، أو استقصاء منخفض
التطبيقات التي تتضمن تغييرات الارتفاعات والمسقط الرأسي على طول المسارات. على سبيل المثال:
يمكنك توفير بيانات الارتفاع والخسارة لتحسين تطبيق رياضي لأنشطة مثل
مثل المشي لمسافات طويلة أو ركوب الدراجات أو الغوص.
الإجراءات التي يمكنك تنفيذها باستخدام واجهة برمجة التطبيقات Elevation
باستخدام واجهة برمجة التطبيقات Elevation API، يمكنك تضمين بيانات المسقط الرأسي في
التطبيقات أو على الخريطة. على سبيل المثال:
- يمكنك معرفة الارتفاع لمكان معين.
- حساب الاختلافات في الارتفاع على طول مسار أو بين اثنين
نقاط.
طريقة عمل واجهة Eliteation API
تقبل واجهة برمجة التطبيقات Elevation API طلبًا باعتباره عنوان URL مشفّرًا بإحداثيات خطوط الطول والعرض
يتم تقديمها كمواقع منفصلة أو كسلسلة من المواقع على طول المسار. هذا الطلب،
على سبيل المثال، طلبات البحث عن المسقط الرأسي لوسط مدينة دنفر بولاية كولورادو، وتحديد الإرجاع بتنسيق JSON.
https://maps.googleapis.com/maps/api/elevation/json
?locations=39.7391536%2C-104.9847034
&key=YOUR_API_KEY
تحصل الخدمة على المسقط الرأسي للإحداثيات المقدمة. أيضًا يقوم باستكمال البيانات
المسقط الرأسي لموقع بدون ارتفاع، مما يوفر متوسطًا تم إرجاعه من الأربعة
أقرب المواقع التي توفر بيانات الارتفاع. وأخيرًا، يحدد المجموع
ودقته للموقع.
الموارد
يلخص الجدول التالي الموارد المتاحة من خلال
Eliffation API مع البيانات التي تعرضها.
| موارد البيانات |
تم إرجاع البيانات |
تنسيق الإرجاع |
| إحداثيات خطوط الطول/العرض
يمكنك تقديم البيانات كمجموعة من موقع جغرافي واحد أو أكثر، أو كسلسلة على طول مسار معيّن. إِنْتَ
أيضًا توفير إحداثيات مشفرة. مرِّر ما يصل إلى 512 إحداثيًا.
|
توفّر واجهة برمجة التطبيقات Elevation API الارتفاع بالأمتار نسبيًا
إلى متوسط مستوى سطح البحر المحلي (LMSL). يمكن إرجاع الارتفاع على أنه موجب
أو قيم سالبة كما هو موضح أدناه:
- تشير القيم الموجبة إلى المواقع الجغرافية أعلى من LMSL،
بما في ذلك المواقع السطحية أو قاع البحيرات المرتفعة.
- تشير القيم السالبة إلى المواقع الجغرافية الأقل من LMSL، بما في ذلك
المواقع على السطح أو قاع المحيط.
- تشير درجة الدقة إلى المسافة بين نقطة البيانات
الارتفاع، بالأمتار.
|
|
كيفية استخدام واجهة برمجة التطبيقات Elevation API
| 1 |
بدء الإعداد |
ابدأ بـ إعداد
مشروع Google Cloud
وإكمال عملية الإعداد
والتعليمات التالية. |
| 2 |
تجربة طلب تحديد الارتفاع |
بمجرد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار واجهة برمجة التطبيقات Elevation API مباشرةً من
المتصفح. الاطّلاع على نماذج الطلبات
في دليل البدء لمزيد من التفاصيل.
|
| 3 |
إنشاء طلب أكثر تعقيدًا |
بعد الانتهاء من إعداد مشروع، جرِّب طلبًا يوفّر بيانات موقع جغرافي إلى جانب
. راجِع تحديد المسارات.
لمزيد من التفاصيل.
|
| 4 |
فهم أساسيات الردود |
يمكنك استكشاف استجابات بيانات المسقط الرأسي للاستعداد لاستخدام بيانات الارتفاع لتطبيقك. عرض
استجابات الارتفاع
لمزيد من التفاصيل.
|
| 5 |
دمج بيانات الارتفاع في تطبيقك |
يمكنك استخدام بيانات الارتفاع لتحسين التطبيقات المستندة إلى الموقع الجغرافي، مثل التطبيقات الخاصة بالرياضات.
الأنشطة أو لبيانات الاستطلاعات.
|
مكتبات العملاء المتاحة
استدعِ واجهة برمجة التطبيقات هذه بلغة
حسب اختيارك من خلال إحدى مكتبات العملاء التالية:
عميل Java، وعميل Python، وعميل Go، وعميل Node.js لخرائط Google
والخدمات هي مكتبات عملاء مدعومة من خلال المنتدى، وتكون مفتوحة المصدر ضمن
ترخيص Apache 2.0:
قم بتنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
