البدء

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

تتوفّر هذه الخدمة أيضًا كجزء من واجهة برمجة تطبيقات 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". وهو يوفر مقدمة حول استخدام واجهة برمجة التطبيقات ومرجع على المعلمات المتاحة.