کجامجا
API ماتریس فاصله و بهینه‌سازی مسیر
زمان و مسافت بین چند مبدأ و چند مقصد، بهترین ترتیب بازدید از چند نشانی و تطبیق رد جی‌پی‌اس با خیابان؛ برای پیک، پخش و ناوگان.
سه سرویس برای پیک، پخش و ناوگان
این سه سرویس روی همان موتور مسیریابی کجامجا کار می‌کنند و مسافت و زمان را از روی راه‌های واقعی حساب می‌کنند، نه خط مستقیم.
ماتریس فاصله
زمان و مسافت از چند مبدأ به چند مقصد در یک درخواست؛ برای انتخاب نزدیک‌ترین راننده یا شعبه.
بهینه‌سازی مسیر چند مقصدی
بهترین ترتیب بازدید از چند نشانی؛ برای پیک، ویزیتور، پخش مویرگی و سرویس.
تطبیق رد جی‌پی‌اس
نشاندن نقطه‌های خام ردیاب روی خیابان و محاسبه‌ی مسافت واقعی طی‌شده.
سقف و شمارش مصرف
| سرویس | درخواست | سقف هر درخواست | شمارش مصرف |
|---|---|---|---|
| ماتریس فاصله | GET /matrix | ۵۰ نقطه و ۱٬۰۰۰ خانه | هر خانه‌ی ماتریس یک درخواست |
| بهینه‌سازی مسیر | GET /optimize | ۲۵ نقطه | هر نقطه یک درخواست |
| تطبیق رد جی‌پی‌اس | GET /match | ۱۰۰ نقطه | هر ۱۰ نقطه یک درخواست |
هدر X-Quota-Units در هر پاسخ نشان می‌دهد چند درخواست شمرده شده است.
نمونه‌ها
ماتریس: فاصله‌ی یک راننده (نقطه‌ی ۰) تا دو مشتری (نقطه‌های ۱ و ۲):
curl -H "x-api-key: YOUR_KEY" \ "https://api.kojamoja.ir/matrix?point=35.6892,51.389&point=35.70,51.42&point=35.75,51.41&sources=0&destinations=1,2"
بهینه‌سازی: بهترین ترتیب بازدید از سه نشانی با شروع از انبار (نقطه‌ی اول):
curl -H "x-api-key: YOUR_KEY" \ "https://api.kojamoja.ir/optimize?point=35.6892,51.389&point=35.75,51.41&point=35.70,51.42&point=35.72,51.35"
پاسخ بهینه‌سازی شامل order (ترتیب نقطه‌ها)، مسافت و زمان کل و خط مسیر است. با roundtrip=false مسیر در نقطه‌ی آخر تمام می‌شود. پارامترهای کامل در امکانات و مستندات آمده است.
کاربردها
- تاکسی و پیک: پیدا کردن نزدیک‌ترین راننده‌ی آزاد به مشتری.
- پخش و فروش مویرگی: چیدن ترتیب بازدید روزانه‌ی ویزیتور یا ماشین پخش.
- فروشگاه چندشعبه‌ای: انتخاب نزدیک‌ترین شعبه یا انبار برای ارسال سفارش.
- ردیابی ناوگان: محاسبه‌ی کیلومتر واقعی طی‌شده از روی داده‌ی ردیاب.
پرسش‌های پرتکرار
ماتریس فاصله چه فرقی با مسیریابی معمولی دارد؟
مسیریابی برای یک مبدأ و یک مقصد، خط مسیر و راهنما می‌دهد. ماتریس برای چند نقطه فقط زمان و مسافت را برمی‌گرداند و برای مقایسه‌ی سریع تعداد زیادی مسیر مناسب است.
برای دوچرخه و پیاده هم کار می‌کند؟
ماتریس فاصله با profile برای خودرو، دوچرخه و پیاده کار می‌کند.
مصرف چطور حساب می‌شود؟
ماتریس به تعداد خانه‌ها (مبدأ × مقصد)، بهینه‌سازی به تعداد نقطه‌ها و تطبیق رد به‌ازای هر ۱۰ نقطه. سهمیه‌ی هر پلن در قیمت‌گذاری آمده است.
آیا ترافیک لحظه‌ای در نظر گرفته می‌شود؟
خیر. زمان‌ها بر پایه‌ی نوع راه و سرعت معمول آن است.