نظرة عامة على 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، بما في ذلك المواقع على السطح أو قاع المحيط.
  • تشير درجة الدقة إلى المسافة بين نقطة البيانات الارتفاع، بالأمتار.
  • JSON
  • XML

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

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

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

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

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

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