البدء

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

تتوفّر هذه الخدمة أيضًا كجزء من Maps JavaScript API من جهة العميل، أو للاستخدام من جهة الخادم مع 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>
</pre>

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

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

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

المصادقة

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

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

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

السياسات

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

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

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

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