‏‫الخطوات الأولى

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

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

نموذج طلب واستجابة

يمكنك الوصول إلى Elevation API من خلال واجهة 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 Client وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google".

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

المصادقة

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

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

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

السياسات

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

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

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

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