NAV

Giới thiệu

Công cụ lập kế hoạch lộ trình Zeo giúp chủ đội xe tạo và tối ưu hóa các tuyến đường cho tài xế của họ. Chủ đội xe hoặc doanh nghiệp nhỏ thực hiện giao hàng chặng cuối tại địa phương có thể theo dõi trạng thái giao hàng, vị trí trực tiếp của tài xế và gửi thông tin cập nhật theo thời gian thực cho khách hàng. Ứng dụng di động của Zeo dành cho tài xế giao hàng được trang bị tích hợp liền mạch với tất cả các công cụ điều hướng phổ biến bao gồm waze, tomtom, Google maps, v.v. Driver có tất cả các chi tiết quan trọng trong tầm tay bao gồm ghi chú, chi tiết khách hàng và số lượng bưu kiện. Zeo xử lý việc thêm và xóa địa chỉ động cũng như định tuyến lại trình tự để cung cấp tuyến đường được tối ưu hóa nhất. Với chủ sở hữu đội xe Zeo, bạn có thể tiết kiệm tới 200 USD mỗi tháng cho mỗi tài xế và có quyền truy cập vào các báo cáo chất lượng cao như bằng chứng giao hàng, chữ ký và tem thời gian giao hàng

Xác thực

ZeoRoutePlanner sử dụng khóa API để cho phép truy cập vào API. Bạn có thể đăng ký khóa API mới tại nền tảng của chúng tôi (https://zeorouteplanner.com/app/team/settings/genrate-token).

ZeoRoutePlanner dự kiến ​​​​khóa API sẽ được đưa vào tất cả các yêu cầu API tới máy chủ theo thông số giống như sau:

api_key: api_key

Api của chủ cửa hàng

Tạo điểm dừng

curl --location --request POST '{{base_url}}/api/v5/route_stop' \
--header 'Content-Type: application/json' \
--data-raw '{
    "api_key": "api_key",
    "stops": [
        {
            "address": "Gwalior Madhaya Predesh",
            "latitude": 0,
            "longitude": 0.0,
            "notes": "dsf",
            "optimize_status": "normal",
            "stop_duration": 5,
            "stop_date": "2022-03-10",
            "parcel_count": 2,
            "arrive_start": "now",
            "arrive_end": "anytime",
            "earliest": 0,
            "latest": 0,
            "driver_id": "",
            "stop_type": "delivery",
            "customer_name": "nishu",
            "customer_mobile_number": "+911234567890",
            "customer_email": "",
            "metadata": [{}]
        }
    ]
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
    "code": 200,
    "status": true,
    "message": "Stops added successfully"
}

Điểm cuối này lấy tất cả các trình điều khiển.

Yêu cầu HTTP

POST {{base_url}}/api/v5/route_stop

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
điểm dừng [{}] Dừng mảng

Dừng tham số đối tượng

Tham số Mặc định Mô tả
địa chỉ "" Địa chỉ dừng
vĩ độ "" Địa chỉ Latitude
kinh độ "" Kinh độ địa chỉ
ghi chú "" Bất kỳ tin nhắn nào để thêm
tối ưu_trạng thái "thông thường"
dừng_duration "Ở lại điểm dừng"
đến_bắt đầu "" "Hiện nay"
đến_kết thúc "" "Bất cứ lúc nào"
sớm nhất ""
mới nhất ""
dừng_type "" (giao hàng/nhận hàng)
tên khách hàng "" tên khách hàng
khách hàng_số_điện thoại di động "" Số liên lạc của khách hàng
driver_id "" Mã trình điều khiển
ngày dừng "" Ngày dừng
số lượng bưu kiện 1 Số bưu kiện
siêu dữ liệu [] Trường tùy chỉnh

Nhận tất cả trình điều khiển

curl --location -g --request GET '{{base_url}}/api/v5/drivers?api_key=api_key'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "success",
  "data": {
    "drivers": [
      {
        "id": 44914,
        "email": "0f12ebdd@gmail.com",
        "name": "nishu jain",
        "address": null,
        "phone_no": "8959294300",
        "active": true
      }
    ]
  }
}

Điểm cuối này lấy tất cả các trình điều khiển.

Yêu cầu HTTP

GET {{base_url}}/api/v5/drivers

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api

Tạo trình điều khiển

curl --location -g --request POST '{{base_url}}/api/v5/drivers' \
--header 'Content-Type: application/json' \
--data-raw '{
  "api_key": "api_key",
  "email": "nishu.jain396@gmail.com",
  "address": "Netaji Subhash Marg, Lal Qila, Chandni Chowk, New Delhi, Delhi 110006",
  "password": "12345678",
  "name": "nishu jain",
  "phone_no": " "
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "Driver created successfully",
  "data": {
    "driver": {
      "id": 44953,
      "email": "testthird1@gmail.com",
      "name": "test",
      "address": "Netaji Subhash Marg, Lal Qila, Chandni Chowk, New Delhi, Delhi 110006",
      "phone_no": "+918959294300",
      "active": true
    }
  }
}

Điểm cuối này tạo trình điều khiển.

Yêu cầu HTTP

POST {{base_url}}/api/v5/drivers

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
e-mail "" Email tài xế
địa chỉ "" Địa chỉ tài xế
mật khẩu "" Mật khẩu tài khoản tài xế
tên "" Tên tài xế
không có điện thoại "" Số liên lạc của

Update Driver

curl --location -g --request PUT '{{base_url}}/api/v5/drivers/:driver_id' \
--header 'Content-Type: application/json' \
--data-raw '{
  "api_key": "api_key",
  "name": "nishu jain",
    "address": "",
  "phone_no": "8959294300"
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "Driver updated successfully",
  "data": {
    "driver": {
      "id": 44953,
      "name": "nishu jain",
      "phone_no": "8959294300",
      "address": "dlehi",
      "email": "testthird1@gmail.com",
      "active": true
    }
  }
}

Chi tiết trình điều khiển cập nhật điểm cuối này.

Yêu cầu HTTP

PUT {{base_url}}/api/v5/drivers/:driver_id

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
địa chỉ "" Địa chỉ tài xế
tên "" Tên tài xế
không có điện thoại "" Số liên lạc của tài xế
driver_id "" Id trình điều khiển chúng tôi nhận được từ tất cả các api trình điều khiển

Xóa trình điều khiển

curl --location -g --request DELETE '{{base_url}}/api/v5/drivers/:driver_id' \
--header 'Content-Type: application/json' \
--data-raw '{
  "api_key": "api_key"
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "Driver deleted successful"
}

Trình điều khiển xóa điểm cuối này.

Yêu cầu HTTP

DELETE {{base_url}}/api/v5/drivers/:driver_id

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
driver_id "" Id trình điều khiển chúng tôi nhận được từ tất cả các api trình điều khiển

Tạo tuyến đường

