البدء

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

تتوفر هذه الخدمة أيضًا كجزء من Sitemaps API من جهة العميل، أو للاستخدام من جهة الخادم مع Java Client وPython Client وGo Client وNode.js Client for Google Maps Services.

نموذج لطلب وردّ

يمكنك الوصول إلى واجهة برمجة التطبيقات Elevation API من خلال واجهة HTTP، من خلال الطلبات التي يتم إنشاؤها على شكل سلسلة عنوان URL، وذلك باستخدام إحداثيات خطوط العرض/الطول لتحديد المواقع الجغرافية أو رؤوس المسارات. يجب أن تتضمن الطلبات مفتاح واجهة برمجة التطبيقات.

يطلب المثال التالي المسقط الرأسي لمدينة دنفر بولاية كولورادو، "Mile High City"، بتنسيق 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 في برامج Java وبرنامج Python وGo Client وNode.js لخدمات خرائط Google.

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

المصادقة

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

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

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

السياسات

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

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

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

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