زمان خواندن: 5 دقیقه
پلتفرم ناوگان
نرم افزار تلفن همراه

ساخت یکپارچه‌سازی‌های سفارشی
با رابط برنامه‌نویسی زئو

سیستم‌های خود را با استفاده از RESTful API به Zeo متصل کنید. مسیرها را ایجاد کنید،
پیشرفت را به صورت بلادرنگ پیگیری کنید و گردش‌های کاری را با وب‌هوک‌ها خودکار کنید.

رابط برنامه‌نویسی کاربردی و وب‌هوک‌های زئو، برنامه‌ریز مسیر زئو
  • ٪۱۰۰

    SLA مربوط به آپتایم API

  • 100ms

    میانگین زمان پاسخ

  • 20 +

    نقاط پایانی API

  • 10K

    محدودیت درخواست/دقیقه

پلتفرم توسعه دهنده امکانات

هر آنچه برای ادغام برنامه‌ریزی مسیر در برنامه‌های خود نیاز دارید

  • رابط برنامه‌نویسی کاربردی و وب‌هوک‌های زئو، برنامه‌ریز مسیر زئو

    REST API

    API RESTful با امکانات کامل برای مدیریت مسیرها، ایستگاه‌ها، رانندگان و موارد دیگر. فرمت درخواست/پاسخ JSON با مستندات جامع.

    • ایجاد و بهینه‌سازی مسیرها به صورت برنامه‌نویسی‌شده
    • مدیریت ایستگاه‌ها، رانندگان و وسایل نقلیه
    • بازیابی داده‌های ردیابی در زمان واقعی
    • دسترسی به تحلیل‌ها و گزارش‌ها
    • پشتیبانی از عملیات انبوه
  • رابط برنامه‌نویسی کاربردی و وب‌هوک‌های زئو، برنامه‌ریز مسیر زئو

    رویدادهای وب‌هوک

    اعلان‌های رویداد در لحظه به نقاط انتهایی شما ارسال می‌شوند. فوراً به تغییرات مسیر، توقف تکمیل‌ها و به‌روزرسانی‌های درایور واکنش نشان دهید.

    • رویدادهای شروع/تکمیل‌شده‌ی مسیر
    • اعلان‌های تغییر وضعیت را متوقف کنید
    • به‌روزرسانی‌های موقعیت مکانی راننده
    • هشدارهای تغییر ETA
  • رابط برنامه‌نویسی کاربردی و وب‌هوک‌های زئو، برنامه‌ریز مسیر زئو

    تصدیق

    دسترسی امن به API با احراز هویت استاندارد صنعتی. انواع کلید چندگانه برای سطوح دسترسی و موارد استفاده مختلف.

    • احراز هویت توکن حامل
    • داشبورد مدیریت کلید API
    • مجوزهای محدود به ازای هر کلید
    • پشتیبانی از چرخش کلید
    • محدود کردن سرعت به ازای هر کلید
  • رابط برنامه‌نویسی کاربردی و وب‌هوک‌های زئو، برنامه‌ریز مسیر زئو

    واردات شخص ثالث

    وارد کردن یکپارچه سفارشات و کارها از سیستم‌های خارجی. اعتبارسنجی خودکار آدرس و تعیین مختصات جغرافیایی هنگام وارد کردن.

    • نقطه پایانی توقف واردات انبوه
    • اعتبارسنجی آدرس و ژئوکدینگ
    • نگاشت فیلد سفارشی
    • تشخیص تکراری
    • پیگیری وضعیت واردات

webhook رویدادها