curl --location -g --request POST '{{base_url}}/api/v5/routes' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "start_address"  :   "Monroe, NC, USA",
   "start_latitude"   : 0.0,
   "start_longitude"   :0.0,
   "end_address"  :   "Monroe, NC, USA",
   "end_latitude"   : 0.0,
   "end_longitude"   :0.0,
   "route_name"  :   "July 2020 Roadtrip",
   "driver_id": "44968",
   "orginal": true,
   "route_date": "",
   "stops"  : [
    {
    "address": "Gwalior Madhaya Predesh", 
    "latitude":106.672053, 
    "longitude":0.0, 
    "notes":"dsf", 
    "optimize_status":"normal",
    "stop_duration":5, 
    "parcel_count": "",
    "arrive_start":"now", 
    "arrive_end":"anytime", 
    "earliest":0, 
    "latest":0, 
    "stop_type":"delivery", 
    "customer_name":"nishu",
    "customer_mobile_number":"+911234567890",
    "metadata": [{}]
    }
  ]
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "success",
  "data": {
    "route": {
        "id": 103110,
        "start_address": "new york",
        "end_address": "new york",
        "start_latitude": 40.7128,
        "start_longitude": 74.006,
        "end_latitude": 40.7128,
        "end_longitude": 74.006,
        "created_at": "2021-07-21T04:07:41.000Z",
        "route_name": "test",
        "route_stops": [
          {
            "id": 222472903,
            "address": "17475 Northwest 27th Avenue, Miami Gardens, FL, USA",
            "latitude": 25.9330248,
            "longitude": -80.2445472,
            "notes": "GOod",
            "optimize_status": "normal",
            "stop_duration": 10,
            "customer_name": "",
            "customer_mobile_number": "",
            "street": "17475 NW 27th Ave, Miami Gardens, FL 33056, EE. UU.",
            "city": "Miami-Dade County",
            "state": "Florida",
            "country": "Estados Unidos",
            "postal_code": "33056",
            "customer_email": "",
            "order_number": "",
            "order_status": "route_created",
            "h_no": "",
            "locality": ""
         }
      ]
    }
  }
}

Điểm cuối này tạo tuyến đường.

Yêu cầu HTTP

POST {{base_url}}/api/v5/routes

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
driver_id "" Id trình điều khiển chúng tôi nhận được từ tất cả các api trình điều khiển
địa chỉ bắt đầu "" Địa chỉ bắt đầu lộ trình
điểm bắt đầu_vĩ độ "" Địa chỉ bắt đầu Vĩ độ
kinh_độ bắt đầu "" Địa chỉ bắt đầu Kinh độ
địa chỉ cuối "" Địa chỉ cuối tuyến
end_latitude "" Địa chỉ cuối Latitude
end_kinh độ "" Địa chỉ cuối Kinh độ
tên tuyến đường "" Tên tuyến đường
driver_id "" Id tài xế để chỉ định tuyến đường
ban đầu ""
điểm dừng [] Điểm dừng giữa các tuyến đường
tuyến_ngày '' Ngày tuyến

Dừng tham số đối tượng

Tham số Mặc định Mô tả
địa chỉ "" Địa chỉ dừng
vĩ độ "" Địa chỉ Latitude
kinh độ "" Kinh độ địa chỉ
ghi chú "" Bất kỳ tin nhắn nào để thêm
tối ưu_trạng thái "thông thường"
dừng_duration "Ở lại điểm dừng"
đến_bắt đầu "" "Hiện nay"
đến_kết thúc "" "Bất cứ lúc nào"
sớm nhất ""
mới nhất ""
dừng_type "" (giao hàng/nhận hàng)
tên khách hàng "" tên khách hàng
khách hàng_số_điện thoại di động "" Số liên lạc của khách hàng
số lượng bưu kiện 1 Số bưu kiện
siêu dữ liệu [{}] Trường tùy chỉnh

Nhận thông tin tuyến đường

curl --location -g --request GET '{{base_url}}/api/v5/routes/:route_id' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "driver_id": 44968
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "success",
  "data": {
    "route": {
      "id": 103110,
      "start_address": "new york",
      "end_address": "new york",
      "start_latitude": 40.7128,
      "start_longitude": 74.006,
      "end_latitude": 40.7128,
      "end_longitude": 74.006,
      "created_at": "2021-07-21T04:07:41.000Z",
      "route_name": "test",
      "route_stops": [
        {
          "id": 222472903,
          "address": "17475 Northwest 27th Avenue, Miami Gardens, FL, USA",
          "latitude": 25.9330248,
          "longitude": -80.2445472,
          "notes": "GOod",
          "optimize_status": "normal",
          "stop_duration": 10,
          "customer_name": "",
          "customer_mobile_number": "",
          "street": "17475 NW 27th Ave, Miami Gardens, FL 33056, EE. UU.",
          "city": "Miami-Dade County",
          "state": "Florida",
          "country": "Estados Unidos",
          "postal_code": "33056",
          "customer_email": "",
          "order_number": "",
          "order_status": "route_created",
          "h_no": "",
          "locality": ""
        }
      ]
    }
  }
}

Điểm cuối này NHẬN thông tin tuyến đường.

Yêu cầu HTTP

GET {{base_url}}/api/v5/routes/:route_id

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
tuyến_id "" ID tuyến đường chúng tôi nhận được từ danh sách tuyến đường
driver_id "" Id tài xế của tuyến đường

Nhận thông tin tối ưu hóa tuyến đường

curl --location -g --request GET '{{base_url}}/api/v5/routes/:route_id/optimize_route' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "driver_id": 44968
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
    "code": 200,
    "status": true,
    "message": "success",
    "data": {
        "optimized": true,
        "legs": [
            {
                "distance": {
                    "text": "0 km",
                    "value": 0
                },
                "duration": {
                    "text": "",
                    "value": 0
                },
                "end_address": "17475 Northwest 27th Avenue, Miami Gardens, FL, USA",
                "start_address": "new york",
                "start_location": {
                    "lat": 25.9330248,
                    "lng": -80.2445472
                },
                "end_location": {
                    "lat": 25.9330248,
                    "lng": -80.2445472
                },
                "stop_id": "222473116",
                "optimize_status": "normal",
                "stop_type": "delivery",
                "arr_time": 0,
                "end_time": 600,
                "optimize_order": 1,
                "stop_order": null,
                "share_stop_id": null,
                "address_typed": {},
                "overview_polyline": "cah}CnwwhN"
            },
            {
                "distance": {
                    "text": "0 km",
                    "value": 0
                },
                "duration": {
                    "text": "10 mins",
                    "value": 600
                },
                "end_address": "new york",
                "start_address": "17475 Northwest 27th Avenue, Miami Gardens, FL, USA",
                "start_location": {
                    "lat": 25.9330248,
                    "lng": -80.2445472
                },
                "end_location": {
                    "lat": 25.9330248,
                    "lng": -80.2445472
                },
                "stop_id": null,
                "optimize_status": "normal",
                "stop_type": "normal",
                "arr_time": 600,
                "end_time": 0,
                "optimize_order": 2,
                "stop_order": 2000,
                "share_stop_id": 0,
                "address_typed": {
                    "delivery_count": 0
                },
                "overview_polyline": "cah}CnwwhN"
            }
        ]
    }
}

