در مقاله های قبل در مورد وب سرویس نقشه مپ و ویژگی های وب سرویس نقشه مپ و مستنداتAPI در مپ (map) صحبت کردیم در این مطلب در مورد مستندات پارسی‌مپ توضیح میدهیم.
نصب و راه‌اندازی
جهت بکارگیری نقشه پارسی‌مپ نیاز به داشتن پکیج react-parsimap به همراه یک API Key یا Token است که باید در هنگام import کلاس Parsimap مجوز در دسترس، به آن افزوده شود(مستندات پارسی‌مپ). تعیین مجوز بهتر است در فایل index.js یا نقطه آغازین پروژه انجام شود تا هنگام استفاده از نقشه‌های متعدد نیاز به تعیین مجدد API Key برای هر فایل نباشد.
مستندات
مسیریابی
تعریف مسیریابی
سرویس مسیریابی (Routing) مپ با دریافت مختصات مجموعه‌ای از نقاط به صورت دو یا چند نقطه یا یک polyline تمامی داده‌های مربوط به بهینه‌ترین مسیر بین نقاط را به صورت خروجی JSON در اختیار قرار می‌دهد. شما بوسیله API مسیریابی مپ می‌توانید با مشخص کردن دو یا چند نقطه، مسیر بهینه، مسیر جایگزین، فاصله بین نقاط، زمان رسیدن به مبدا، کلیه معابر طی مسیر به صورت گام‌های geohash و … را دریافت کنید.
نکته :
در حال حاضر مسیریابی در شهر تهران با در نظر گرفتن ترافیک و در سایر نقاط (شهر‌ها) بدون در نظر گرفتن ترافیک صورت می‌گیرد. در نتیجه زمان رسیدن به مقصد (ETA) در تهران به صورت واقعی و برای سایر نقاط بر اساس حداکثر سرعت تردد در معابر محاسبه می‌شود.
دسترسی به این سرویس از طریق API مسیریابی مپ که با Convention Restful طراحی شده مقدور می‌باشد. سرویس مسیریابی امکانات متنوعی برای توسعه دهندگان فراهم می‌آورد تا بتوانید جزییات مختلفی را در مسیریابی اعمال کنند این ویژگی‌ها شامل موارد زیر می‌شود.
مسیریابی جهت تردد با خودرو
مسیریابی جهت تردد با دوچرخه
مسیریابی جهت تردد با دوچرخه
در نظر گرفتن محدودیت‌های ترافیکی (طرح ترافیک یا زوج و فرد)
نمایش مسیر جایگزین
دریافت اطلاعات مسیر با جزییات هر معبر عبوری
ساده سازی نمایش مسیر برای بزرگنمایی‌های پایین
تفاوت مسیریابی دوچرخه با مسیریابی استاندارد خودرو در سرعت اعلام شده در ETA و احتراز از حرکت در بزرگراه برای دوچرخه می‌باشد.
تفاوت مسیریابی پیاده با مسیریابی استاندارد در سرعت اعلامی برای ETA و همچنین دسترسی پیاده به خیابان‌های یکطرفه، پل‌های عابر پیاده، مسیرهای زیرگذر عابر پیاده و مسیرهای پیاده رو می‌باشد.
اصطلاحات کاربردی
Geohash فرمتی جهت نگهداری داده‌های جغرافیایی به صورت فشرده
Leaflet یک کتابخانه متن باز JavaScript که به عنوان ابزاری رایج جهت ساخت و نمایش نقشه به صورت تحت وب استفاده می‌شود.
Front end راهکاری برای نمایش اطلاعات از طریق یک رابط گرافیکی جهت مشاهده و تعامل کاربر از طریق HTML، CSS و یا JavaScript
Zoom Level اندازه بزرگنمایی نقشه
(Lat (Latitude عرض جغرافیایی
(Lon (Longitude طول جغرافیایی
ساختار استفاده
API مسیریابی مپ به صورت Restful توسعه داده‌شده است و از انعطاف پذیری بسیار بالایی برای انواع روش‌های پیاده سازی در محیط‌های مختلف برخوردارد است. برای پیاده‌سازی این سرویس لازم است پارامترهای زیر به عنوان مقادیر ورودی در اختیار سرویس مسیریابی قرار گیرد.
نکته :اگر API Key اختصاصی خودتون رو دریافت نکرده‌اید کافیه به صورت رایگان ثبت نام و با ساخت پروژه جدید API Key اختصاصی دریافت نمایید.
نکته :
ساختار ورود مختصات دو نقطه در coordinates به صورت ترتیبی زیر می‌باشد:
origin_longitude,origin_latitude;destination_longitude,destination_latitude
نکته :
ساختار ورود مختصات x نقطه در coordinates به صورت ترتیبی زیر می‌باشد:
origin_longitude,origin_latitude;destination1_longitude,destination1_latitude;destination2_longitude,destination2_latitude;…;destinationx_longitude,destinationx_latitude
نکته :
ساختار ورود مختصات مجموعه‌ای از نقاط به صورت polyline به شکل رو‌به‌رو می‌باشد:
ofp_Ik_vpAilAyu@te@g`E)Polyline: polyline)
عملکرد سرویس
سرویس مسیریابی با دریافت مقادیر ورودی جزییات کاملی درباره مسیر بهینه بین مبدا و مقصد و یا مجموعه نقاط مشخص شده ارائه می‌دهد. این داده‌ها شامل مواردی همچون مسیر به همراه جزییات معابر، زمان رسیدن به مقصد و طول مسیر می‌باشد.
زمان رسیدن به مقصد در حال حاضر برای شهر تهران بر اساس داده‌های ترافیکی(ETA) و برای سایر نقاط با در نظر گرفتن حداکثر سرعت معابر محاسبه می‌شود.
سرویس مسیریابی برای حالت‌های مختلف تردد و همچنین در نظر گرفتن محدودیت‌های ترافیکی از end-point های مختلفی استفاده می‌کند. از این رو برای هر یک از روش‌های مسیریابی باید درخواست خود را به یکی از این آدرس‌ها ارسال کنید.
مسیریابی با خودرو بدون در نظر گرفتن طرح ترافیک {route/v1/driving/{coordinates/
مسیریابی با خودرو با در نظر گرفتن طرح ترافیک {tarh/v1/driving/{coordinates/
مسیریابی با خودرو با در نظر گرفتن طرح زوج و فرد {zojofard/v1/driving/{coordinates/
مسیریابی با دوچرخه {bicycle/v1/driving/{coordinates/
مسیریابی پیاده {foot/v1/driving/{coordinates/
نکته :مسیریابی با اعمال محدودیت طرح ترافیک برای شهرهای زیر در دسترس می‌باشد
• اصفهان
• تبریز
• تهران
• کرج
• مشهد
نکته :مسیریابی با اعمال محدودیت طرح روج و فرد برای شهرهای زیر در دسترس می‌باشد
• تهران
پارامترهای خروجی
خروجی API مسیریابی مپ به صورت یک Json شامل موارد زیر می‌باشد
جهت مشاهده سایر مستندات واستفاده از آنها کلیک نمائید