البدء

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

تتوفّر هذه الخدمة أيضًا كجزء من واجهة برمجة تطبيقات JavaScript في جهة العميل، أو للاستخدام من جهة الخادم مع برنامج Java، وPython، وGo Client، وعميل Node.js لخدمات "خرائط Google".

نموذج للطلب والرد

يمكنك الوصول إلى واجهة برمجة التطبيقات الارتفاع من خلال واجهة HTTP مع إنشاء الطلبات كسلسلة عنوان URL باستخدام إحداثيات خطوط الطول والعرض لتحديد المواقع أو رؤوس المسار. يجب أن تتضمّن الطلبات مفتاح واجهة برمجة التطبيقات.

يطلب المثال التالي طلب الارتفاع لمدينة دنفر، كولورادو، مدينة "ميل هاي سيتي" بتنسيق JSON:

عنوان URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

ويمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي). وتشمل الاستجابة قيمة الارتفاع في هذه النقطة بالمتر، بالإضافة إلى قيمة درجة الدقة (الحد الأقصى للمسافة بين نقاط البيانات التي تم استنتاج الارتفاع منها بالأمتار).

يمكنك الاطّلاع على دليل المطوّر للحصول على مزيد من المعلومات حول إنشاء عناوين URL ومعلّمات الطلب المتاحة و فهم الاستجابة.

في ما يلي نموذج إجابة:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

بدء الترميز باستخدام مكتباتنا

تسهِّل مكتبات العملاء إمكانية تطوير البرامج باستخدام واجهات برمجة تطبيقات خدمة الويب في "خرائط Google" من خلال توفير عمليات تنفيذ بسيطة وأصلية للمهام الشائعة، مثل المصادقة وطلب التقييد وإعادة المحاولة تلقائيًا. تتوفر واجهة برمجة التطبيقات Elevation API في برنامج Java، وPython، وGo Client، وعميل Node.js لخدمات "خرائط Google".

المصادقة والحصص والأسعار والسياسات

المصادقة

لاستخدام واجهة برمجة التطبيقات Elevation API، يجب أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة المناسبة. لمزيد من المعلومات، اطّلِع على البدء في استخدام "منصة خرائط Google".

الحصص والأسعار

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

السياسات

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

مزيد من المعلومات

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

إنّ دليل مطوّري واجهات برمجة التطبيقات للارتفاعات مخصّص لمطوّري المواقع الإلكترونية والأجهزة الجوّالة الذين يريدون استخدام بيانات الارتفاع ضمن الخرائط التي توفّرها إحدى واجهات برمجة تطبيقات "منصة خرائط Google". ويوفّر ذلك مقدّمة عن استخدام واجهة برمجة التطبيقات ومراجع مرجعية حول المعلّمات المتاحة.