Điểm cuối này NHẬN thông tin tuyến đường.

Yêu cầu HTTP

GET {{base_url}}/api/v5/routes/:route_id/optimize_route

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
driver_id "" Id tài xế của tuyến đường

Xóa tuyến đường

curl --location -g --request DELETE '{{base_url}}/api/v5/routes/:route_id' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "driver_id": 44968
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "Route deleted successfully"
}

Tuyến đường xóa điểm cuối này.

Yêu cầu HTTP

DELETE {{base_url}}/api/v5/routes/:route_id

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
tuyến_id "" ID tuyến đường chúng tôi nhận được từ danh sách tuyến đường
driver_id "" Id tài xế của tuyến đường

Nhận tất cả các tuyến đường lái xe

curl --location -g --request GET '{{base_url}}/api/v5/routes' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "limit": 10,
   "offset": 10,
   "driver_id": "driver_id"
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "success",
  "data": {
    "routes": [
      {
        "id": 103110,
        "start_address": "new york",
        "end_address": "new york",
        "start_latitude": 40.7128,
        "start_longitude": 74.006,
        "end_latitude": 40.7128,
        "end_longitude": 74.006,
        "created_at": "2021-07-21T04:07:41.000Z",
        "route_name": "test",
        "route_stops": [
          {
            "id": 222472903,
            "address": "17475 Northwest 27th Avenue, Miami Gardens, FL, USA",
            "latitude": 25.9330248,
            "longitude": -80.2445472,
            "notes": "GOod",
            "optimize_status": "normal",
            "stop_duration": 10,
            "customer_name": "",
            "customer_mobile_number": "",
            "street": "17475 NW 27th Ave, Miami Gardens, FL 33056, EE. UU.",
            "city": "Miami-Dade County",
            "state": "Florida",
            "country": "Estados Unidos",
            "postal_code": "33056",
            "customer_email": "",
            "order_number": "",
            "order_status": "route_created",
            "h_no": "",
            "locality": ""
          }
        ]
      }
    ],
    "total_routes": 1
  }
}

Điểm cuối này tìm nạp tất cả các tuyến đường.

Yêu cầu HTTP

GET {{base_url}}/api/v5/routes

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
hạn chế 50 Hồ sơ để trở lại
bù đắp 0 Bản ghi tiếp theo sẽ quay trở lại
driver_id Mã trình điều khiển

Nhận tất cả các tuyến đường của chủ sở hữu cửa hàng

curl --location -g --request GET '{{base_url}}/api/v5/routes/all_routes' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "limit": 10,
   "offset": 10,
   "start_date": dd-mm-yyyy,
   "end_date": dd-mm-yyyy
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "success",
  "data": {
    "routes": [
      {
        "id": 103110,
        "start_address": "new york",
        "end_address": "new york",
        "start_latitude": 40.7128,
        "start_longitude": 74.006,
        "end_latitude": 40.7128,
        "end_longitude": 74.006,
        "created_at": "2021-07-21T04:07:41.000Z",
        "route_name": "test",
        "route_stops": [
          {
            "id": 222472903,
            "address": "17475 Northwest 27th Avenue, Miami Gardens, FL, USA",
            "latitude": 25.9330248,
            "longitude": -80.2445472,
            "notes": "GOod",
            "optimize_status": "normal",
            "stop_duration": 10,
            "customer_name": "",
            "customer_mobile_number": "",
            "street": "17475 NW 27th Ave, Miami Gardens, FL 33056, EE. UU.",
            "city": "Miami-Dade County",
            "state": "Florida",
            "country": "Estados Unidos",
            "postal_code": "33056",
            "customer_email": "",
            "order_number": "",
            "order_status": "route_created",
            "h_no": "",
            "locality": ""
          }
        ]
      }
    ],
    "total_routes": 1
  }
}

Điểm cuối này tìm nạp tất cả các tuyến đường.

Yêu cầu HTTP

GET {{base_url}}/api/v5/routes/all_routes

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
hạn chế 50 Hồ sơ để trở lại
bù đắp 0 Bản ghi tiếp theo sẽ quay trở lại
ngày bắt đầu hư không Ngày bắt đầu lộ trình (dd-mm-yyyy)
ngày cuối hư không Ngày kết thúc lộ trình (dd-mm-yyyy)

Nhận Route tạo cho tài xế bởi chủ cửa hàng

curl --location --request POST '{{base_url}}/api/v5/routes/import_orders' \
--header 'Content-Type: multipart/form-data' \
--form 'start_address=""' \
--form 'end_address=""' \
--form 'driver_email="\"\""' \
--form 'api_key="\"\""' \
--form 'file=@"/path/to/file"'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
    "code": 200,
    "status": true,
    "message": "success",
    "data": {
        "route": {
            "id": 104244,
            "start_address": "Delhi",
            "end_address": "Delhi",
            "start_latitude": 28.7040592,
            "start_longitude": 77.1024902,
            "end_latitude": 28.7040592,
            "end_longitude": 77.1024902,
            "created_at": "2021-09-27T06:18:29.000Z",
            "route_name": "2021-Sep-09",
            "route_stops": [
                {
                    "id": 16921825,
                    "address": "Delhi",
                    "latitude": 28.7040592,
                    "longitude": 77.1024902,
                    "notes": "test",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "ayush",
                    "customer_mobile_number": "7838479870",
                    "street": "",
                    "city": "",
                    "state": "Delhi",
                    "country": "India",
                    "postal_code": "",
                    "customer_email": "ayush@gmail.com",
                    "order_number": null,
                    "order_status": "route_created",
                    "h_no": "",
                    "locality": ""
                }
            ]
        }
    }
}

Điểm cuối này được sử dụng để tạo tuyến đường cho người lái xe.

Yêu cầu HTTP

POST {{base_url}}/api/v5/routes/import_orders

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api (Truy cập trang Url trang web đăng nhập vào tài khoản chủ cửa hàng rồi chuyển đến trang Trang cài đặtchọn nhận mã thông báo api và tạo api_key)
địa chỉ bắt đầu "" địa chỉ bắt đầu của tuyến đường
địa chỉ cuối "" địa chỉ cuối của tuyến đường
email tài xế "" email tài xế
hồ sơ "" tải lên tệp ở định dạng xlsx bạn có thể tải xuống bằng cách nhấp vào liên kết(Liên kết tập tin mẫu)

Giao hàng tận nơi

Tạo tuyến đường

