الخطوات الأولى

توفر واجهة برمجة التطبيقات Elevation API بيانات المسقط الرأسي لكافة المواقع على بما في ذلك مواقع العمق في قاع المحيط إرجاع قيم سالبة).

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

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

يمكنك الوصول إلى واجهة برمجة التطبيقات Eliffation 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 Client وGo Client وNode.js Client لخدمات "خرائط Google"

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

المصادقة

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

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

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

السياسات

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

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

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

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