توفر واجهة برمجة التطبيقات للارتفاعات بيانات الارتفاع لجميع المواقع على سطح الأرض، بما في ذلك مواقع العمق في قاع المحيط (التي تعرض قيمًا سالبة).
تتوفّر هذه الخدمة أيضًا كجزء من واجهة برمجة تطبيقات JavaScript للخرائط من جهة العميل، أو للاستخدام من جانب الخادم مع برنامج جافا، عميل Python، 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'
JavaScript
var axios = require('axios'); var config = { method: 'get', url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY', headers: { } }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); });
لغة Python
import requests url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY" payload={} headers = {} response = requests.request("GET", url, headers=headers, data=payload) print(response.text)
لغة Java
OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = RequestBody.create(mediaType, ""); Request request = new Request.Builder() .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY") .method("GET", body) .build(); Response response = client.newCall(request).execute();
Ruby
require "uri" require "net/http" url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Get.new(url) response = https.request(request) puts response.read_body
البدء
package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) }
ساعي البريد
تتوفر أيضًا مواصفات OpenAPI كمجموعة Postman.
Run in Postmanيمكنك اختبار ذلك من خلال إدخال عنوان 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>
مواصفات OpenAPI
تم نشر مواصفات OpenAPI لواجهة برمجة التطبيقات هذه وهي متاحة على GitHub.
الحصول على مواصفات OpenAPIمجموعة Postman
تتوفر أيضًا مواصفات OpenAPI كمجموعة Postman.
تشغيل في Postmanبدء الترميز باستخدام مكتبات العملاء
تسهِّل مكتبات العملاء عملية التطوير باستخدام واجهات برمجة التطبيقات لخدمة "خرائط Google" على الويب من خلال توفير عمليات تنفيذ بسيطة وأصلية للمهام الشائعة مثل المصادقة وتقييد الطلبات وإعادة المحاولة التلقائية. تتوفر واجهة برمجة التطبيقات Elevation API في برنامج جافا، وبرنامج Python، وGo Client، وعميل Node.js لخدمات خرائط Google.
المصادقة والحصص والأسعار والسياسات
المصادقة
لاستخدام واجهة برمجة تطبيقات Elevation API، يجب أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة الصحيحة. ولمزيد من المعلومات، اطّلِع على البدء في استخدام "منصة خرائط Google".
الحصص والأسعار
راجِع صفحة الاستخدام والفوترة للحصول على تفاصيل عن الحصص والأسعار المحدّدة لواجهة برمجة تطبيقات Elevation.
السياسات
يجب أن يكون استخدام واجهة برمجة تطبيقات Elevation API متوافقًا مع سياسات واجهة برمجة التطبيقات.
مزيد من المعلومات
هناك المزيد من الإجراءات التي يمكنك تنفيذها باستخدام واجهة برمجة تطبيقات Elevation، مثل طلب بيانات الارتفاع من مواقع جغرافية متعددة. يمكنك الاطّلاع على دليل مطوّري واجهة برمجة تطبيقات Elevation للحصول على مزيد من الأمثلة والتفاصيل الأخرى.
دليل مطوّري واجهة برمجة التطبيقات Elevation API مصمّم لمطوّري المواقع الإلكترونية والأجهزة الجوّالة الذين يريدون استخدام بيانات الارتفاع ضمن خرائط تقدّمها إحدى واجهات برمجة التطبيقات في "منصة خرائط Google". وهو يوفر مقدمة حول استخدام واجهة برمجة التطبيقات ومرجع على المعلمات المتاحة.