سرویس مسیریابی

Routing Service

محاسبه مسیر بین دو نقطه

Endpoint

POST /routing

Request Body

{
  "start_point": "54.34554323921548,31.88532112820928",
  "end_point": "54.35048855277665,31.89800297525572",
  "type": "osm_offline"
}

Body Parameters

Request Example

curl 'https://service.geotajak.ir/routing' \
  -X POST \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "start_point": "54.34554323921548,31.88532112820928",
    "end_point": "54.35048855277665,31.89800297525572",
    "type": "osm_offline"
  }'

Response Example

{
  "result": {
    "code": "Ok",
    "routes": [
      {
        "geometry": "grraEojujIcXjGaC]kAgCqRu{@gGtCgSfT",
        "legs": [
          {
            "steps": [
              {
                "geometry": "grraEojujIeATs@PoAX[Jc@V",
                "maneuver": {
                  "bearing_after": 344,
                  "bearing_before": 0,
                  "location": [54.345523, 31.885316],
                  "type": "depart"
                },
                "mode": "driving",
                "driving_side": "right",
                "name": "",
                "intersections": [...],
                "weight": 18.7,
                "duration": 18.7,
                "distance": 156.1
              },
              ...
            ],
            "summary": "بلوار پاک نژاد, بلوار مطهری",
            "weight": 161.8,
            "duration": 161.8,
            "distance": 2246.4
          }
        ],
        "weight_name": "routability",
        "weight": 161.8,
        "duration": 161.8,
        "distance": 2246.4
      }
    ],
    "waypoints": [
      {
        "hint": "...",
        "distance": 1.97,
        "name": "",
        "location": [54.345523, 31.885316]
      },
      {
        "hint": "...",
        "distance": 9.86,
        "name": "بلوار مطهری",
        "location": [54.350567, 31.898062]
      }
    ]
  },
  "status": 200,
  "success": true,
  "messages": []
}

Response Fields

• code: کد وضعیت مسیریابی (Ok در صورت موفقیت)
• routes: آرایه‌ای از مسیرهای پیشنهادی
  • geometry: هندسه مسیر به فرمت Polyline
  • legs: بخش‌های مسیر
    • steps: گام‌های مسیر
      • geometry: هندسه این گام
      • maneuver: اطلاعات مانور (پیچ، مستقیم، و...)
        • bearing_after/before: جهت قبل و بعد از مانور
        • location: مختصات مانور
        • type: نوع مانور (depart, turn, arrive)
        • modifier: جزئیات مانور (left, right, slight)
      • mode: حالت رانندگی (driving)
      • name: نام خیابان
      • duration: زمان به ثانیه
      • distance: مسافت به متر
      • weight: وزن مسیر
    • summary: خلاصه خیابان‌های مسیر
    • duration: کل زمان این بخش (ثانیه)
    • distance: کل مسافت این بخش (متر)
  • duration: کل زمان مسیر (ثانیه)
  • distance: کل مسافت مسیر (متر)
• waypoints: نقاط شروع و پایان واقعی (نزدیک‌ترین نقطه روی جاده)

Routing Types

• osm_offline: مسیریابی آفلاین بر اساس OpenStreetMap

---

Error Handling

Error Response Format

{
  "detail": "Error message description",
  "status": 403
}

Common Error Codes