مسیریابی
مسیر خودرو، موتورسیکلت، پیاده و دوچرخه با دستورهای فارسی مرحلهبهمرحله.
GET https://api.uttamap.ir/v1/route
| پارامتر | توضیح |
|---|---|
origin | lat,lng مبدأ (الزامی) |
destination | lat,lng مقصد (الزامی) |
waypoints | نقاط میانی، جداشده با خط عمودی، حداکثر ۲۵ |
mode | car (پیشفرض)، motorcycle، walk، bike |
steps | true برای دستورهای مرحلهبهمرحله |
alternatives | true برای مسیرهای جایگزین |
geometry | polyline6 (پیشفرض) یا geojson |
curl -H "X-Api-Key: um_sk_..." \
"https://api.uttamap.ir/v1/route?origin=35.6997,51.3380&destination=35.7575,51.4100&mode=car&steps=true"
{
"routes": [
{
"distance_m": 11645,
"duration_s": 586,
"geometry": "…",
"legs": [
{
"steps": [
{ "instruction": "به سمت شرق در میدان آزادی حرکت کنید.", "distance_m": 371, "maneuver": "depart", "location": [51.338179, 35.698735] },
{ "instruction": "از میدان خارج شوید و وارد بزرگراه محمدعلی جناح شوید.", "distance_m": 1074, "maneuver": "roundabout_exit" }
]
}
]
}
]
}
موتورسیکلت
طبق آییننامهٔ راهنمایی و رانندگی، مسیر موتورسیکلت هرگز وارد آزادراه و بزرگراه نمیشود. به همین دلیل مسیر موتور گاهی بلندتر از خودرو است. هیچ مسیری هم خلاف جهت خیابان یکطرفه نیست.
نمایش روی نقشه
با geometry=geojson خط مسیر را مستقیم بهعنوان منبع GeoJSON به MapLibre بدهید. polyline6 کوچکتر است و با کتابخانههایی مثل @mapbox/polyline (با precision برابر ۶) باز میشود.
حداکثر فاصلهٔ مستقیم مبدأ تا مقصد ۲۵۰۰ کیلومتر است. مسیریابی ترافیک زنده ندارد.