curl -X POST \
  {{base_url}}/api/v6/routes/ \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'postman-token: 5c922b4b-faf5-ea12-5660-518110acc248' \
  -d '{
  "api_key": "**************",
  "driver_id": 11111111111111,
  "start_address":"Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
  "start_latitude":19.1190749,
  "start_longitude":72.8951151,
  "end_address":"Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
  "end_latitude":19.1190749,
  "end_longitude":72.8951151,
  "route_name":"04-Jan-2022",
  "stops":[
    {
      "id":1633502641818,
      "address":"Taj Mahal pikcup",
      "latitude":18.9225854,
      "longitude":72.83315429999999,
      "notes":"parsal in the left site",
      "stop_type":"pickup",
      "customer_name":"any",
      "customer_mobile_number":"0123456789",
      "customer_email":"example@gmail.com",
      "share_stop_id":0,
      "address_typed":{
        "delivery_count":1
      },
      "stop_duration": 2,
      "stop_order": 1,
      "metadata": [{}]
    },
    {
      "id":0,
      "address":"Taj Mahal pickup link delivery",
      "latitude":18.9225854,
      "longitude":72.83315429999999,
      "notes":"parsal in the left site",
      "stop_type":"delivery",
      "customer_name":"any",
      "customer_mobile_number":"0123456789",
      "customer_email":"example@gmail.com",
      "share_stop_id":1633502641818,
      "address_typed":{
        "delivery_count":0
      },
      "stop_duration": 2,
      "stop_order": 2
    },
    {
      "id":0,
      "address":"Taj Mahal seperate delivery",
      "latitude":18.9225854,
      "longitude":72.83315429999999,
      "notes":"parsal in the left site",
      "stop_type":"delivery",
      "customer_name":"any",
      "customer_mobile_number":"0123456789",
      "customer_email":"example@gmail.com",
      "share_stop_id":0,
      "address_typed":{
        "delivery_count":0
      },
      "stop_duration": 2,
      "stop_order": 2
    }
  ]
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
    "code": 200,
    "status": true,
    "message": "success",
    "data": {
        "route": {
            "id": 103169,
            "route_name": "04-Jan-2022",
            "start_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
            "end_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
            "start_latitude": 19.1190749,
            "start_longitude": 72.8951151,
            "end_latitude": 19.1190749,
            "end_longitude": 72.8951151,
            "created_at": "2022-01-11T11:48:16.000Z",
            "route_stops": [
                {
                    "id": 222473230,
                    "address": "Taj Mahal seperate delivery",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "parsal in the left site",
                    "optimize_status": "normal",
                    "stop_duration": 2,
                    "customer_name": "any",
                    "customer_mobile_number": "0123456789",
                    "street": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "postal_code": "",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "example@gmail.com",
                    "order_number": null,
                    "order_status": null,
                    "stop_order": 2,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 0
                },
                {
                    "id": 222473231,
                    "address": "Taj Mahal pickup",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "parsal in the left site",
                    "optimize_status": "normal",
                    "stop_duration": 2,
                    "customer_name": "any",
                    "customer_mobile_number": "0123456789",
                    "street": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "postal_code": "",
                    "address_typed": {
                        "delivery_count": 1
                    },
                    "customer_email": "example@gmail.com",
                    "order_number": null,
                    "order_status": null,
                    "stop_order": 1,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 0
                },
                {
                    "id": 222473232,
                    "address": "Taj Mahal pickup linked delivery",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "parsal in the left site",
                    "optimize_status": "normal",
                    "stop_duration": 2,
                    "customer_name": "any",
                    "customer_mobile_number": "0123456789",
                    "street": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "postal_code": "",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "example@gmail.com",
                    "order_number": null,
                    "order_status": null,
                    "stop_order": 2,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 222473231
                }
            ]
        }
    }
}

Điểm cuối này tạo tuyến đường.

Yêu cầu HTTP

POST {{base_url}}/api/v6/routes

Tham số truy vấn

Tham số Loại dữ liệu Mặc định Mô tả
driver_id int (*) Cần driver_id để tạo tuyến đường
địa chỉ bắt đầu sợi dây (*) Địa chỉ từ nơi tuyến đường bắt đầu
điểm bắt đầu_vĩ độ số thập phân 0 Bắt buộc phải có start_address HOẶC start_latitude,start_longitude
kinh_độ bắt đầu số thập phân 0 Bắt buộc phải có start_address HOẶC start_latitude,start_longitude
địa chỉ cuối chuỗi Vị trí cuối của tuyến đường
end_latitude số thập phân Yêu cầu end_address HOẶC end_latitude,end_longitude
end_kinh độ số thập phân Yêu cầu end_address HOẶC end_latitude,end_longitude
tên tuyến đường sợi dây (*) ngày hiện tại (dd/mm/yy) Tên tuyến đường
điểm dừng mảng đối tượng (*) Dừng thông tin trong mảng đối tượng

Dừng tham số đối tượng

Tham số Loại dữ liệu Mặc định Mô tả
id INT (*) 0 1. Nếu stop_type đang giao hàng thì không cần gửi id
2. Nếu stop_type đón thì cần gửi id gồm 20 chữ số
dừng_order int (*) 0 Thêm lệnh dừng
chia sẻ_stop_id int 0 1. Nếu stop_type được lấy, hãy để mặc định
2. Nếu stop_type là giao hàng và không muốn liên kết với việc nhận hàng, hãy để mặc định
3. Nếu bạn muốn liên kết với bất kỳ điểm đón nào thì nhập id của id điểm dừng đón đó
dừng_type chuỗi giao hàng giá trị phải là giao hàng và nhận hàng
địa chỉ chuỗi Yêu cầu địa chỉ HOẶC vĩ độ, Kinh độ
vĩ độ số thập phân 0 Yêu cầu địa chỉ HOẶC vĩ độ, Kinh độ
kinh độ số thập phân 0 Yêu cầu địa chỉ HOẶC vĩ độ, Kinh độ
ghi chú chuỗi Dừng thông tin liên quan
dừng_duration int 2 Chỉ định thời gian dừng tính bằng phút, tức là mất bao lâu tại địa điểm của khách hàng.
tên khách hàng chuỗi thông tin khách hàng
khách hàng_số_điện thoại di động chuỗi thông tin khách hàng
email của khách hàng chuỗi thông tin khách hàng
địa chỉ_typed {} {} 1. Nếu stop_type là nhận hàng thì khóa là Delivery_count và giá trị tính bằng int tổng số lần giao hàng được liên kết với việc nhận hàng này
2. nếu stop_type đang phân phối, hãy để nó như mặc định

Cập nhật lộ trình

