سرویس محاسبه ارتفاع نقاط

سرویس محاسبه ارتفاع نقاط، ارتفاع یک یا چند نقطه را محاسبه می‌کند. مختصات جغرافیایی نقاط به سرویس ارسال می‌شوند و سرویس در پاسخ ارتفاع نقاط درخواستی از سطح دریا با دقت ارتفاعی ۱۰ متر را برمی‌گرداند.

قابلیت‌های سرویس

دریافت ارتفاع یک نقطه
دریافت ارتفاع چندین نقطه

ساختار کلی سرویس

get
/elevation/altitude?parameters

پارامترهای ورودی

پارامترهای مورد نیاز

پارامتر توضیحات
locations مختصات جغرافیایی نقاط درخواستی را مشخص می‌کند. این نقاط با | از هم جدا می‌شوند. هر نقطه دارای طول و عرض جغرافیایی است که با , از هم تفکیک می‌شوند. در خروجی ارتفاع این نقاط از سطح دریا محاسبه می‌شوند.
provider لایه‌ مدل ارتفاعی رقومی را مشخص می‌کند. از DEM برای تعیین ارتفاع نقاط استفاده می‌شود.

پارامترهای اختیاری

پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.

پارامتر توضیحات مقدار پیش‌فرض
request_id در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. به صورت پیش‌فرض، عدم پیگیری در روز است.

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

درخواست تعیین ارتفاع یک نقطه

با ارسال مختصات جغرافیایی نقطه درخواستی، ارتفاع این نطه از سطح دریا در پاسخ برگردانده می‌شود.

https://api.parsimap.ir/elevation/altitude?key=PMI_API_TOKEN&locations=55.78957,36.13368&provider=dem

نمونه پاسخ

{
  "results": [
    {
      "elevation": 1205,
      "lat": 36.13368,
      "lng": 55.78957
    }
  ],
  "status": "OK"
}

پارامترهای خروجی

پارامتر توضیحات
results نتایج ارتفاع‌‌های یافت شده را نشان می‌دهد. results شامل بخش‌های است که هر بخش خود شامل ارتفاع و مختصات جغرافیایی نقاط ورودی است. ترتیب قرارگیری این بخش‌ها برابر با ترتیب قرارگیری نقاط در وروی است. بخش‌های مختلف results به صورت زیر است:
  • elevation ارتفاع نقاط و یا نقاط درخواستی است.
  • lat عرض جغرافیایی نقطه و یا نقاط درخواستی است.
  • lng طول جغرافیایی نقطه و یا نقاط درخواستی است.
status نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول

درخواست تعیین ارتفاع چند نقطه

با ارسال مختصات جغرافیایی نقاط درخواستی، ارتفاع این نقاط از سطح دریا در پاسخ برگردانده می‌شوند.

https://api.parsimap.ir/elevation/altitude?key=PMI_API_TOKEN&locations=55.78957,36.13368|51.45622,35.36507|51.416532,35.7637|51.42332,35.777&provider=dem

نمونه پاسخ

{
  "results": [
    {
      "elevation": 1205,
      "lat": 36.13368,
      "lng": 55.78957
    },
    {
      "elevation": 900,
      "lat": 35.36507,
      "lng": 51.45622
    },
    {
      "elevation": 1438,
      "lat": 35.7637,
      "lng": 51.416532
    },
    {
      "elevation": 1510,
      "lat": 35.777,
      "lng": 51.42332
    }
  ],
  "status": "OK"
}