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

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

أسباب استخدام واجهة برمجة التطبيقات Elevation API

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

ما يمكنك فعله باستخدام واجهة برمجة تطبيقات Elevation

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

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

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

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

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

الموارد

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

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

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

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

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

كيفية استخدام واجهة برمجة التطبيقات Elevation API

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

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

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

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

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