curl -X POST \
  {{base_url}}/api/v6/routes/:route_id \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'postman-token: 5c922b4b-faf5-ea12-5660-518110acc248' \
  -d '{
  "api_key": "**************",
  "driver_id": 11111111111111,
  "start_address":"Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
  "start_latitude":19.1190749,
  "start_longitude":72.8951151,
  "end_address":"Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
  "end_latitude":19.1190749,
  "end_longitude":72.8951151,
  "route_name":"04-Jan-2022",
  "stops":[
    {
      "id":1633502641818,
      "address":"Taj Mahal pikcup",
      "latitude":18.9225854,
      "longitude":72.83315429999999,
      "notes":"parsal in the left site",
      "stop_type":"pickup",
      "customer_name":"any",
      "customer_mobile_number":"0123456789",
      "customer_email":"example@gmail.com",
      "share_stop_id":0,
      "address_typed":{
        "delivery_count":1
      },
      "stop_duration": 2,
      "stop_order": 1
    },
    {
      "id":0,
      "address":"Taj Mahal pickup link delivery",
      "latitude":18.9225854,
      "longitude":72.83315429999999,
      "notes":"parsal in the left site",
      "stop_type":"delivery",
      "customer_name":"any",
      "customer_mobile_number":"0123456789",
      "customer_email":"example@gmail.com",
      "share_stop_id":1633502641818,
      "address_typed":{
        "delivery_count":0
      },
      "stop_duration": 2,
      "stop_order": 2
    },
    {
      "id":0,
      "address":"Taj Mahal seperate delivery",
      "latitude":18.9225854,
      "longitude":72.83315429999999,
      "notes":"parsal in the left site",
      "stop_type":"delivery",
      "customer_name":"any",
      "customer_mobile_number":"0123456789",
      "customer_email":"example@gmail.com",
      "share_stop_id":0,
      "address_typed":{
        "delivery_count":0
      },
      "stop_duration": 2,
      "stop_order": 2
    }
  ]
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
    "code": 200,
    "status": true,
    "message": "success",
    "data": {
        "route": {
            "id": 103169,
            "route_name": "04-Jan-2022",
            "start_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
            "end_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
            "start_latitude": 19.1190749,
            "start_longitude": 72.8951151,
            "end_latitude": 19.1190749,
            "end_longitude": 72.8951151,
            "created_at": "2022-01-11T11:48:16.000Z",
            "route_stops": [
                {
                    "id": 222473230,
                    "address": "Taj Mahal seperate delivery",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "parsal in the left site",
                    "optimize_status": "normal",
                    "stop_duration": 2,
                    "customer_name": "any",
                    "customer_mobile_number": "0123456789",
                    "street": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "postal_code": "",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "example@gmail.com",
                    "order_number": null,
                    "order_status": null,
                    "stop_order": 2,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 0
                },
                {
                    "id": 222473231,
                    "address": "Taj Mahal pickup",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "parsal in the left site",
                    "optimize_status": "normal",
                    "stop_duration": 2,
                    "customer_name": "any",
                    "customer_mobile_number": "0123456789",
                    "street": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "postal_code": "",
                    "address_typed": {
                        "delivery_count": 1
                    },
                    "customer_email": "example@gmail.com",
                    "order_number": null,
                    "order_status": null,
                    "stop_order": 1,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 0
                },
                {
                    "id": 222473232,
                    "address": "Taj Mahal pickup linked delivery",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "parsal in the left site",
                    "optimize_status": "normal",
                    "stop_duration": 2,
                    "customer_name": "any",
                    "customer_mobile_number": "0123456789",
                    "street": "",
                    "city": "",
                    "state": "",
                    "country": "",
                    "postal_code": "",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "example@gmail.com",
                    "order_number": null,
                    "order_status": null,
                    "stop_order": 2,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 222473231
                }
            ]
        }
    }
}

Tuyến cập nhật điểm cuối này.

Yêu cầu HTTP

POST {{base_url}}/api/v6/routes/:route_id

Tham số truy vấn

Tham số truy vấn

Tham số Loại dữ liệu Mặc định Mô tả
driver_id int (*) Cần driver_id để tạo tuyến đường
địa chỉ bắt đầu sợi dây (*) Địa chỉ từ nơi tuyến đường bắt đầu
điểm bắt đầu_vĩ độ số thập phân 0 Bắt buộc phải có start_address HOẶC start_latitude,start_longitude
kinh_độ bắt đầu số thập phân 0 Bắt buộc phải có start_address HOẶC start_latitude,start_longitude
địa chỉ cuối chuỗi Vị trí cuối của tuyến đường
end_latitude số thập phân Yêu cầu end_address HOẶC end_latitude,end_longitude
end_kinh độ số thập phân Yêu cầu end_address HOẶC end_latitude,end_longitude
tên tuyến đường sợi dây (*) ngày hiện tại (dd/mm/yy) Tên tuyến đường
điểm dừng mảng đối tượng (*) Dừng thông tin trong mảng đối tượng

Dừng tham số đối tượng

Tham số Loại dữ liệu Mặc định Mô tả
id INT (*) 0 1. Nếu stop_type đang giao hàng thì không cần gửi id
2. Nếu stop_type đón thì cần gửi id gồm 20 chữ số
dừng_order int (*) 0 Thêm lệnh dừng
chia sẻ_stop_id int 0 1. Nếu stop_type được lấy, hãy để mặc định
2. Nếu stop_type là giao hàng và không muốn liên kết với việc nhận hàng, hãy để mặc định
3. Nếu bạn muốn liên kết với bất kỳ điểm đón nào thì nhập id của id điểm dừng đón đó
dừng_type chuỗi giao hàng giá trị phải là giao hàng và nhận hàng
địa chỉ chuỗi Yêu cầu địa chỉ HOẶC vĩ độ, Kinh độ
vĩ độ số thập phân 0 Yêu cầu địa chỉ HOẶC vĩ độ, Kinh độ
kinh độ số thập phân 0 Yêu cầu địa chỉ HOẶC vĩ độ, Kinh độ
ghi chú chuỗi Dừng thông tin liên quan
dừng_duration int 2 Chỉ định thời gian dừng tính bằng phút, tức là mất bao lâu tại địa điểm của khách hàng.
tên khách hàng chuỗi thông tin khách hàng
khách hàng_số_điện thoại di động chuỗi thông tin khách hàng
email của khách hàng chuỗi thông tin khách hàng
địa chỉ_typed {} {} 1. Nếu stop_type là nhận hàng thì khóa là Delivery_count và giá trị tính bằng int tổng số lần giao hàng được liên kết với việc nhận hàng này
2. nếu stop_type đang phân phối, hãy để nó như mặc định

Nhận thông tin tuyến đường

