شروع به کار

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

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

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

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

نمونه زیر ارتفاع دنور، کلرادو، «شهر مایل های»، را در قالب JSON درخواست می‌کند:

نشانی وب

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'

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

برای کسب اطلاعات بیشتر درباره ساختن نشانی‌های وب درخواست و پارامترهای دردسترس و درک پاسخ، راهنمای توسعه‌دهنده را مشاهده کنید.

در زیر نمونه‌ای از پاسخ آمده است:

(قالب) 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>
</pre>

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

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

اصالت‌سنجی، سهمیه‌ها، قیمت‌گذاری، و خط‌مشی‌ها

اصالت‌سنجی

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

سهمیه‌ها و قیمت‌گذاری

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

خط‌مشی‌ها

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

بیشتر بدانید

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

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