سرویس محاسبه نیمرخ ارتفاعی، نیمرخ ارتفاعی بین دو نقطه را محاسبه میکند. مختصات جغرافیایی دو نقطه ابتدا و انتهای پروفایل به سرویس ارسال میشوند، سرویس در پاسخ نیمرخ ارتفاعی بین دو نقطه را برمیگرداند. همچنین کاربر میتواند تعداد کل نقاط روی پروفایل را تعیین کند. به عنوان مثال با تعیین تعداد ۵۰ نقطه در ورودی، نیمرخ ارتفاعی بین دو نقطه ابتدا و انتها بههمراه ۴۸ نقطه بین آن دو محاسبه میشود.
محاسبه نیمرخ ارتفاعی بین دو نقطه |
محاسبه نیمرخ ارتفاعی بین دو نقطه با قابلیت تعیین تعداد کل نقاط پروفایل (درج حداکثر ۵۰۰ نقطه روی نیمرخ ارتفاعی) |
/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 به صورت زیر است:
|
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" }