curl --location -g --request GET '{{base_url}}/api/v6/routes/:route_id' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "driver_id": 44968
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
    "code": 200,
    "status": true,
    "message": "success",
    "data": {
        "route": {
            "id": 104248,
            "start_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
            "end_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
            "start_latitude": 19.1190749,
            "start_longitude": 72.8951151,
            "end_latitude": 19.1190749,
            "end_longitude": 72.8951151,
            "created_at": "2021-12-30T07:32:10.000Z",
            "route_name": "06-Oct-2021",
            "route_stops": [
                {
                    "id": 16921846,
                    "address": "Taj Mahal Tower, Mumbai, PJ Ramchandani Marg, Apollo Bandar, Colaba, Mumbai, Maharashtra, India",
                    "latitude": 18.9225854,
                    "longitude": 72.8331543,
                    "notes": "",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "",
                    "customer_mobile_number": "",
                    "street": "PJ Ramchandani Marg, Apollo Bandar, Colaba, Mumbai, Maharashtra 400001, India",
                    "city": "Mumbai",
                    "state": "Maharashtra",
                    "country": "India",
                    "postal_code": "400001",
                    "address_typed": {
                        "delivery_count": 2
                    },
                    "customer_email": "",
                    "order_number": null,
                    "order_status": null,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 0
                },
                {
                    "id": 16921847,
                    "address": "Juhu Beach, Mumbai, Maharashtra",
                    "latitude": 19.1095171,
                    "longitude": 72.8241298,
                    "notes": "",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "",
                    "customer_mobile_number": "",
                    "street": "Juhu Beach, Juhu, Mumbai, Maharashtra 400049, India",
                    "city": "Mumbai Suburban",
                    "state": "Maharashtra",
                    "country": "India",
                    "postal_code": "400049",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "",
                    "order_number": null,
                    "order_status": null,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 16921846
                },
                {
                    "id": 16921848,
                    "address": "JW Marriott Mumbai Juhu, Juhu Road, Juhu Tara, Juhu, Mumbai, Maharashtra, India",
                    "latitude": 19.1018504,
                    "longitude": 72.8262233,
                    "notes": "",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "",
                    "customer_mobile_number": "",
                    "street": "Juhu Rd, Juhu Tara, Juhu, Mumbai, Maharashtra 400049, India",
                    "city": "Mumbai Suburban",
                    "state": "Maharashtra",
                    "country": "India",
                    "postal_code": "400049",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "",
                    "order_number": null,
                    "order_status": null,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 16921846
                },
                {
                    "id": 16921849,
                    "address": "Hotel Sea Princess, Juhu Road, near Juhu Beach, Airport Area, Juhu, Mumbai, Maharashtra, India",
                    "latitude": 19.09326,
                    "longitude": 72.8281264,
                    "notes": "",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "",
                    "customer_mobile_number": "",
                    "street": "Juhu Rd, near Juhu Beach, Airport Area, Juhu, Mumbai, Maharashtra 400049, India",
                    "city": "Mumbai Suburban",
                    "state": "Maharashtra",
                    "country": "India",
                    "postal_code": "400049",
                    "address_typed": {
                        "delivery_count": 2
                    },
                    "customer_email": "",
                    "order_number": null,
                    "order_status": null,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 0
                },
                {
                    "id": 16921850,
                    "address": "Standard Chartered Mumbai 23-25 M G Road, Mumbai Branch, 23-25, Mahatma Gandhi Road, Azad Maidan, Fort, Mumbai, Maharashtra, India",
                    "latitude": 18.9339261,
                    "longitude": 72.8313813,
                    "notes": "",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "",
                    "customer_mobile_number": "",
                    "street": "23-25, Mahatma Gandhi Road, Azad Maidan, Fort, Mumbai, Maharashtra 400001, India",
                    "city": "Mumbai",
                    "state": "Maharashtra",
                    "country": "India",
                    "postal_code": "400001",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "",
                    "order_number": null,
                    "order_status": null,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 16921849
                },
                {
                    "id": 16921851,
                    "address": "Horniman Circle Garden, Homji Street, Kala Ghoda, Fort, Mumbai, Maharashtra, India",
                    "latitude": 18.93197,
                    "longitude": 72.8350343,
                    "notes": "",
                    "optimize_status": "normal",
                    "stop_duration": 5,
                    "customer_name": "",
                    "customer_mobile_number": "",
                    "street": "Horniman Circle Garden, 11, Homji St, Kala Ghoda, Fort, Mumbai, Maharashtra 400001, India",
                    "city": "Mumbai",
                    "state": "Maharashtra",
                    "country": "India",
                    "postal_code": "400001",
                    "address_typed": {
                        "delivery_count": 0
                    },
                    "customer_email": "",
                    "order_number": null,
                    "order_status": null,
                    "h_no": "",
                    "locality": "",
                    "share_stop_id": 16921849
                }
            ]
        }
    }
}

Điểm cuối này NHẬN thông tin tuyến đường.

Yêu cầu HTTP

GET {{base_url}}/api/v6/routes/:route_id

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
tuyến_id "" ID tuyến đường chúng tôi nhận được từ danh sách tuyến đường
driver_id "" Id tài xế của tuyến đường

Xóa lộ trình giao hàng nhận hàng

curl --location -g --request DELETE '{{base_url}}/api/v6/routes/:route_id' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "driver_id": 44968
}'

Lệnh trên trả về JSON có cấu trúc như thế này:

{
  "code": 200,
  "status": true,
  "message": "Route deleted successfully"
}

Tuyến đường xóa điểm cuối này.

Yêu cầu HTTP

DELETE {{base_url}}/api/v6/routes/:route_id

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
tuyến_id "" ID tuyến đường chúng tôi nhận được từ danh sách tuyến đường
driver_id "" Id tài xế của tuyến đường

Nhận thông tin tối ưu hóa tuyến đường

curl --location -g --request GET '{{base_url}}/api/v6/routes/:route_id/optimize_route' \
--header 'Content-Type: application/json' \
--data-raw '{
   "api_key"  :   "api_key",
   "driver_id": 44968
}'

Lệnh trên trả về JSON có cấu trúc như thế này nếu tối ưu hóa: true:

