البدء

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

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

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

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

السياسات

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

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

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

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