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