{
    "code": 200,
    "status": true,
    "message": "success",
    "data": {
        "optimized": true,
        "legs": [
            {
                "distance": {
                    "text": "11 km",
                    "value": 11545
                },
                "duration": {
                    "text": "22 mins 55 secs",
                    "value": 1375
                },
                "end_address": "Hotel Sea Princess, Juhu Road, near Juhu Beach, Airport Area, Juhu, Mumbai, Maharashtra, India",
                "start_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
                "start_location": {
                    "lat": 19.1190749,
                    "lng": 72.8951151
                },
                "end_location": {
                    "lat": 19.09326,
                    "lng": 72.8281264
                },
                "stop_id": "16921855",
                "optimize_status": "normal",
                "stop_type": "pickup",
                "arr_time": 1375,
                "end_time": 1675,
                "optimize_order": 1,
                "stop_order": 4,
                "share_stop_id": 0,
                "address_typed": {
                    "delivery_count": 2
                },
                "overview_polyline": "ieusByg|{L|@Dj@N\\Nb@d@`@h@HRF`@MnAFvBL\\|APhA[NK^LXCj@WvBUh@EZXb@BbACh@K`AdAhAvAZjBDx@z@xAhD|ElA~Dz@nAn@LhBf@rCv@`BP|DX~BL`A?n@GrCy@l@Cx@@dBHv@NbAf@hFnCr@h@e@r@}@dA_DjCyBdBiB|Ak@n@_@j@k@xAQz@Gv@SvHEl@Mv@YhAg@bBsBvHu@|C_IlYw@hDkAhGgCtNs@nEo@jDn@t@f@bAb@hAPbAbAxK^dDAbABj@AjAM`AcAdD]tAMz@]tCOzAmBlIcCjJ?j@JT\\ZvUxCMfAQx@C^m@vBm@vAqAvB{EzGzDvB~BhAbUbHXPj@jGcAxMCpBb@xN@~AKlApCj@jBZpBNjNClAI@R}E`OyC~QoDtWaC|O?LFXJLPFZBlI]lHy@nCg@tFk@pBOT?^FXRHR\\hBBHFFD@X?~B[dCYHCHGFO@SEaA@WFQHKXMT@vEYxG[x@ADf@"
            },
            {
                "distance": {
                    "text": "21 km",
                    "value": 21458
                },
                "duration": {
                    "text": "34 mins 46 secs",
                    "value": 2086
                },
                "end_address": "Taj Mahal Tower, Mumbai, PJ Ramchandani Marg, Apollo Bandar, Colaba, Mumbai, Maharashtra, India",
                "start_address": "Hotel Sea Princess, Juhu Road, near Juhu Beach, Airport Area, Juhu, Mumbai, Maharashtra, India",
                "start_location": {
                    "lat": 19.09326,
                    "lng": 72.8281264
                },
                "end_location": {
                    "lat": 18.9225854,
                    "lng": 72.8331543
                },
                "stop_id": "16921852",
                "optimize_status": "normal",
                "stop_type": "pickup",
                "arr_time": 3461,
                "end_time": 3761,
                "optimize_order": 2,
                "stop_order": 1,
                "share_stop_id": 0,
                "address_typed": {
                    "delivery_count": 2
                },
                "overview_polyline": "gdpsBufo{LEg@~C?`@DZLZTh@j@h@Xb@JtNx@`BXz@FrBEn@?t@SnDZHEHONg@^kDhAyHfBuIf@mCx@}LdLLbCFvIB~r@pAtBF~CTtIfAbA@zAC~AW|JwCxBk@~EyAzD{AfBi@pAa@tJsC|Ai@rK`@p@?fAE~@Sv@_@vCcB^QXK~E]xBg@xGq@lAGrRC`JGzAUlTkIrPuGzEuA|AYbHo@bIMpFNbERpI\\fUtCxGx@zDb@`APh@`@hEgBv@_@rBqDd@e@f@SbAQ`B?TCpA[j@YXMZWf@w@bOaXNo@KUCWBWHULQRKZGZBXNNTHX?XFTLLnA~@`MpIjHlE~@v@rHlE~LvGbBj@zEjApBv@nBdA`CzAdA~@n@r@p@f@l@Zn@Pv@Nr@ZrCj@fGz@|Cv@`B\\|Dh@l@PpANlE?nABbAZ|DbBfB`@fALrOh@~@Hn@RlCvAl@Vn@Jb@?zDWzCI`C?rBJrTrAnBTbBXbFdAvEdA|LhBbGl@tATfAJr@A|AI|AMxB[|BOf@H|Bf@n@NrAx@lAdAv@\\t@JvEBfFI`HQR?d@Fp@ExCFvAHvGjAr@J`@JhETdFHhBHvC@h@DvB\\f@BlD@jAExBa@t@IlAG^G\\ObAkA\\Q`@GxE_@tDS~AUXO\\[`AgAb@]f@[p@U`JaB~@K`AAjAGdAOl@Md@OjBq@~@a@t@Sn@Ef@?tCTbC`@nFtAbAb@`@L\\DZ?|WwArBEfBAxBh@vBt@nEfA|Cp@dBl@p@\\~LfIVTTb@TXh@HTNbCMpHKjICxH@tACz@Qt@]bAeAXg@?Q@QFOJMLGPEN?N@rB{@|C_CfA{@J?@BJFt@dANNN@J?tAgALGVA~E|ATRYAoE}AUEKDiAx@"
            },
            {
                "distance": {
                    "text": "1 km",
                    "value": 1314
                },
                "duration": {
                    "text": "6 mins 4 secs",
                    "value": 364
                },
                "end_address": "Horniman Circle Garden, Homji Street, Kala Ghoda, Fort, Mumbai, Maharashtra, India",
                "start_address": "Taj Mahal Tower, Mumbai, PJ Ramchandani Marg, Apollo Bandar, Colaba, Mumbai, Maharashtra, India",
                "start_location": {
                    "lat": 18.9225854,
                    "lng": 72.8331543
                },
                "end_location": {
                    "lat": 18.93197,
                    "lng": 72.8350343
                },
                "stop_id": "16921857",
                "optimize_status": "normal",
                "stop_type": "delivery",
                "arr_time": 3825,
                "end_time": 4125,
                "optimize_order": 3,
                "stop_order": 6,
                "share_stop_id": 16921855,
                "address_typed": {
                    "delivery_count": 0
                },
                "overview_polyline": "aznrBmgp{Lc@XICoAgBKG_GtEi@l@S^@TCPOXMJQFS?[IOMIMCQ?Q@QFOGUEa@[gASq@q@o@[QiASyAKmDc@uEsAmAc@s@a@y@i@_BuAi@OoF_@"
            },
            {
                "distance": {
                    "text": "1 km",
                    "value": 1082
                },
                "duration": {
                    "text": "6 mins 33 secs",
                    "value": 393
                },
                "end_address": "Standard Chartered Mumbai 23-25 M G Road, Mumbai Branch, 23-25, Mahatma Gandhi Road, Azad Maidan, Fort, Mumbai, Maharashtra, India",
                "start_address": "Horniman Circle Garden, Homji Street, Kala Ghoda, Fort, Mumbai, Maharashtra, India",
                "start_location": {
                    "lat": 18.93197,
                    "lng": 72.8350343
                },
                "end_location": {
                    "lat": 18.9339261,
                    "lng": 72.8313813
                },
                "stop_id": "16921856",
                "optimize_status": "normal",
                "stop_type": "delivery",
                "arr_time": 4218,
                "end_time": 4518,
                "optimize_order": 4,
                "stop_order": 5,
                "share_stop_id": 16921855,
                "address_typed": {
                    "delivery_count": 0
                },
                "overview_polyline": "isprB{up{LcAIVKzAJn@v@Pn@Ar@I^QZWV[N_@Ha@A[E[OGJSFkHu@sBjKqBxIxBS|B["
            },
            {
                "distance": {
                    "text": "20 km",
                    "value": 20984
                },
                "duration": {
                    "text": "35 mins 42 secs",
                    "value": 2142
                },
                "end_address": "JW Marriott Mumbai Juhu, Juhu Road, Juhu Tara, Juhu, Mumbai, Maharashtra, India",
                "start_address": "Standard Chartered Mumbai 23-25 M G Road, Mumbai Branch, 23-25, Mahatma Gandhi Road, Azad Maidan, Fort, Mumbai, Maharashtra, India",
                "start_location": {
                    "lat": 18.9339261,
                    "lng": 72.8313813
                },
                "end_location": {
                    "lat": 19.1018504,
                    "lng": 72.8262233
                },
                "stop_id": "16921854",
                "optimize_status": "normal",
                "stop_type": "delivery",
                "arr_time": 6360,
                "end_time": 6660,
                "optimize_order": 5,
                "stop_order": 3,
                "share_stop_id": 16921852,
                "address_typed": {
                    "delivery_count": 0
                },
                "overview_polyline": "y_qrB_zo{LrDc@Yk@Y[w@c@cK}GoAm@qA_@cJuB_Cy@kBa@eB?uBD_ThAoBHe@?SAu@WaA]qFwA_AQ_AOuCSc@Am@Du@R}@^mBr@e@Nm@LgANmAF_AB_AH_J~Am@Tg@Xc@\\_AfA_@\\]N_BVwDRyE^]FYNeAhAa@Ra@FmAFs@H{B`@mADoDAg@CwB]g@EwCAkBIeFIiEUoAM_HoAsBK{EGaDLoJNcACuCC{@M{@a@mAcAsAw@i@Q_Cg@a@E}BLsBXaBNaAFsABiAKsAUgE_@{@Q}LkBuEiAaFeAeBWmBUqTsAsBK_C?{CH{DVg@Aq@Ko@WmCwAm@S}@GqOi@kAMiBa@}DeB_AYmAEqE?qAOs@@}Dk@wBa@sA]oB_@iAQaC]uCk@w@GgASe@Qu@]u@k@i@m@gAcAiC_BcB}@uBy@_B]_D}@_A[}Aw@aH{Du@q@aC{AqDsBgAg@mHkE_MkImBmAQCSDSASE]\\_FpIiHlM[n@O`@Kb@EhBGVKJKBMAu@k@c@Wa@Wu@K_A?_ANc@Rc@`@sBrDyG`DcB_AyMcBmBSsCc@_M_BeW}@aILaHn@{AXwEtAiK|DgDvAmTnIaBV{]Fy@DeHv@_CLOHaCXmARi@RqDtBe@NaATiBFiLc@OB_C|@mDjAyJvCoC`A}C|@wD~@_IjC_B^gAHcBB}@CmJkAqF]sNMmFKg\\w@wIFaCMcDAqFMm@vIU|BaC|Ly@bFi@|DKvAIZOJUAoD[u@Ro@?sBD{@GaBYuNy@c@Ki@Yi@k@[U[Ma@EyE@yGZwEX[TORCXDnAEREFSNyGdAS@OCMIIM_@sBEIQOYKuDVqIdAw@L}@HB\\XHHF@LAHEHw@J"
            },
            {
                "distance": {
                    "text": "1 km",
                    "value": 1040
                },
                "duration": {
                    "text": "7 mins 48 secs",
                    "value": 468
                },
                "end_address": "Juhu Beach, Mumbai, Maharashtra",
                "start_address": "JW Marriott Mumbai Juhu, Juhu Road, Juhu Tara, Juhu, Mumbai, Maharashtra, India",
                "start_location": {
                    "lat": 19.1018504,
                    "lng": 72.8262233
                },
                "end_location": {
                    "lat": 19.1095171,
                    "lng": 72.8241298
                },
                "stop_id": "16921853",
                "optimize_status": "normal",
                "stop_type": "delivery",
                "arr_time": 6828,
                "end_time": 7128,
                "optimize_order": 6,
                "stop_order": 2,
                "share_stop_id": 16921852,
                "address_typed": {
                    "delivery_count": 0
                },
                "overview_polyline": "_zqsB_}n{Le@HM?MGEGCOBKRME]cBVkBL}H^QEyDb@wHXMRE\\Bj@GLOPYHqA?]DUXAfBmC~@WRJdA"
            },
            {
                "distance": {
                    "text": "9 km",
                    "value": 9969
                },
                "duration": {
                    "text": "26 mins 34 secs",
                    "value": 1594
                },
                "end_address": "Raheja Vihar, Chandivali, Powai, Mumbai, Maharashtra, India",
                "start_address": "Juhu Beach, Mumbai, Maharashtra",
                "start_location": {
                    "lat": 19.1095171,
                    "lng": 72.8241298
                },
                "end_location": {
                    "lat": 19.1190749,
                    "lng": 72.8951151
                },
                "stop_id": null,
                "optimize_status": "normal",
                "stop_type": "normal",
                "arr_time": 8422,
                "end_time": 0,
                "optimize_order": 7,
                "stop_order": 2000,
                "share_stop_id": 0,
                "address_typed": {
                    "delivery_count": 0
                },
                "overview_polyline": "ogssBenn{LKeAVSlC_A@gBKBAaAGaA@u@CQX@JUCY{@Bg@E[GeEwByFgDs@m@kAsAu@UdBqDsC@_ICyKBU?DeSJgCEoGLuC@y@E{EGe@MmDIYGc@KuD@mDG]GsEAwGBeD@Y|@cE`@wBL{@\\sFr@{EB_@?]GwABkCP_Cf@iBvCuGpBeDv@kDn@{DrEyQp@gDVeBV{BZiBnAuEPw@Fo@@}@GoAkA{M[{CY_A[w@g@u@UUWc@pH_c@z@kDhEuOxBsIj@oBxDoNJy@Dy@JcFHgB\\gBXs@l@mAb@g@r@s@zCgChEgDhAyASKSUiFwC_@Mu@Qy@GkAEi@@i@F}@XmAVm@Hq@@qAE{Gc@cAOwC{@mBe@_@IEU{@oAmA_EiD}E{@yAEy@[kBiAwAaAeAi@JcABc@C[Yi@DwBTk@VYB_@MOJiAZ}AQM]GwBLoAGa@ISa@i@c@e@]Ok@O}@E"
            }
        ]
    }
}

