سرویس دریافت حداکثر سرعت
سرویس دریافت حداکثر سرعت، بیشینه سرعت مجاز اتومبیل در یک موقعیت مکانی مشخص را تعیین می‌کند. مختصات جغرافیایی دو نقطه به سرویس ارسال می‌شوند و سرویس در پاسخ حداکثر سرعت مجاز عبور اتومبیل از موقعیت فوق را برمی‌گرداند. مختصات جغرافیایی نقطه دوم با هدف تعیین جهت مسیری که نقطه اول (نقطه درخواستی) در آن قرار دارد به سرویس ارسال می‌گردد.
ورودی و خروجی سرویس به صورت شماتیک در زیر آورده شده است:
ساختار کلی سرویس
get/direction/speed-limit?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
location1 |
مختصات جغرافیایی نقطه درخواستی را مشخص می‌کند. طول و عرض جغرافیایی این نقطه با , از هم تفکیک می‌شوند. |
location2 |
مختصات جغرافیایی نقطه دوم است. از این نقطه برای تعیین جهت مسیری که نقطه درخواستی در آن قرار دارد استفاده می‌شود. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش فرض |
|---|---|---|
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست تعیین سرعت مجاز
با ارسال مختصات جغرافیایی نقاط درخواستی و نقطه دوم، حداکثر سرعت مجاز عبور اتومبیل در موقعیت فوق در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/direction/speed-limit?key=PMI_API_TOKEN&location1=51.40964,35.75922&location2=51.40979,35.76136
نمونه پاسخ
{
"speed_limit": 60,
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
speed_limit |
حداکثر سرعت مجاز عبور اتومبیل در موقعیت درخواستی است. |
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |