سرویس محاسبه شیب و جهت شیب
سرویس محاسبه شیب و جهت شیب، شیب و جهت شیب یک نقطه و یا مابین دو نقطه را محاسبه می‌کند. این سرویس شیب را بر حسب درجه و درصد تعیین می‌کند. سرویس دارای دو امکان مجزای زیر است:
مختصات جغرافیایی تنها یک نقطه به سرویس ارسال شود، سرویس در پاسخ شیب، جهت و زاویه شیب در نقطه فوق را برمی‌گرداند
.مختصات جغرافیایی دو نقطه به سرویس ارسال شوند، سرویس در پاسخ شیب، جهت و زاویه شیب بین دو نقطه را برمی‌گرداند
جهت شیب یکی از مقادیر زیر را شامل می‌شود:
قابلیت‌های سرویس
| محاسبه شیب بر حسب درصد و درجه، جهت و زاویه شیب یک نقطه |
| محاسبه شیب بر حسب درصد و درجه، جهت و زاویه شیب بین دو نقطه |
ساختار کلی سرویس
get/elevation/slope?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
location1 |
مختصات جغرافیایی نقطه درخواستی (نقطه اول) را مشخص می‌کند. طول و عرض جغرافیایی این نقطه با , از هم تفکیک می‌شوند. |
provider |
لایه مدل ارتفاعی رقومی را مشخص می‌کند. از DEM برای تعیین ارتفاع نقاط استفاده می‌شود. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
location2 |
مختصات جغرافیایی نقطه دوم را تعیین می‌کند. | پیش‌فرض عدم تعیین مختصات نقطه دوم است. |
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست محسابه شیب، درصد شیب و جهت شیب یک نقطه
با ارسال مختصات جغرافیایی نقطه درخواستی، شیب، درصد شیب و جهت شیب نقطه در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/elevation/slope?key=PMI_API_TOKEN&location1=51.41322,35.7307&provider=dem
نمونه پاسخ
{
"lat": 35.7307,
"lng": 51.41322,
"slope_percent": 19,
"slope_degrees": 11,
"direction": "Northwest",
"direction_angle": 315,
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
slope_percent |
درصد شیب است. |
slope_degrees |
شیب به درجه است. |
direction |
جهت شیب در یک نقطه و یا بین دو نقطه است. |
direction_angle |
زاویه شیب نقطه نسبت به آزیموت است. |
lat |
عرض جغرافیایی نقطه درخواستی است. |
lng |
طول جغرافیایی نقطه درخواستی است. |
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |
درخواست محاسبه شیب و درصد شیب بین دو نقطه
با ارسال مختصات جغرافیایی دو نقطه درخواستی، شیب و درصد شیب بین آن‌ها در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/elevation/slope?key=PMI_API_TOKEN&location1=51.39793, 35.84135&provider=dem&location2=51.40142, 35.84075
نمونه پاسخ
{
"lat": 35.84135,
"lng": 51.39793,
"slope_percent": -41,
"slope_degrees": -23,
"direction": "North",
"direction_angle": 348,
"status": "OK"
}