در رویدادهای بلادرنگ مشترک شوید و فوراً به تغییرات مسیر واکنش نشان دهید

  • قاب ۱۷۰۷۴۷۸۳۱۴ ۱ ۱، برنامه‌ریز مسیر Zeo

    مسیر.شروع شده

    زمانی که راننده شروع به پیمایش یک مسیر می‌کند، فعال می‌شود. شامل شناسه مسیر، اطلاعات راننده و زمان تقریبی اتمام مسیر می‌شود.

  • قاب 1707478314 19، Zeo Route Planner

    توقف.تکمیل شده

    وقتی یک توقف کامل علامت‌گذاری شود، فعال می‌شود. شامل داده‌های اثبات سرویس، مهرهای زمانی و یادداشت‌ها است.

  • قاب 1707478314 17، Zeo Route Planner

    توقف.ناموفق

    ارسال شده زمانی که توقف کامل نشد. شامل دلیل شکست و هرگونه عکس/یادداشت گرفته شده.

  • گروه 11880، Zeo Route Planner

    به‌روزرسانی موقعیت مکانی راننده

    به‌روزرسانی‌های دوره‌ای موقعیت مکانی برای رانندگان فعال. فواصل زمانی قابل تنظیم از ۳۰ ثانیه تا ۵ دقیقه.

  • Group 11880 1, Zeo Route Planner

    اتا.تغییر یافته

    زمانی که زمان تخمینی رسیدن به دلیل ترافیک یا تأخیر به طور قابل توجهی تغییر کند، اخراج می‌شود.

  • Group 11880 2, Zeo Route Planner

    مسیر.تکمیل شده

    وقتی تمام مراحل انجام شد، فعال می‌شود. شامل آمار نهایی، مدت زمان و معیارهای عملکرد است.

  • // مثالی از بار داده وب‌هوک
    {
      «رویداد»: "توقف.تکمیل شد",
      "مهر زمان": "2024-01-15T14:32:00Z",
      "داده ها":{
        "شناسه_مسیر": "مسیر_abc123",
        "ایست_آیدی": "stop_xyz789",
        "راننده":{
          «شناسه»: "drv_456",
          "نام": «جان اسمیت»
        },
        "تکمیل_شده": "2024-01-15T14:31:45Z",
        "اثبات":{
          «امضا»: "https://...",
          "عکس‌ها":"https://..."],
          "یادداشت": «درِ خانه مانده»
        } } }

    نقاط پایانی API بررسی اجمالی

    نقاط پایانی اصلی برای برنامه‌ریزی مسیر و مدیریت ناوگان

    پست
    /v1/مسیرها

    ایجاد مسیر جدید با توقف‌ها و تنظیمات بهینه‌سازی

    شو
    /v1/routes/{id}

    جزئیات مسیر از جمله توالی بهینه شده را بازیابی کنید

    پست
    /v1/routes/{id}/optimize

    بهینه‌سازی مجدد یک مسیر موجود با پارامترهای به‌روزرسانی‌شده

    شو
    /v1/routes/{id}/tracking

    داده‌های ردیابی را به صورت آنی برای مسیر فعال دریافت کنید

    پست
    /v1/stops/import

    واردات عمده از سیستم‌های خارجی متوقف می‌شود

    قرار دادن
    /v1/stops/{id}/status

    به‌روزرسانی وضعیت توقف (تکمیل‌شده، ناموفق، صرف‌نظر شده)

    شو
    /v1/درایورها

    لیست تمام درایورها با وضعیت در دسترس بودن

    شو
    /v1/drivers/{id}/location

    موقعیت مکانی فعلی و پیشرفت مسیر را دریافت کنید

    پست
    /v1/webhooks

    ثبت نقطه پایانی وب‌هوک برای اعلان‌های رویداد

    رمز مثال ها

    با مثال‌هایی به زبان مورد علاقه‌تان، سریع شروع کنید



    # ایجاد و بهینه سازی مسیری با چندین توقف
    حلقه -X POST "https://api.zeoroute.com/v1/routes" \ -ح "مجوز: دارنده $ZEO_API_KEY" \ -ح "نوع محتوا: application/json" \ -d '{ "name": "تحویل‌های صبحگاهی", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "خیابان انبار ۱۲۳، شهر" }, "stops": [ { "address": "خیابان مشتری ۴۵۶", "time_window": { "start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "بلوار تجاری ۷۸۹", "priority": "high", "service_time": 30 } ] }'
    
    # جزئیات مسیر را دریافت کنید
    curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" \ -ح "مجوز: دارنده $ZEO_API_KEY"
    
    # وضعیت توقف را به‌روزرسانی کنید
    حلقه -X قرار دادن «https://api.zeoroute.com/v1/stops/stop_xyz789/status» \ -ح "مجوز: دارنده $ZEO_API_KEY" \ -ح "نوع محتوا: application/json" \ -d '{"status": "تکمیل شده", "notes": "پشت در مانده"}'

    ادغام موارد را استفاده کنید

    به‌روزرسانی‌های خودکار برای هر صنعتی با بازدیدهای برنامه‌ریزی‌شده کار می‌کنند

    تحویل

    یکپارچه‌سازی مدیریت سفارش

    یک پلتفرم تجارت الکترونیک به طور خودکار هر ساعت سفارشات جدید را از طریق API وارد می‌کند. سفارشات بر اساس منطقه گروه‌بندی می‌شوند، در مسیرها بهینه‌سازی می‌شوند و برای رانندگان ارسال می‌شوند. اعلان‌های وب‌هوک وضعیت سفارش را به صورت آنی و همزمان با تکمیل تحویل به‌روزرسانی می‌کنند.

    تعمیر در محل

    زمان‌بندی خدمات مبتنی بر CRM

    یک شرکت خدمات میدانی، سفارش‌های کاری را از طریق رابط برنامه‌نویسی کاربردی (API) با CRM خود همگام‌سازی می‌کند. کارهای جدید به‌طور خودکار توقف‌هایی را با جزئیات مشتری، الزامات خدمات و بازه‌های زمانی ایجاد می‌کنند. وب‌هوک‌های تکمیل، CRM را به‌روزرسانی کرده و صدور فاکتور را آغاز می‌کنند.

    گروه 1707478361، Zeo Route Planner

    آماده ساخت ادغام شما؟

    کلید API خود را دریافت کنید و با مستندات جامع ما، در عرض چند دقیقه شروع به ساخت و ساز کنید.

    گروه 1707478363، Zeo Route Planner

    پرسشنامه زئو

    غالبا
    خواسته
    سوالات

    بیشتر بدانید

    رابط برنامه‌نویسی کاربردی زئو و وب‌هوک‌ها

    محدودیت‌های نرخ API چیست؟

    کلیدهای API استاندارد اجازه ۱۰۰۰ درخواست در دقیقه را می‌دهند. طرح‌های سازمانی می‌توانند محدودیت‌های بالاتری تا ۱۰۰۰۰ درخواست در دقیقه را درخواست کنند. هدرهای محدودیت نرخ در هر پاسخ گنجانده شده‌اند تا بتوانید میزان استفاده خود را پیگیری کنید.

    چگونه درخواست‌های API را تأیید اعتبار کنم؟

    همه درخواست‌های API به یک توکن Bearer در هدر Authorization نیاز دارند. می‌توانید کلیدهای API را از تنظیمات حساب خود ایجاد کنید. کلیدها را می‌توان به مجوزهای خاص (فقط خواندنی، نوشتن، مدیر) و آدرس‌های IP محدود کرد.

    آیا SDK برای زبان‌های مختلف دارید؟

    ما SDK های رسمی را برای جاوا اسکریپت/Node.js و پایتون ارائه می‌دهیم. SDK های تحت مدیریت جامعه برای Ruby، PHP و Go نیز در دسترس هستند. همه SDK ها متن باز هستند و در GitHub موجود می‌باشند.

    تلاش‌های مجدد وب‌هوک چگونه کار می‌کنند؟

    اگر نقطه پایانی شما پاسخی غیر از 2xx برگرداند، ما با backoff نمایی دوباره امتحان می‌کنیم: 1 دقیقه، 5 دقیقه، 30 دقیقه، 2 ساعت و 24 ساعت. پس از 5 تلاش ناموفق، وب‌هوک به عنوان ناموفق علامت‌گذاری می‌شود و از طریق ایمیل به شما اطلاع داده می‌شود.

    آیا محیط سندباکس برای آزمایش وجود دارد؟

    بله، ما یک محیط سندباکس کامل را در api-sandbox.zeoroute.com ارائه می‌دهیم. سندباکس همان API را دارد اما با داده‌های آزمایشی و بدون هزینه. ایده‌آل برای توسعه و آزمایش یکپارچه‌سازی.

    آیا API در همه پلن‌ها موجود است؟

    رابط برنامه‌نویسی کاربردی Zeo REST در طرح‌های مدیریت ناوگان و سازمانی موجود است. این رابط شامل مدیریت کامل مسیر، عملیات توقف، مدیریت راننده و پشتیبانی از وب‌هوک برای اعلان‌های رویداد در لحظه است.

    زئو وبلاگ ها

    وبلاگ ما را برای مقالات روشنگر، توصیه های تخصصی و محتوای الهام بخش که شما را در جریان قرار می دهد کاوش کنید.

    بهینه‌سازی مسیر سرویس خودپرداز ۲۰۲۶ ۰۱ ۲۳ ویژه، برنامه‌ریز مسیر Zeo

    بهینه‌سازی مسیر سرویس دستگاه‌های خودپرداز: کاهش ۲۵ درصدی هزینه‌ها در سال ۲۰۲۶

    زمان خواندن: 7 دقیقهبا بهینه‌سازی هوشمند مسیر، عملیات خدمات خودپرداز را متحول کنید. ضمن بهبود امنیت و زمان آماده به کار، هزینه‌ها را تا 25٪ کاهش دهید. راهکارهای واقعی برای مدیران.

    ۲۰۲۶ ۰۱ ۲۳ چگونه زمان سفر بازرسی را کاهش دهیم ویژه، برنامه‌ریز مسیر Zeo

    چگونه زمان سفر بازرسی را برای بهره‌وری ناوگان کاهش دهیم

    زمان خواندن: 7 دقیقهاستراتژی‌های اثبات‌شده برای کاهش زمان سفر بازرسی ناوگان خود را بیاموزید. برنامه‌ریزی، هماهنگی سیار و مسیریابی را برای کاهش هزینه‌های خرابی بهینه کنید.

    ۲۰۲۶ ۰۱ ۲۳ نحوه مدیریت مسیرهای سرویس چندین استخر ویژه، برنامه‌ریز مسیر Zeo

    چگونه مسیرهای سرویس چندین استخر را به طور موثر مدیریت کنیم

    زمان خواندن: 8 دقیقهاستراتژی‌های اثبات‌شده برای مدیریت مسیرهای متعدد سرویس استخر، کاهش زمان رانندگی تا 30 درصد، حذف نظافت‌های از دست رفته و گسترش سودآور به مناطق جدید را بیاموزید.