شروع کنید، شروع کنید

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

Elevation API داده‌های ارتفاعی را برای همه مکان‌های روی سطح زمین، از جمله مکان‌های عمق در کف اقیانوس (که مقادیر منفی را برمی‌گردانند) ارائه می‌کند.

این سرویس همچنین به عنوان بخشی از Maps JavaScript API سمت سرویس گیرنده یا برای استفاده در سمت سرور با Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps در دسترس است.

نمونه درخواست و پاسخ

شما از طریق یک رابط HTTP به Elevation API دسترسی پیدا می‌کنید، درخواست‌هایی که به‌عنوان یک رشته URL ساخته می‌شوند، با استفاده از مختصات طول و عرض جغرافیایی برای شناسایی مکان‌ها یا رئوس مسیر. درخواست ها باید شامل کلید API شما باشند.

مثال زیر ارتفاع دنور، کلرادو، "Mile High City" را در قالب JSON درخواست می کند:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

حلقه

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

جاوا اسکریپت

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);
});

پایتون

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)

جاوا

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();

روبی

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 اجرا شود

می‌توانید این مورد را با وارد کردن URL در مرورگر وب خود آزمایش کنید (حتماً YOUR_API_KEY را با کلید API واقعی خود جایگزین کنید). پاسخ شامل ارتفاع در آن نقطه، بر حسب متر، همراه با مقدار وضوح (حداکثر فاصله بین نقاط داده ای که ارتفاع از آنها درون یابی شده، بر حسب متر) می باشد.

برای اطلاعات بیشتر در مورد ساخت 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 برای این API منتشر شده و در GitHub در دسترس است.

مشخصات OpenAPI را دریافت کنید

مجموعه پستچی

مشخصات OpenAPI نیز به عنوان مجموعه پستچی موجود است.

در Postman اجرا شود

کدنویسی را با کتابخانه های مشتری ما شروع کنید

کتابخانه‌های مشتری با ارائه پیاده‌سازی‌های ساده و بومی وظایف رایج، مانند احراز هویت، کاهش درخواست و تلاش مجدد خودکار، توسعه با سرویس وب Google Maps را آسان‌تر می‌کنند. Elevation API در Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps موجود است.

احراز هویت، سهمیه بندی، قیمت گذاری، و سیاست ها

احراز هویت

برای استفاده از Elevation API، ابتدا باید API را فعال کرده و اعتبار احراز هویت مناسب را دریافت کنید. برای اطلاعات بیشتر، شروع به کار با Google Maps Platform را ببینید.

سهمیه بندی و قیمت گذاری

صفحه استفاده و صورت‌حساب را برای جزئیات بیشتر در مورد سهمیه‌ها و قیمت‌گذاری تعیین‌شده برای Elevation API مرور کنید.

سیاست های

استفاده از Elevation API باید مطابق با خط مشی های API باشد.

بیشتر بدانید

کارهای بیشتری می‌توانید با Elevation API انجام دهید، مانند درخواست داده‌های ارتفاع از چندین مکان . برای مثال‌های بیشتر و جزئیات دیگر ، راهنمای توسعه‌دهنده Elevation API را ببینید.

راهنمای توسعه‌دهنده Elevation API برای توسعه‌دهندگان وب‌سایت و تلفن همراه در نظر گرفته شده است که می‌خواهند از داده‌های ارتفاع در نقشه‌های ارائه‌شده توسط یکی از APIهای پلتفرم Google Maps استفاده کنند. مقدمه ای برای استفاده از API و مواد مرجع در پارامترهای موجود ارائه می دهد.