البدء

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

تتوفّر هذه الخدمة أيضًا كجزء من Maps JavaScript API من جهة العميل، أو للاستخدام من جهة الخادم مع عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط 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 مخصّص لمطوّري المواقع الإلكترونية والتطبيقات المتوافقة مع الأجهزة الجوّالة الذين يريدون استخدام بيانات الارتفاع في الخرائط التي توفّرها إحدى واجهات برمجة التطبيقات في &quot;منصة خرائط Google&quot;. ويقدّم مقدّمة حول استخدام واجهة برمجة التطبيقات ومواد مرجعية حول المَعلمات المتاحة.