البدء

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

نموذج للطلب والاستجابة

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

يطلب المثال التالي رفع ارتفاع مدينة "دنفر" و"كولورادو" و"&quot؛Mile High City&quot، بتنسيق 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.

التشغيل في 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

مجموعة بوستمان

تتوفر أيضًا مواصفات OpenAPI كمجموعة Postman.

التشغيل في Postman

بدء الترميز باستخدام مكتبات العملاء

وتسهّل مكتبات العملاء عملية التطوير باستخدام واجهات برمجة تطبيقات خدمات الويب في "خرائط Google"، حيث توفّر عمليات تنفيذ بسيطة وأصلية للمهام الشائعة، مثل المصادقة وطلب التقييد وإعادة المحاولة تلقائيًا. وتتوفّر واجهة برمجة التطبيقات Elevation API في Java Client و Python Client وGo Client وNode.js Client لخدمات "خرائط Google".

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

المصادقة

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

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

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

السياسات

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

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

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

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