سرویس تعیین مسیر و تخمین زمان و مسافت مسیر
سرویس تعیین مسیر، مسیریابی بین دو یا چند نقطه را انجام می‌دهد. مختصات جغرافیایی نقاط مبدا و مقصد به سرویس ارسال می‌شوند و سرویس در پاسخ مسیر، فاصله زمانی و مکانی سفر بین آنها را برمی‌گرداند. ترتیب ارائه مسیر، فاصله زمانی و مکانی هر سفر برابر با ترتیب نقاط در ورودی است. این سرویس نقطه اول را به عنوان اولین مبدا و نقطه دوم را به عنوان اولین مقصد در نظر می‌گیرد و مسیر بین آنها تعیین می‌کند. پس از آن مسیر، زمان و مسافت بین نقطه دوم و نقطه سوم را به‌ترتیب به عنوان مبدا و مقصد بعدی تعیین می‌کند. به این ترتیب تعیین مسیر بین نقاط تا آخرین جفت نقطه وارد شده ادامه می‌یابد.
قابلیت‌های سرویس
| مسیریابی و نمایش مسیر به همراه تخمین زمان و مسافت مسیر با وسایل نقلیه خودرو و موتورسیکلت |
| تعیین مسیر بیش از دو نقطه |
| تعیین بیش از یک مسیر سفر (تعیین مسیر و یا مسیرهای جایگزین مسیر اصلی سفر) با وسایل نقلیه خودرو و موتورسیکلت |
| تخمین زمان سفر با احتساب ترافیک و یا بدون درنظر گرفتن ترافیک |
| تخمین زمان و مسافت مسیر با وسیله نقلیه خودرو و موتورسیکلت |
ساختار کلی سرویس
get/direction/route?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
waypoints |
مختصات جغرافیایی نقطه مبدا و مقصد را مشخص می‌کند. این نقاط با | از هم جدا می‌شوند. هر نقطه دارای طول و عرض جغرافیایی است و با , از هم تفکیک می‌شوند. نقطه اول به عنوان مبدا و نقطه دوم به عنوان مقصد در نظر گرفته می‌شود. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آنها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
steps |
مسیر بین مبدا و مقصد را نشان می‌دهد. در صورتیکه مقدار این پارامتر true باشد، مسیر تعیین شده نمایش داده می‌شود. اگر مقدار آن false باشد، تنها زمان و مسافت سفر (بدون نمایش مسیر) برگردانده می‌شود. |
پیش‌فرض عدم نمایش مسیر (none) است. |
travel_mode |
نوع وسیله نقلیه را مشخص می‌کند. این سرویس قابلیت انتخاب وسایل نقلیه خودرو و موتورسیکلت را دارد. درصورتیکه مقدار این پارامتر driving یا ۰ باشد و یا مقداری برای آن وارد نشده باشد تخمین زمانی برای ماشین و اگر ۱ یا motorcycling باشد تخمین زمانی برای موتور است. |
پیش‌فرض وسیله نقلیه خودرو (driving) است. |
alternative |
مسیر یا مسیرهای جایگزین مسیر اصلی سفر را مشخص می‌کند. با استفاده از این پارامتر می‌توان حداکثر سه مسیر مجزای سفر بین مبدا و مقصد را در صورت وجود تعیین کرد. | پیش‌فرض ارائه یک مسیر است. |
traffic |
احتساب و یا عدم احتساب ترافیک در تعیین زمان سفر را تعیین می‌کند. درصورت درخواست کردن محاسبه زمان سفر با در نظر گرفتن ترافیک، مقدار این پارامتر باید true باشد. در صورت درخواست کردن تعیین زمان سفر بدون در نظر گرفتن ترافیک، مقدار این پارامتر باید به false تغییر یابد. |
پیش‌فرض، عدم درنظرگرفتن ترافیک (false) در محاسیه زمان سفر است. |
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست مسیریابی و تخمین زمان سفر با احتساب ترافیک
با ارسال مختصات جغرافیایی نقاط مبدا و مقصد، تعیین نوع وسیله نقلیه و فعال کردن گزینه ترافیک، مسیر سفر بین این دو نقطه به همراه فاصله زمانی و مکانی آن در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/direction/route?key=PMI_API_TOKEN&waypoints=51.39903,35.75988|51.39392,35.75686&travel_mode=driving&provide_steps=true&traffic=true
نمونه پاسخ
{
"routes": [
{
"legs": [
{
"steps": [
{
"polyline": {
"points": "ejgyE}zuxHAOMqD"
},
"travel_mode": "driving",
"distance": {
"text": "۸۷ متر",
"value": 87
},
"duration": {
"text": "۱۲ ثانیه ",
"value": 12
},
"start_location": {
"lat": 35.75987,
"lng": 51.39903
},
"end_location": {
"lat": 35.75995,
"lng": 51.4
}
},
{
"polyline": {
"points": "ujgyE_avxHpESh@Ez@E~AGjBI~@E^A"
},
"travel_mode": "driving",
"distance": {
"text": "۳۴۱ متر",
"value": 341
},
"duration": {
"text": "۳۴ ثانیه ",
"value": 34
},
"start_location": {
"lat": 35.75995,
"lng": 51.4
},
"end_location": {
"lat": 35.75689,
"lng": 51.40029
}
},
{
"polyline": {
"points": "qwfyEybvxHd@hMDrARvE@Z@V@^JtCNpF"
},
"travel_mode": "driving",
"distance": {
"text": "۵۵۹ متر",
"value": 559
},
"duration": {
"text": "۵۲ ثانیه ",
"value": 52
},
"start_location": {
"lat": 35.75689,
"lng": 51.40029
},
"end_location": {
"lat": 35.7564,
"lng": 51.39412
}
},
{
"polyline": {
"points": "otfyEg|txHuAH"
},
"travel_mode": "driving",
"distance": {
"text": "۴۸ متر",
"value": 48
},
"duration": {
"text": "۱۲ ثانیه ",
"value": 12
},
"start_location": {
"lat": 35.7564,
"lng": 51.39412
},
"end_location": {
"lat": 35.75683,
"lng": 51.39407
}
},
{
"polyline": {
"points": "ewfyE}{txH@\\"
},
"travel_mode": "driving",
"distance": {
"text": "۱۳ متر",
"value": 13
},
"duration": {
"text": "۲ ثانیه ",
"value": 2
},
"start_location": {
"lat": 35.75683,
"lng": 51.39407
},
"end_location": {
"lat": 35.75682,
"lng": 51.39392
}
},
{
"polyline": {
"points": "cwfyE_{txH"
},
"travel_mode": "driving",
"distance": {
"text": "۰ متر",
"value": 0
},
"duration": {
"text": "",
"value": 0
},
"start_location": {
"lat": 35.75682,
"lng": 51.39392
},
"end_location": {
"lat": 35.75682,
"lng": 51.39392
}
}
],
"distance": {
"text": "۱ کیلومتر ۰۵۱ متر",
"value": 1051
},
"duration": {
"text": "۱ دقیقه ۵۳ ثانیه",
"value": 113
},
"start_location": {
"lat": 35.759874,
"lng": 51.399031
},
"end_location": {
"lat": 35.756821,
"lng": 51.393923
}
}
],
"distance": {
"text": "۱ کیلومتر ۰۵۱ متر",
"value": 1051
},
"duration": {
"text": "۱ دقیقه ۵۳ ثانیه",
"value": 113
},
"start_location": {
"lat": 35.759874,
"lng": 51.399031
},
"end_location": {
"lat": 35.756821,
"lng": 51.393923
}
}
],
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
legs |
مشخصات مسیر یافت شده است. legs شامل بخش‌های زیر است:
|
steps |
گام‌های مسیر یافت شده است. هر مسیر می‌تواند شامل چندین گام باشد. هر گام نیز شامل بخش‌های زیر است:
|
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |
درخواست مسیریابی و تخمین زمان سفر بدون در نظر گرفتن ترافیک
با ارسال مختصات جغرافیایی نقاط مبدا و مقصد و false فرستادن پارامتر traffic، فاصله زمانی سفر بین دو نقطه بدون درنظر گرفتن ترافیک تعیین می‌شود.
نمونه درخواست
https://api.parsimap.ir/direction/route?key=PMI_API_TOKEN&travel_mode=driving&steps=false&traffic=false&waypoints=51.41995,35.70156|51.42884,35.80729
نمونه پاسخ
{
"routes": [
{
"legs": [
{
"steps": [
{
"polyline": {
"points": "c~{xEu}yxH?RCZEb@"
},
"travel_mode": "driving",
"distance": {
"text": "۳۸ متر",
"value": 38
},
"duration": {
"text": "۲ ثانیه ",
"value": 2
},
"start_location": {
"lat": 35.70162,
"lng": 51.41995
},
"end_location": {
"lat": 35.70167,
"lng": 51.41953
}
},
{
"polyline": {
"points": "m~{xEa{yxHABA@ABABABABAB?BABAD?DAB?DADAD?D?D?D?D?D?D"
},
"travel_mode": "driving",
"distance": {
"text": "۴۹ متر",
"value": 49
},
"duration": {
"text": "۹ ثانیه ",
"value": 9
},
"start_location": {
"lat": 35.70167,
"lng": 51.41953
},
"end_location": {
"lat": 35.70179,
"lng": 51.41901
}
},
{
"polyline": {
"points": "e_|xEywyxHyBJM@}ETs@DeBHgEReAF}@DO@eADcAFI?oDPc@B}AHcADQ@e@BO@sAFsAFkAFaBHmDPyBJcAD_BHiADo@D}@DgBHSD"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۴۳۱ متر",
"value": 1431
},
"duration": {
"text": "۲ دقیقه ۸ ثانیه",
"value": 128
},
"start_location": {
"lat": 35.70179,
"lng": 51.41901
},
"end_location": {
"lat": 35.71461,
"lng": 51.4177
}
},
{
"polyline": {
"points": "io~xEsoyxHQGyA@"
},
"travel_mode": "driving",
"distance": {
"text": "۶۰ متر",
"value": 60
},
"duration": {
"text": "۷ ثانیه ",
"value": 7
},
"start_location": {
"lat": 35.71461,
"lng": 51.4177
},
"end_location": {
"lat": 35.71515,
"lng": 51.41773
}
},
{
"polyline": {
"points": "ur~xEyoyxHGuFIgGCwBEeCAo@CaHA}DAyG@g@@mA"
},
"travel_mode": "driving",
"distance": {
"text": "۷۶۳ متر",
"value": 763
},
"duration": {
"text": "۱ دقیقه ۱۳ ثانیه",
"value": 73
},
"start_location": {
"lat": 35.71515,
"lng": 51.41773
},
"end_location": {
"lat": 35.71532,
"lng": 51.42619
}
},
{
"polyline": {
"points": "ws~xEud{xHc@OkA]g@Oc@MiA[QG_@KWK}@[cA_@"
},
"travel_mode": "driving",
"distance": {
"text": "۲۷۳ متر",
"value": 273
},
"duration": {
"text": "۲۴ ثانیه ",
"value": 24
},
"start_location": {
"lat": 35.71532,
"lng": 51.42619
},
"end_location": {
"lat": 35.71765,
"lng": 51.42717
}
},
{
"polyline": {
"points": "ib_yEyj{xHkAYaCy@QCQ?"
},
"travel_mode": "driving",
"distance": {
"text": "۱۴۱ متر",
"value": 141
},
"duration": {
"text": "۱۴ ثانیه ",
"value": 14
},
"start_location": {
"lat": 35.71765,
"lng": 51.42717
},
"end_location": {
"lat": 35.71886,
"lng": 51.42761
}
},
{
"polyline": {
"points": "{i_yEqm{xH[F_@Le@LqBp@aBl@uAb@g@^k@n@kB|Au@l@GD_@XSJSFq@JuE|@uBP}Cf@kD`AaBt@}AdAeBxAkBjBoEtEoAfAyAbAuB|@gATu@NiAJ{@DgACoAOgAWaA[}G{CkBk@}@QeC["
},
"travel_mode": "driving",
"distance": {
"text": "۲ کیلومتر ۱۲۳ متر",
"value": 2123
},
"duration": {
"text": "۱ دقیقه ۵۹ ثانیه",
"value": 119
},
"start_location": {
"lat": 35.71886,
"lng": 51.42761
},
"end_location": {
"lat": 35.73622,
"lng": 51.42204
}
},
{
"polyline": {
"points": "kvbyEwjzxH}C}@kAQ"
},
"travel_mode": "driving",
"distance": {
"text": "۱۳۵ متر",
"value": 135
},
"duration": {
"text": "۷ ثانیه ",
"value": 7
},
"start_location": {
"lat": 35.73622,
"lng": 51.42204
},
"end_location": {
"lat": 35.73739,
"lng": 51.42244
}
},
{
"polyline": {
"points": "u}byEgmzxHiHq@gD_@kF["
},
"travel_mode": "driving",
"distance": {
"text": "۳۹۳ متر",
"value": 393
},
"duration": {
"text": "۲۲ ثانیه ",
"value": 22
},
"start_location": {
"lat": 35.73739,
"lng": 51.42244
},
"end_location": {
"lat": 35.7409,
"lng": 51.42299
}
},
{
"polyline": {
"points": "sscyEupzxHiE@cETgAL_@@]Bo@JuAPm@Ja@J"
},
"travel_mode": "driving",
"distance": {
"text": "۴۱۸ متر",
"value": 418
},
"duration": {
"text": "۲۳ ثانیه ",
"value": 23
},
"start_location": {
"lat": 35.7409,
"lng": 51.42299
},
"end_location": {
"lat": 35.74463,
"lng": 51.4225
}
},
{
"polyline": {
"points": "}jdyEsmzxHuA?_A?o@CcAK{@Ge@C}@Cu@@_@Bg@Bg@D_@Di@LaCl@SHk@VeAd@{Ah@QHcAh@cBb@oARcCNqBNsFRiD\\c@HsCd@g@H}@Hg@D[@mADmAB_DIKAk@AaAFeBKwDa@}B[wAS_BSw@Ko@IoIiAeDm@oDy@yDoAmDsAk@W{BaAoB}@oIkE{BsAaBgAeDuBwGgF}@o@i@_@IEoAu@g@Uo@UeB[kAUuAOqAEqABuBNyBZw@Vk@RuAh@mBz@i@\\oAv@wBtAwBdBsD|Ck@f@uApAcAdAcAfA[ZgEfEq@l@a@\\eCvAaBp@sE|AmBx@gBfAcBrA]\\[^]`@sArB"
},
"travel_mode": "driving",
"distance": {
"text": "۵ کیلومتر ۴۶۷ متر",
"value": 5467
},
"duration": {
"text": "۵ دقیقه ۷ ثانیه",
"value": 307
},
"start_location": {
"lat": 35.74463,
"lng": 51.4225
},
"end_location": {
"lat": 35.78992,
"lng": 51.41905
}
},
{
"polyline": {
"points": "_fmyEaxyxH_@`@a@l@ILGL"
},
"travel_mode": "driving",
"distance": {
"text": "۶۸ متر",
"value": 68
},
"duration": {
"text": "۶ ثانیه ",
"value": 6
},
"start_location": {
"lat": 35.78992,
"lng": 51.41905
},
"end_location": {
"lat": 35.79034,
"lng": 51.41851
}
},
{
"polyline": {
"points": "shmyEutyxHa@jA_@hA[fAY|@Of@Yn@[Zo@J"
},
"travel_mode": "driving",
"distance": {
"text": "۲۳۷ متر",
"value": 237
},
"duration": {
"text": "۲۱ ثانیه ",
"value": 21
},
"start_location": {
"lat": 35.79034,
"lng": 51.41851
},
"end_location": {
"lat": 35.79153,
"lng": 51.41645
}
},
{
"polyline": {
"points": "apmyEygyxHi@IsEm@uB[gBUwFu@IAsG}@gDm@wB_@oDuAuFwBiDsAICaFoBaCaAo@WqAk@iAm@YOaAi@cAq@s@i@c@]gAuAy@qAOYo@sAMYWw@g@iB]{A[oBKaAGsAAkABwBJqF@k@AoA"
},
"travel_mode": "driving",
"distance": {
"text": "۲ کیلومتر ۲۷۴ متر",
"value": 2274
},
"duration": {
"text": "۲ دقیقه ۵۲ ثانیه",
"value": 172
},
"start_location": {
"lat": 35.79153,
"lng": 51.41645
},
"end_location": {
"lat": 35.80675,
"lng": 51.4287
}
},
{
"polyline": {
"points": "eopyEkt{xH@M?]C[EUGMKIGCEAKBKFMNKTALC\\"
},
"travel_mode": "driving",
"distance": {
"text": "۱۲۴ متر",
"value": 124
},
"duration": {
"text": "۱۸ ثانیه ",
"value": 18
},
"start_location": {
"lat": 35.80675,
"lng": 51.4287
},
"end_location": {
"lat": 35.80724,
"lng": 51.42885
}
},
{
"polyline": {
"points": "grpyEiu{xHED"
},
"travel_mode": "driving",
"distance": {
"text": "۴ متر",
"value": 4
},
"duration": {
"text": "",
"value": 0
},
"start_location": {
"lat": 35.80724,
"lng": 51.42885
},
"end_location": {
"lat": 35.80727,
"lng": 51.42882
}
},
{
"polyline": {
"points": "mrpyEcu{xH"
},
"travel_mode": "driving",
"distance": {
"text": "۰ متر",
"value": 0
},
"duration": {
"text": "",
"value": 0
},
"start_location": {
"lat": 35.80727,
"lng": 51.42882
},
"end_location": {
"lat": 35.80727,
"lng": 51.42882
}
}
],
"distance": {
"text": "۱۴ کیلومتر ۰۰۶ متر",
"value": 14006
},
"duration": {
"text": "۱۶ دقیقه ",
"value": 960
},
"start_location": {
"lat": 35.701622,
"lng": 51.419949
},
"end_location": {
"lat": 35.807273,
"lng": 51.428815
}
}
],
"distance": {
"text": "۱۴ کیلومتر ۰۰۶ متر",
"value": 14006
},
"duration": {
"text": "۱۶ دقیقه ",
"value": 960
},
"start_location": {
"lat": 35.701622,
"lng": 51.419949
},
"end_location": {
"lat": 35.807273,
"lng": 51.428815
}
}
],
"status": "OK"
}
درخواست تعیین مسیرهای جایگزین مسیر اصلی
با ارسال مختصات جغرافیایی نقاط مبدا و مقصد، تعیین تعداد کل مسیرهای درخواستی سفر بین مبدا و نوع وسیله نقلیه، مسیرهای سفر بین مبدا و مقصد به همراه فاصله زمانی و مکانی هر سفر در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/direction/route?key=PMI_API_TOKEN&waypoints=51.455469,35.77873|51.369667,35.782449&travel_mode=driving&alternatives=2&steps=true&traffic=true
نمونه پاسخ
{
"routes": [
{
"legs": [
{
"steps": [
{
"polyline": {
"points": "a`kyEu{`yH|Aj@"
},
"travel_mode": "driving",
"distance": {
"text": "۵۵ متر",
"value": 55
},
"duration": {
"text": "۱۶ ثانیه ",
"value": 16
},
"start_location": {
"lat": 35.77873,
"lng": 51.45547
},
"end_location": {
"lat": 35.77826,
"lng": 51.45525
}
},
{
"polyline": {
"points": "c}jyEiz`yHVsAF[b@sB"
},
"travel_mode": "driving",
"distance": {
"text": "۱۱۰ متر",
"value": 110
},
"duration": {
"text": "۲۷ ثانیه ",
"value": 27
},
"start_location": {
"lat": 35.77826,
"lng": 51.45525
},
"end_location": {
"lat": 35.77792,
"lng": 51.45639
}
},
{
"polyline": {
"points": "_{jyEmaayHOGkC_Ae@QUIm@UmBo@s@W"
},
"travel_mode": "driving",
"distance": {
"text": "۲۵۲ متر",
"value": 252
},
"duration": {
"text": "۳۹ ثانیه ",
"value": 39
},
"start_location": {
"lat": 35.77792,
"lng": 51.45639
},
"end_location": {
"lat": 35.78004,
"lng": 51.45736
}
},
{
"polyline": {
"points": "ghkyEogayHBxEE~BOzAYhCWlC?DIL"
},
"travel_mode": "driving",
"distance": {
"text": "۳۳۹ متر",
"value": 339
},
"duration": {
"text": "۴۱ ثانیه ",
"value": 41
},
"start_location": {
"lat": 35.78004,
"lng": 51.45736
},
"end_location": {
"lat": 35.78043,
"lng": 51.45367
}
},
{
"polyline": {
"points": "ujkyEmp`yHEzBLpCLtALvABZPbC^fDFZ"
},
"travel_mode": "driving",
"distance": {
"text": "۳۶۶ متر",
"value": 366
},
"duration": {
"text": "۴۵ ثانیه ",
"value": 45
},
"start_location": {
"lat": 35.78043,
"lng": 51.45367
},
"end_location": {
"lat": 35.77994,
"lng": 51.44967
}
},
{
"polyline": {
"points": "sgkyEmw_yHcB|@iBx@QHqCt@cA^eAb@{@d@uClBIDaAr@_BjAeBjA{@d@m@\\{@^QH_AVu@Pm@P_ANmD~@oCj@WFw@Pu@FaAFg@?Y?yBAeABeAHo@@"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۳۶۹ متر",
"value": 1369
},
"duration": {
"text": "۲ دقیقه ۴۴ ثانیه",
"value": 164
},
"start_location": {
"lat": 35.77994,
"lng": 51.44967
},
"end_location": {
"lat": 35.79143,
"lng": 51.44487
}
},
{
"polyline": {
"points": "momyEmy~xHCJ?HDHFBlBWbAAz@@~BBzBQ"
},
"travel_mode": "driving",
"distance": {
"text": "۲۹۴ متر",
"value": 294
},
"duration": {
"text": "۴۲ ثانیه ",
"value": 42
},
"start_location": {
"lat": 35.79143,
"lng": 51.44487
},
"end_location": {
"lat": 35.78893,
"lng": 51.44488
}
},
{
"polyline": {
"points": "y_myEoy~xHrAIxEs@XGPKl@g@NMNELCJCXBLFHFFDFJN^Lj@Nh@Lj@p@fC"
},
"travel_mode": "driving",
"distance": {
"text": "۴۵۲ متر",
"value": 452
},
"duration": {
"text": "۱ دقیقه ۶ ثانیه",
"value": 66
},
"start_location": {
"lat": 35.78893,
"lng": 51.44488
},
"end_location": {
"lat": 35.7858,
"lng": 51.44395
}
},
{
"polyline": {
"points": "gllyEus~xH|@`Gb@~Cn@|Fv@lGnAdKRrA^vAv@rBz@vA~@nApAvAfBzAbBzA`A|@`AhAvAxB"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۲۳۸ متر",
"value": 1238
},
"duration": {
"text": "۱ دقیقه ۴۰ ثانیه",
"value": 100
},
"start_location": {
"lat": 35.7858,
"lng": 51.44395
},
"end_location": {
"lat": 35.7807,
"lng": 51.43236
}
},
{
"polyline": {
"points": "klkyEgk|xHtAfC`@bA"
},
"travel_mode": "driving",
"distance": {
"text": "۱۱۳ متر",
"value": 113
},
"duration": {
"text": "۹ ثانیه ",
"value": 9
},
"start_location": {
"lat": 35.7807,
"lng": 51.43236
},
"end_location": {
"lat": 35.7801,
"lng": 51.43134
}
},
{
"polyline": {
"points": "shkyE{d|xHn@rBdG`TRt@Nz@Jl@Bn@?j@Cn@g@lEqAjMIx@_G|r@En@GzAG~B?t@?n@D~@Jx@H~@Hz@VvA\\tAX~@\\z@\\|@\\x@h@`Af@r@p@x@p@p@d@`@RVT\\V^FRDV"
},
"travel_mode": "driving",
"distance": {
"text": "۲ کیلومتر ۳۷۱ متر",
"value": 2371
},
"duration": {
"text": "۳ دقیقه ۱۳ ثانیه",
"value": 193
},
"start_location": {
"lat": 35.7801,
"lng": 51.43134
},
"end_location": {
"lat": 35.77782,
"lng": 51.40684
}
},
{
"polyline": {
"points": "kzjyEwkwxHJpADl@Bn@JpAR`Al@fCDZBV@n@Q|BQjBObBIdBChA?dB"
},
"travel_mode": "driving",
"distance": {
"text": "۵۴۱ متر",
"value": 541
},
"duration": {
"text": "۴۴ ثانیه ",
"value": 44
},
"start_location": {
"lat": 35.77782,
"lng": 51.40684
},
"end_location": {
"lat": 35.777589999999996,
"lng": 51.40098
}
},
{
"polyline": {
"points": "}xjyEcgvxHFn@Jv@Rz@XfANb@Pd@N\\Xj@Tb@Zn@h@dAt@tA~A~CTd@Th@Pf@X|AF\\PbABh@B~@@`ACt@Et@Iz@Mj@G\\K^Of@_@`Ay@fBkC`F"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۰۱۸ متر",
"value": 1018
},
"duration": {
"text": "۵۸ ثانیه ",
"value": 58
},
"start_location": {
"lat": 35.777589999999996,
"lng": 51.40098
},
"end_location": {
"lat": 35.77655,
"lng": 51.39109
}
},
{
"polyline": {
"points": "mrjyEiitxHiBrD}BpEm@zAo@lBg@pBWnA"
},
"travel_mode": "driving",
"distance": {
"text": "۴۱۷ متر",
"value": 417
},
"duration": {
"text": "۲۲ ثانیه ",
"value": 22
},
"start_location": {
"lat": 35.77655,
"lng": 51.39109
},
"end_location": {
"lat": 35.7785,
"lng": 51.38716
}
},
{
"polyline": {
"points": "s~jyEwpsxHQlAK`BEf@Ex@?dC?zADv@Dn@VnBnBzN|@tGj@nE"
},
"travel_mode": "driving",
"distance": {
"text": "۷۹۲ متر",
"value": 792
},
"duration": {
"text": "۴۹ ثانیه ",
"value": 49
},
"start_location": {
"lat": 35.7785,
"lng": 51.38716
},
"end_location": {
"lat": 35.77744,
"lng": 51.37861
}
},
{
"polyline": {
"points": "_xjyEi{qxHF`BFbAFr@Ff@@N?P?RCTEREPINKLWPgAXuA\\_@LeA^"
},
"travel_mode": "driving",
"distance": {
"text": "۳۵۶ متر",
"value": 356
},
"duration": {
"text": "۴۰ ثانیه ",
"value": 40
},
"start_location": {
"lat": 35.77744,
"lng": 51.37861
},
"end_location": {
"lat": 35.77888,
"lng": 51.376
}
},
{
"polyline": {
"points": "_akyE_kqxHqDp@WF{D`AKB_AXa@H_@C_@M"
},
"travel_mode": "driving",
"distance": {
"text": "۳۲۴ متر",
"value": 324
},
"duration": {
"text": "۳۶ ثانیه ",
"value": 36
},
"start_location": {
"lat": 35.77888,
"lng": 51.376
},
"end_location": {
"lat": 35.7817,
"lng": 51.37527
}
},
{
"polyline": {
"points": "srkyEmfqxHQKSCS@SJMNIVCV@VFVLPPJ"
},
"travel_mode": "driving",
"distance": {
"text": "۱۲۵ متر",
"value": 125
},
"duration": {
"text": "۲۳ ثانیه ",
"value": 23
},
"start_location": {
"lat": 35.7817,
"lng": 51.37527
},
"end_location": {
"lat": 35.78202,
"lng": 51.37457
}
},
{
"polyline": {
"points": "stkyEabqxHXd@N`@VbB`@pCbAfH"
},
"travel_mode": "driving",
"distance": {
"text": "۲۹۴ متر",
"value": 294
},
"duration": {
"text": "۳۶ ثانیه ",
"value": 36
},
"start_location": {
"lat": 35.78202,
"lng": 51.37457
},
"end_location": {
"lat": 35.78118,
"lng": 51.3715
}
},
{
"polyline": {
"points": "kokyE{npxHQDqDx@a@N[ZKb@C^@dAG`@Sb@"
},
"travel_mode": "driving",
"distance": {
"text": "۲۵۲ متر",
"value": 252
},
"duration": {
"text": "۴۷ ثانیه ",
"value": 47
},
"start_location": {
"lat": 35.78118,
"lng": 51.3715
},
"end_location": {
"lat": 35.78268,
"lng": 51.36992
}
},
{
"polyline": {
"points": "wxkyE_epxH"
},
"travel_mode": "driving",
"distance": {
"text": "۰ متر",
"value": 0
},
"duration": {
"text": "",
"value": 0
},
"start_location": {
"lat": 35.78268,
"lng": 51.36992
},
"end_location": {
"lat": 35.78268,
"lng": 51.36992
}
}
],
"distance": {
"text": "۱۱ کیلومتر ۰۸۸ متر",
"value": 11088
},
"duration": {
"text": "۱۸ دقیقه ۲۶ ثانیه",
"value": 1106
},
"start_location": {
"lat": 35.77873,
"lng": 51.455469
},
"end_location": {
"lat": 35.782676,
"lng": 51.369921
}
}
],
"distance": {
"text": "۱۱ کیلومتر ۰۸۸ متر",
"value": 11088
},
"duration": {
"text": "۱۸ دقیقه ۲۶ ثانیه",
"value": 1106
},
"start_location": {
"lat": 35.77873,
"lng": 51.455469
},
"end_location": {
"lat": 35.782676,
"lng": 51.369921
}
},
{
"legs": [
{
"steps": [
{
"polyline": {
"points": "a`kyEu{`yH|Aj@"
},
"travel_mode": "driving",
"distance": {
"text": "۵۵ متر",
"value": 55
},
"duration": {
"text": "۱۶ ثانیه ",
"value": 16
},
"start_location": {
"lat": 35.77873,
"lng": 51.45547
},
"end_location": {
"lat": 35.77826,
"lng": 51.45525
}
},
{
"polyline": {
"points": "c}jyEiz`yHVsAF[b@sB"
},
"travel_mode": "driving",
"distance": {
"text": "۱۱۰ متر",
"value": 110
},
"duration": {
"text": "۲۷ ثانیه ",
"value": 27
},
"start_location": {
"lat": 35.77826,
"lng": 51.45525
},
"end_location": {
"lat": 35.77792,
"lng": 51.45639
}
},
{
"polyline": {
"points": "_{jyEmaayHOGkC_Ae@QUIm@UmBo@s@W"
},
"travel_mode": "driving",
"distance": {
"text": "۲۵۲ متر",
"value": 252
},
"duration": {
"text": "۳۹ ثانیه ",
"value": 39
},
"start_location": {
"lat": 35.77792,
"lng": 51.45639
},
"end_location": {
"lat": 35.78004,
"lng": 51.45736
}
},
{
"polyline": {
"points": "ghkyEogayHBxEE~BOzAYhCWlC?DIL"
},
"travel_mode": "driving",
"distance": {
"text": "۳۳۹ متر",
"value": 339
},
"duration": {
"text": "۴۱ ثانیه ",
"value": 41
},
"start_location": {
"lat": 35.78004,
"lng": 51.45736
},
"end_location": {
"lat": 35.78043,
"lng": 51.45367
}
},
{
"polyline": {
"points": "ujkyEmp`yHEzBLpCLtALvABZPbC^fDFZ"
},
"travel_mode": "driving",
"distance": {
"text": "۳۶۶ متر",
"value": 366
},
"duration": {
"text": "۴۵ ثانیه ",
"value": 45
},
"start_location": {
"lat": 35.78043,
"lng": 51.45367
},
"end_location": {
"lat": 35.77994,
"lng": 51.44967
}
},
{
"polyline": {
"points": "sgkyEmw_yHcB|@iBx@QHqCt@cA^eAb@{@d@uClBIDaAr@_BjAeBjA{@d@m@\\{@^QH_AVu@Pm@P_ANmD~@oCj@WFw@Pu@F"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۱۲۳ متر",
"value": 1123
},
"duration": {
"text": "۲ دقیقه ۷ ثانیه",
"value": 127
},
"start_location": {
"lat": 35.77994,
"lng": 51.44967
},
"end_location": {
"lat": 35.78922,
"lng": 51.44498
}
},
{
"polyline": {
"points": "samyEcz~xHSWIUm@yEEK"
},
"travel_mode": "driving",
"distance": {
"text": "۱۳۵ متر",
"value": 135
},
"duration": {
"text": "۲۰ ثانیه ",
"value": 20
},
"start_location": {
"lat": 35.78922,
"lng": 51.44498
},
"end_location": {
"lat": 35.78963,
"lng": 51.44636
}
},
{
"polyline": {
"points": "edmyEwb_yHzCq@vCo@jAWzA]t@QZB"
},
"travel_mode": "driving",
"distance": {
"text": "۳۲۰ متر",
"value": 320
},
"duration": {
"text": "۴۷ ثانیه ",
"value": 47
},
"start_location": {
"lat": 35.78963,
"lng": 51.44636
},
"end_location": {
"lat": 35.78684,
"lng": 51.44719
}
},
{
"polyline": {
"points": "wrlyE}g_yHlA`Fb@hB\\|Az@|E|@|F?Bb@`Db@bER~AF^f@fEnAbKTrA^zAv@pBz@xAz@rArArAjA|@ZXfB|AbAv@dA~@~AdBxAtCl@dAl@bBx@fE"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۸۲۲ متر",
"value": 1822
},
"duration": {
"text": "۲ دقیقه ۹ ثانیه",
"value": 129
},
"start_location": {
"lat": 35.78684,
"lng": 51.44719
},
"end_location": {
"lat": 35.77943,
"lng": 51.42993
}
},
{
"polyline": {
"points": "mdkyEa|{xHb@|AVdA`@`BTv@Z`AZl@Zh@^`@^Vd@Rf@H\\?b@CXINKPKHKl@i@X[NMTM`@KRCVAd@?t@Br@@"
},
"travel_mode": "driving",
"distance": {
"text": "۶۱۳ متر",
"value": 613
},
"duration": {
"text": "۴۳ ثانیه ",
"value": 43
},
"start_location": {
"lat": 35.77943,
"lng": 51.42993
},
"end_location": {
"lat": 35.77538,
"lng": 51.42793
}
},
{
"polyline": {
"points": "ckjyEqo{xH`B^f@Pf@TpAr@r@d@z@l@vGhF`BfAxBvAnDtB`GbDLHfF`C"
},
"travel_mode": "driving",
"distance": {
"text": "۹۸۱ متر",
"value": 981
},
"duration": {
"text": "۱ دقیقه ۹ ثانیه",
"value": 69
},
"start_location": {
"lat": 35.77538,
"lng": 51.42793
},
"end_location": {
"lat": 35.76762,
"lng": 51.42281
}
},
{
"polyline": {
"points": "szhyEqozxHPVHV@b@mAtNCToB~VwBtXEb@MT"
},
"travel_mode": "driving",
"distance": {
"text": "۱ کیلومتر ۰۴۲ متر",
"value": 1042
},
"duration": {
"text": "۲ دقیقه ۳ ثانیه",
"value": 123
},
"start_location": {
"lat": 35.76762,
"lng": 51.42281
},
"end_location": {
"lat": 35.76914,
"lng": 51.41153
}
},
{
"polyline": {
"points": "cdiyEaixxHsCa@aDc@gDa@QC"
},
"travel_mode": "driving",
"distance": {
"text": "۲۷۹ متر",
"value": 279
},
"duration": {
"text": "۳۴ ثانیه ",
"value": 34
},
"start_location": {
"lat": 35.76914,
"lng": 51.41153
},
"end_location": {
"lat": 35.77162,
"lng": 51.41207
}
},
{
"polyline": {
"points": "ssiyEmlxxHCPa@dCQd@Ol@MZWh@QZ]`@aAx@QJq@h@yEzDcCbB[t@QLi@b@w@l@qAjAk@l@a@b@u@dAYp@_@dAQd@U|Ac@jESvBKr@OnAGt@Gn@SrDCd@@p@BXPvAXjAj@dBh@jAHPrAbCfAtB~AtCXh@f@lAb@tAF\\PbABh@B~@@`ACt@Et@Iz@Mj@G\\K^Of@_@`Ay@fBkC`F"
},
"travel_mode": "driving",
"distance": {
"text": "۲ کیلومتر ۳۰۹ متر",
"value": 2309
},
"duration": {
"text": "۲ دقیقه ۱۷ ثانیه",
"value": 137
},
"start_location": {
"lat": 35.77162,
"lng": 51.41207
},
"end_location": {
"lat": 35.77655,
"lng": 51.39109
}
},
{
"polyline": {
"points": "mrjyEiitxHiBrD}BpEm@zAo@lBg@pBWnA"
},
"travel_mode": "driving",
"distance": {
"text": "۴۱۷ متر",
"value": 417
},
"duration": {
"text": "۲۲ ثانیه ",
"value": 22
},
"start_location": {
"lat": 35.77655,
"lng": 51.39109
},
"end_location": {
"lat": 35.7785,
"lng": 51.38716
}
},
{
"polyline": {
"points": "s~jyEwpsxHQlAK`BEf@Ex@?dC?zADv@Dn@VnBnBzN|@tGj@nE"
},
"travel_mode": "driving",
"distance": {
"text": "۷۹۲ متر",
"value": 792
},
"duration": {
"text": "۴۹ ثانیه ",
"value": 49
},
"start_location": {
"lat": 35.7785,
"lng": 51.38716
},
"end_location": {
"lat": 35.77744,
"lng": 51.37861
}
},
{
"polyline": {
"points": "_xjyEi{qxHF`BFbAFr@Ff@@N?P?RCTEREPINKLWPgAXuA\\_@LeA^"
},
"travel_mode": "driving",
"distance": {
"text": "۳۵۶ متر",
"value": 356
},
"duration": {
"text": "۴۰ ثانیه ",
"value": 40
},
"start_location": {
"lat": 35.77744,
"lng": 51.37861
},
"end_location": {
"lat": 35.77888,
"lng": 51.376
}
},
{
"polyline": {
"points": "_akyE_kqxHqDp@WF{D`AKB_AXa@H_@C_@M"
},
"travel_mode": "driving",
"distance": {
"text": "۳۲۴ متر",
"value": 324
},
"duration": {
"text": "۳۶ ثانیه ",
"value": 36
},
"start_location": {
"lat": 35.77888,
"lng": 51.376
},
"end_location": {
"lat": 35.7817,
"lng": 51.37527
}
},
{
"polyline": {
"points": "srkyEmfqxHQKSCS@SJMNIVCV@VFVLPPJ"
},
"travel_mode": "driving",
"distance": {
"text": "۱۲۵ متر",
"value": 125
},
"duration": {
"text": "۲۳ ثانیه ",
"value": 23
},
"start_location": {
"lat": 35.7817,
"lng": 51.37527
},
"end_location": {
"lat": 35.78202,
"lng": 51.37457
}
},
{
"polyline": {
"points": "stkyEabqxHXd@N`@VbB`@pCbAfH"
},
"travel_mode": "driving",
"distance": {
"text": "۲۹۴ متر",
"value": 294
},
"duration": {
"text": "۳۶ ثانیه ",
"value": 36
},
"start_location": {
"lat": 35.78202,
"lng": 51.37457
},
"end_location": {
"lat": 35.78118,
"lng": 51.3715
}
},
{
"polyline": {
"points": "kokyE{npxHQDqDx@a@N[ZKb@C^@dAG`@Sb@"
},
"travel_mode": "driving",
"distance": {
"text": "۲۵۲ متر",
"value": 252
},
"duration": {
"text": "۴۷ ثانیه ",
"value": 47
},
"start_location": {
"lat": 35.78118,
"lng": 51.3715
},
"end_location": {
"lat": 35.78268,
"lng": 51.36992
}
},
{
"polyline": {
"points": "wxkyE_epxH"
},
"travel_mode": "driving",
"distance": {
"text": "۰ متر",
"value": 0
},
"duration": {
"text": "",
"value": 0
},
"start_location": {
"lat": 35.78268,
"lng": 51.36992
},
"end_location": {
"lat": 35.78268,
"lng": 51.36992
}
}
],
"distance": {
"text": "۱۲ کیلومتر ۳۱۵ متر",
"value": 12315
},
"duration": {
"text": "۱۹ دقیقه ۲۲ ثانیه",
"value": 1162
},
"start_location": {
"lat": 35.77873,
"lng": 51.455469
},
"end_location": {
"lat": 35.782676,
"lng": 51.369921
}
}
],
"distance": {
"text": "۱۲ کیلومتر ۳۱۵ متر",
"value": 12315
},
"duration": {
"text": "۱۹ دقیقه ۲۲ ثانیه",
"value": 1162
},
"start_location": {
"lat": 35.77873,
"lng": 51.455469
},
"end_location": {
"lat": 35.782676,
"lng": 51.369921
}
}
],
"status": "OK"
}
درخواست تخمین زمان و مسافت سفر با وسیله نقلیه خودرو
با ارسال مختصات جغرافیایی نقاط مبدا و مقصد، فاصله زمانی و مکانی بین دو نقطه در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/direction/route?key=PMI_API_TOKEN&waypoints=51.39903,35.75988|51.39392,35.75686&travel_mode=driving&provide_steps=false&traffic=true
نمونه پاسخ
{
"routes": [
{
"legs": [
{
"distance": {
"text": "۱ کیلومتر ۰۵۱ متر",
"value": 1051
},
"duration": {
"text": "۱ دقیقه ۵۳ ثانیه",
"value": 113
},
"start_location": {
"lat": 35.759874,
"lng": 51.399031
},
"end_location": {
"lat": 35.756821,
"lng": 51.393923
}
}
],
"distance": {
"text": "۱ کیلومتر ۰۵۱ متر",
"value": 1051
},
"duration": {
"text": "۱ دقیقه ۵۳ ثانیه",
"value": 113
},
"start_location": {
"lat": 35.759874,
"lng": 51.399031
},
"end_location": {
"lat": 35.756821,
"lng": 51.393923
}
}
],
"status": "OK"
}
درخواست تخمین زمان و مسافت سفر با وسیله نقلیه موتورسیکلت
با ارسال مختصات جغرافیایی نقاط مبدا و مقصد و تعیین وسیله نقلیه موتورسیکلت، فاصله زمانی و مکانی بین دو نقطه در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/direction/route?key=PMI_API_TOKEN&waypoints=51.39796,35.75777| 51.40271,35.75484&travel_mode=driving&provide_steps=false&traffic=true
نمونه پاسخ
{
"routes": [
{
"legs": [
{
"distance": {
"text": "۱ کیلومتر ۰۰۷ متر",
"value": 1007
},
"duration": {
"text": "۲ دقیقه ۱۲ ثانیه",
"value": 132
},
"start_location": {
"lat": 35.75777,
"lng": 51.397954
},
"end_location": {
"lat": 35.75484,
"lng": 51.40271
}
}
],
"distance": {
"text": "۱ کیلومتر ۰۰۷ متر",
"value": 1007
},
"duration": {
"text": "۲ دقیقه ۱۲ ثانیه",
"value": 132
},
"start_location": {
"lat": 35.75777,
"lng": 51.397954
},
"end_location": {
"lat": 35.75484,
"lng": 51.40271
}
}
],
"status": "OK"
}