کجامجا
API مسیریابی ایران
مسیر، مسافت و زمان بین دو نقطه در سراسر ایران برای خودرو، دوچرخه، پیاده و اتوبوس، همراه با راهنمای فارسی گام‌به‌گام.
API مسیریابی کجامجا چه می‌دهد؟
با یک درخواست ساده، مبدأ و مقصد را می‌فرستید و مسیر پیشنهادی را می‌گیرید: خط مسیر برای کشیدن روی نقشه، مسافت به متر، زمان به ثانیه و متن فارسی راهنما.
خودرو
مسیر رانندگی با رعایت خیابان‌های یک‌طرفه و محدودیت‌های گردش.
پیاده
مسیر پیاده‌روی از پیاده‌راه‌ها، کوچه‌ها و پل‌های عابر.
دوچرخه
مسیر مناسب دوچرخه در سطح شهر.
اتوبوس
ترکیب پیاده‌روی و خطوط اتوبوس با تعویض خط؛ زمان‌ها تخمینی است.
راهنمای فارسی
دستورالعمل پیچ‌به‌پیچ به فارسی، آماده برای راهنمای صوتی در اپ شما.
میزبانی داخل ایران
موتور مسیریابی روی سرورهای داخلی است و به سرویس خارجی وابسته نیست.
کاربردها
- تاکسی اینترنتی و پیک: محاسبه‌ی مسافت و زمان سفر برای قیمت‌گذاری.
- فروشگاه اینترنتی: برآورد هزینه و زمان ارسال تا نشانی مشتری.
- صفحه‌ی شعبه‌ها و املاک: دکمه‌ی «مسیر تا اینجا» برای بازدیدکننده.
- اپ ناوبری و گردشگری: نمایش مسیر با راهنمای فارسی.
نمونه‌ی درخواست
GET /route?point=lat,lng&point=lat,lng&profile=car
| پارامتر | توضیح |
|---|---|
point | دو بار: اول مبدأ، دوم مقصد؛ به شکل عرض,طول |
profile | car، bicycle، foot یا bus |
curl -H "x-api-key: YOUR_KEY" \ "https://api.kojamoja.ir/route?point=35.7,51.4&point=35.8,51.45&profile=car"
پاسخ شامل هندسه‌ی مسیر، مسافت (متر)، زمان (ثانیه) و instructionsFa است. هر فراخوانی یک درخواست حساب می‌شود و خطاهای سمت کجامجا شمرده نمی‌شوند.
پرسش‌های پرتکرار
آیا ترافیک لحظه‌ای در زمان مسیر حساب می‌شود؟
خیر. زمان‌ها بر پایه‌ی نوع راه و سرعت معمول آن محاسبه می‌شوند و ترافیک لحظه‌ای ندارند.
مسیریابی اتوبوس چطور کار می‌کند؟
مسیر را از روی خطوط و ایستگاه‌های اتوبوس می‌سازد: پیاده تا ایستگاه، سواری و در صورت نیاز تعویض خط. چون برنامه‌ی زمانی دقیق اتوبوس‌ها در دسترس نیست، زمان‌ها تخمینی‌اند.
همه‌ی نوع‌های مسیریابی در هر پلن هست؟
نوع‌های مسیریابی فعال به پلن شما بستگی دارد. اگر نوعی در پلن شما نباشد، پاسخ ۴۰۳ می‌گیرید. جزئیات در قیمت‌گذاری و پنل شماست.
کل ایران را پوشش می‌دهد؟
بله، شبکه‌ی راه‌های سراسر کشور، از بزرگراه تا کوچه.
برای چند مقصد با هم چه کنم؟
برای زمان و مسافت بین چند نقطه یا پیدا کردن بهترین ترتیب بازدید، از API ماتریس فاصله و بهینه‌سازی مسیر استفاده کنید.