نظرة عامة على Elevation API

واجهة برمجة التطبيقات للارتفاعات هي خدمة تعرض بيانات الارتفاع لموقع على الأرض، أو عينات من بيانات الارتفاع على طول المسارات.

مميزات استخدام Elevation API

باستخدام Elevation API، يمكنك تطوير تطبيقات لدعم عملائك من خلال أنشطة حساسة للمسقط، أو تطبيقات لتحديد المواقع، أو تطبيقات تتضمّن المسقط الرأسي وتغيُّر الارتفاع على طول المسارات. على سبيل المثال، يمكنك تقديم بيانات عن الارتفاع والخسارة في بيانات الارتفاع من أجل تحسين تطبيق الرياضة لأنشطة مثل المشي مسافة طويلة أو ركوب الدراجات أو الغوص العميق.

الإجراءات التي يمكنك تنفيذها باستخدام Elevation API

باستخدام واجهة برمجة التطبيقات الخاصة بالارتفاع، يمكنك تضمين بيانات المسقط الرأسي في التطبيقات أو على الخريطة. مثال:

  • احصل على الارتفاع لمكان معين.
  • احسب الاختلافات في الارتفاع على طول مسار ما أو بين نقطتين.

طريقة عمل واجهة برمجة التطبيقات Elevation

تقبل واجهة برمجة التطبيقات Elevation API طلبًا كعنوان URL مرمّز يتضمّن إحداثيات خطوط الطول/العرض التي يتم تقديمها كمواقع منفصلة أو كسلسلة من المواقع الجغرافية على طول مسار ما. هذا الطلب، على سبيل المثال، استعلام عن مسقط رأسي لوسط مدينة دنفر بولاية كولورادو، مع تحديد العائد بتنسيق JSON.
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

تستمد الخدمة الارتفاع للإحداثيات المقدمة. كما أنه يدمج الارتفاع لموقع بدون مسقط رأسي، مما يوفر متوسطًا ناتجًا من أقرب أربعة مواقع توفر بيانات الارتفاع. أخيرًا، يحدد الدقة الإجمالية للموقع.

المراجِع

يلخص الجدول التالي الموارد المتاحة من خلال Elevation API مع البيانات التي تقوم بإرجاعها.

موارد البيانات البيانات المعروضة تنسيق الإرجاع
إحداثيات خطوط العرض/خطوط الطول

ويمكنك تقديم البيانات كمجموعة من موقع جغرافي واحد أو أكثر، أو كسلسلة على طول مسار. ويمكنك أيضًا تقديم إحداثيات مرمّزة. مرر ما يصل إلى 512 إحداثيات.

توفّر واجهة برمجة التطبيقات للمرتفعات الارتفاع بالمتر مقارنةً بمتوسط مستوى سطح البحر المحلي (LMSL). ويمكن عرض الارتفاع كقيم موجبة أو سالبة كما هو موضّح أدناه:

  • تشير القيم الموجبة إلى المواقع الجغرافية أعلى من نظام LMSL، بما في ذلك المواقع الجغرافية للأسطح أو قاع البحيرات العالية الارتفاع.
  • تشير القيم السالبة إلى المواقع الجغرافية التي تقع أسفل LMSL، بما في ذلك المواقع الجغرافية على سطح المحيط أو قاع المحيط.
  • تشير درجة الدقة إلى المسافة بين نقطة البيانات والارتفاع بالمتر.
  • JSON
  • XML

كيفية استخدام Elevation API

1 بدء الإعداد ابدأ بقراءة إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية.
2 تجربة طلب المسقط الرأسي بعد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار واجهة برمجة التطبيقات Elevation API مباشرةً من متصفحك. للحصول على التفاصيل، يمكنك الاطّلاع على نماذج الطلبات في دليل البدء.
3 إنشاء طلب أكثر تعقيدًا بعد الانتهاء من إعداد مشروع، جرِّب طلبًا يوفّر بيانات موقع جغرافي على طول مسار. راجِع تحديد المسارات لمعرفة التفاصيل.
4 فهم أساسيات الردود استكشِف استجابات بيانات المسقط الرأسي للاستعداد لاستخدام بيانات الارتفاع لتطبيقك. ويمكنك الاطّلاع على استجابات الارتفاع لمعرفة التفاصيل.
5 أدرِج بيانات المسقط الرأسي في تطبيقك. ويمكنك استخدام بيانات المسقط الرأسي لتحسين التطبيقات المستندة إلى الموقع الجغرافي، مثل تطبيقات الأنشطة الرياضية أو بيانات الاستطلاعات.

مكتبات العملاء المتاحة

يمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:

إنّ Java Client وPython Client وGo Client وNode.js Client for Google Maps هي مكتبات عملاء مدعومة من المنتدى، ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.

الخطوات التالية