البدء

توفر 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>

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

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

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

المصادقة

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

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

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

السياسات

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

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

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

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