پرش به محتوا

مسیریابی

مسیر خودرو، موتورسیکلت، پیاده و دوچرخه با دستورهای فارسی مرحله‌به‌مرحله.

GET https://api.uttamap.ir/v1/route

پارامترتوضیح
originlat,lng مبدأ (الزامی)
destinationlat,lng مقصد (الزامی)
waypointsنقاط میانی، جداشده با خط عمودی، حداکثر ۲۵
modecar (پیش‌فرض)، motorcycle، walk، bike
stepstrue برای دستورهای مرحله‌به‌مرحله
alternativestrue برای مسیرهای جایگزین
geometrypolyline6 (پیش‌فرض) یا 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 برابر ۶) باز می‌شود.

حداکثر فاصلهٔ مستقیم مبدأ تا مقصد ۲۵۰۰ کیلومتر است. مسیریابی ترافیک زنده ندارد.