سرویس محاسبه نیم‌رخ ارتفاعی

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

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

محاسبه نیم‌رخ ارتفاعی بین دو نقطه
محاسبه نیم‌رخ ارتفاعی بین دو نقطه با قابلیت تعیین تعداد کل نقاط پروفایل (درج حداکثر ۵۰۰ نقطه روی نیم‌رخ ارتفاعی)

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

/elevation/altitude-profile?parameters

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

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

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

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

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

پارامتر توضیحات مقدار پیش‌فرض
no_of_results تعداد نقاط نیم‌رخ ارتفاعی را مشخص می‌کند. با استفاده از این پارامتر می‌توان نقاط اضافی بین دو نقطه ابتدایی و انتهایی پروفایل درج کرد. به عنوان مثال اگر کاربر عدد ۱۰ را وارد نماید، ۸ نقطه بین دو نقطه ابتدا و انتهای نیم‌رخ اضافه می‌شود و ارتفاع آن‌ها در پروفایل نمایش داده می‌شوند. بیشینه تعداد نقاط مجاز برای یک پروفایل ارتفاعی ۵۰۰ نقطه است. پیش‌فرض عدم درج نقاط بین دو نقطه ابتدا و انتهای نیمرخ ارتفاعی است.
request_id در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. به صورت پیش‌فرض، عدم پیگیری در روز است.

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

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

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

https://api.parsimap.ir/elevation/altitude-profile?key=PMI_API_TOKEN&provider=dem&location1=51.34743,35.70493&location2=51.42122,35.7307

نمونه پاسخ

{
  "results": [
    {
      "elevation": 1194,
      "lat": 35.704930,
      "lng": 51.347430
    },
    {
      "elevation": 1299,
      "lat": 35.73070,
      "lng": 51.42122
    }
  ],
  "status": "OK"
}

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

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

درخواست محاسبه نیم‌رخ ارتفاعی بین چند نقطه

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

https://api.parsimap.ir/elevation/altitude-profile?key=PMI_API_TOKEN&provider=dem&location1=51.34743,35.70493&location2=51.42122,35.7307&no_of_results=5

نمونه پاسخ

{
  "results": [
    {
      "elevation": 1194,
      "lat": 35.704930,
      "lng": 51.347430
    },
    {
      "elevation": 1231,
      "lat": 35.711373,
      "lng": 51.365877
    },
    {
      "elevation": 1266,
      "lat": 35.717816,
      "lng": 51.384325
    },
    {
      "elevation": 1284,
      "lat": 35.724258,
      "lng": 51.402772
    },
    {
      "elevation": 1299,
      "lat": 35.73070,
      "lng": 51.42122
    }
  ],
  "status": "OK"
}