Lệnh trên trả về JSON có cấu trúc như thế này nếu tối ưu hóa: sai:

{
    "code": 200,
    "status": true,
    "message": "Some stops is not settled in route optimization",
    "data": {
        "optimized": false,
        "legs": [],
        "route_stops": [
          {
            "id": 17019017,
            "address": "New York",
            "latitude": 40.7128,
            "longitude": 74.006,
            "optimized": false,
            "errors": [
                "Could not found nearest road"
            ]
          }
        ]
    }
}

Điểm cuối này NHẬN thông tin tuyến đường.

Yêu cầu HTTP

GET {{base_url}}/api/v6/routes/:route_id/optimize_route

Tham số truy vấn

Tham số Mặc định Mô tả
Mã API "" Khóa truy cập Api
driver_id "" Id tài xế của tuyến đường

WebMóc

ZeoRoutePlanner cho phép bạn sử dụng webhook để chúng tôi có thể thông báo cho bạn về các sự kiện. Bạn có thể đăng ký một webhook mới tại nền tảng của chúng tôi ("https://zeoruteplanner.com/app/team/settings/genrate-token").

Sự Kiện

lỗi

API Zeo Route Planner sử dụng các mã lỗi sau:

Mã lỗi Ý nghĩa
400 Yêu cầu không hợp lệ - Yêu cầu của bạn không hợp lệ.
401 Không được phép -- Khóa API của bạn sai.
404 Không tìm thấy -- Không thể tìm thấy yêu cầu được chỉ định.
500 Lỗi máy chủ nội bộ - Chúng tôi gặp sự cố với máy chủ của mình. Thử lại sau.
503 Dịch vụ không khả dụng -- Chúng tôi tạm thời ngoại tuyến để bảo trì. Vui lòng thử lại sau.