NAV

შესავალი

Zeo მარშრუტის დამგეგმავი ფლოტის მფლობელებს ეხმარება მარშრუტების შექმნასა და ოპტიმიზაციაში მათი მძღოლებისთვის. ფლოტის მფლობელებს ან მცირე ბიზნესს, რომლებიც ახორციელებენ ადგილობრივ ბოლო მილის მიწოდებას, შეუძლიათ თვალყური ადევნონ მიწოდების სტატუსს, მძღოლების პირდაპირ მდებარეობას და გაუგზავნონ რეალურ დროში განახლებები კლიენტებს. Zeo-ს მობილური აპლიკაციები მიწოდების დრაივერებისთვის აღჭურვილია უწყვეტი ინტეგრაციით ყველა პოპულარული სანავიგაციო ხელსაწყოებით, მათ შორის waze, tomtom, Google maps და ა.შ. დრაივერს აქვს ყველა მნიშვნელოვანი დეტალი თითზე, მათ შორის შენიშვნები, კლიენტების დეტალები და ამანათის რაოდენობა. Zeo ამუშავებს მისამართის დინამიურ დამატებას და წაშლას და ცვლის თანმიმდევრობას ყველაზე ოპტიმიზებული მარშრუტის უზრუნველსაყოფად. Zeo-ს ფლოტის მფლობელები ზოგავენ თვეში 200$-მდე თითო მძღოლზე და მიიღეთ წვდომა მაღალი ხარისხის ანგარიშებზე, როგორიცაა მიწოდების მტკიცებულება, ხელმოწერები და მიწოდების დროის შტამპები

აუტენტიფიკაცია

ZeoRoutePlanner იყენებს API კლავიშებს API-ზე წვდომის დასაშვებად. თქვენ შეგიძლიათ დაარეგისტრიროთ ახალი API გასაღები ჩვენს პლატფორმაზე (https://zeorouteplanner.com/app/team/settings/genrate-token).

ZeoRoutePlanner მოელის, რომ API გასაღები ჩართული იქნება სერვერის ყველა API მოთხოვნაში პარამეტრებში, რომელიც გამოიყურება შემდეგნაირად:

api_key: api_key

მაღაზიის მფლობელი Api's

შექმენით გაჩერებები

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": [{}]
        }
    ]
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

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

ეს ბოლო წერტილი იბრუნებს ყველა დრაივერს.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
აჩერებს [{}] აჩერებს მასივს

აჩერებს ობიექტის პარამეტრებს

პარამეტრი Default აღწერა
მისამართი "" გაჩერების მისამართი
გრძედი "" მისამართი Latitude
გრძედი "" მისამართი გრძედი
აღნიშნავს "" ნებისმიერი შეტყობინება დასამატებლად
ოპტიმიზაცია_სტატუსს "ნორმალური"
გაჩერება_ხანგრძლივობა "დარჩი გაჩერებაზე"
ჩამოსვლა_დაწყება "" "ახლა"
ჩამოსვლა_დასრულება "" "ნებისმიერ დროს"
ადრეული ""
უკანასკნელი ""
გაჩერების_ტიპი "" (მიწოდება/წაყვანა)
მომხმარებლის სახელი "" მომხმარებლის სახელი
კლიენტის_მობილური_ნომერი "" კლიენტის საკონტაქტო ნომერი
მძღოლის_იდენტიფიკატორი "" მძღოლის ID
გაჩერების_თარიღი "" შეჩერების თარიღი
ამანათის_თვლა 1 ამანათის რაოდენობა
მეტადატის [] მორგებული ველი

მიიღეთ ყველა დრაივერი

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

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

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

ეს ბოლო წერტილი იბრუნებს ყველა დრაივერს.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები

დრაივერის შექმნა

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": " "
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
  "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
    }
  }
}

ამ ბოლო წერტილის შექმნა დრაივერი.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
ელფოსტაზე "" მძღოლის ელ.ფოსტა
მისამართი "" მძღოლის მისამართი
დაგავიწყდათ "" პაროლი მძღოლის ანგარიშისთვის
სახელი "" მძღოლის სახელი
ტელეფონის ნომერი "" საკონტაქტო ნომერი

მძღოლის განახლება

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"
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
  "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
    }
  }
}

ამ ბოლო წერტილის განახლების დრაივერის დეტალები.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მისამართი "" მძღოლის მისამართი
სახელი "" მძღოლის სახელი
ტელეფონის ნომერი "" მძღოლის საკონტაქტო ნომერი
მძღოლის_იდენტიფიკატორი "" დრაივერის ID-ს ვიღებთ ყველა დრაივერის api-დან

დრაივერის წაშლა

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

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

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

ამ ბოლო წერტილის წაშლის დრაივერი.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მძღოლის_იდენტიფიკატორი "" დრაივერის ID-ს ვიღებთ ყველა დრაივერის api-დან

მარშრუტის შექმნა

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": [{}]
    }
  ]
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
  "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": ""
         }
      ]
    }
  }
}

ეს საბოლოო წერტილი ქმნის მარშრუტს.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მძღოლის_იდენტიფიკატორი "" დრაივერის ID-ს ვიღებთ ყველა დრაივერის api-დან
საწყისი_მისამართი "" მარშრუტის დაწყების მისამართი
დასაწყისი_გრძედი "" დაწყება მისამართი Latitude
დასაწყისი_გრძედი "" დაწყება მისამართი Longitude
ბოლოს_მისამართი "" მარშრუტის დასრულების მისამართი
ბოლო_გრძედი "" ბოლო მისამართი Latitude
დასასრული_გრძედი "" ბოლო მისამართის გრძედი
მარშრუტის_სახელი "" მარშრუტის დასახელება
მძღოლის_იდენტიფიკატორი "" მარშრუტის დასანიშნად მძღოლის ID
ორიგინალური ""
აჩერებს [] ჩერდება მარშრუტებს შორის
მარშრუტი_თარიღი '' მარშრუტის თარიღი

აჩერებს ობიექტის პარამეტრებს

პარამეტრი Default აღწერა
მისამართი "" გაჩერების მისამართი
გრძედი "" მისამართი Latitude
გრძედი "" მისამართი გრძედი
აღნიშნავს "" ნებისმიერი შეტყობინება დასამატებლად
ოპტიმიზაცია_სტატუსს "ნორმალური"
გაჩერება_ხანგრძლივობა "დარჩი გაჩერებაზე"
ჩამოსვლა_დაწყება "" "ახლა"
ჩამოსვლა_დასრულება "" "ნებისმიერ დროს"
ადრეული ""
უკანასკნელი ""
გაჩერების_ტიპი "" (მიწოდება/წაყვანა)
მომხმარებლის სახელი "" მომხმარებლის სახელი
კლიენტის_მობილური_ნომერი "" კლიენტის საკონტაქტო ნომერი
ამანათის_თვლა 1 ამანათის რაოდენობა
მეტადატის [{}] მორგებული ველი

მიიღეთ მარშრუტის ინფორმაცია

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
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
  "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": ""
        }
      ]
    }
  }
}

ეს ბოლო წერტილი მიიღეთ მარშრუტის ინფორმაცია.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მარშრუტი_იდი "" მარშრუტის id-ს ვიღებთ მარშრუტების სიიდან
მძღოლის_იდენტიფიკატორი "" მარშრუტის მძღოლის ID

მიიღეთ მარშრუტის ოპტიმიზებული ინფორმაცია

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
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
    "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"
            }
        ]
    }
}

ეს ბოლო წერტილი მიიღეთ მარშრუტის ინფორმაცია.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მძღოლის_იდენტიფიკატორი "" მარშრუტის მძღოლის ID

მარშრუტის წაშლა

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
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

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

ამ ბოლო წერტილის წაშლის მარშრუტი.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მარშრუტი_იდი "" მარშრუტის id-ს ვიღებთ მარშრუტების სიიდან
მძღოლის_იდენტიფიკატორი "" მარშრუტის მძღოლის ID

მიიღეთ ყველა მძღოლის მარშრუტი

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"
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
  "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
  }
}

ეს ბოლო წერტილი იღებს ყველა მარშრუტს.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
ზღუდავს 50 ჩანაწერები დასაბრუნებელია
ოფსეტური 0 შემდეგი ჩანაწერები დასაბრუნებელია
მძღოლის_იდენტიფიკატორი მძღოლის ID

მიიღეთ მაღაზიის მფლობელის ყველა მარშრუტი

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
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
  "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
  }
}

ეს ბოლო წერტილი იღებს ყველა მარშრუტს.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
ზღუდავს 50 ჩანაწერები დასაბრუნებელია
ოფსეტური 0 შემდეგი ჩანაწერები დასაბრუნებელია
დაწყების თარიღი nil მარშრუტის დაწყების თარიღი (დდ-მმ-წწწწ)
დასრულების თარიღი nil მარშრუტის დასრულების თარიღი (დდ-მმ-წწწწ)

მიიღეთ მარშრუტის შექმნა მძღოლისთვის მაღაზიის მფლობელის მიერ

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"'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
    "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": ""
                }
            ]
        }
    }
}

ეს ბოლო წერტილი გამოიყენება მძღოლისთვის მარშრუტის შესაქმნელად.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები (გადადით გვერდზე ვებსაიტის url შედით მაღაზიის მფლობელის ანგარიშში, შემდეგ გადადით გვერდზე პარამეტრების გვერდიაირჩიეთ get api token და გენერირება api_key)
საწყისი_მისამართი "" მარშრუტის საწყისი მისამართი
ბოლოს_მისამართი "" მარშრუტის ბოლო მისამართი
მძღოლი_ელფოსტა "" მძღოლის ფოსტა
ფაილი "" ატვირთეთ ფაილი xlsx ფორმატში, შეგიძლიათ ჩამოტვირთოთ ბმულზე დაწკაპუნებით (ფაილის ნიმუშის ბმული)

პიკაპის მიწოდება

მარშრუტის შექმნა

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
    }
  ]
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
    "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
                }
            ]
        }
    }
}

ეს საბოლოო წერტილი ქმნის მარშრუტს.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Მონაცემთა ტიპი Default აღწერა
მძღოლის_იდენტიფიკატორი int (*) მარშრუტის შესაქმნელად საჭიროა driver_id
საწყისი_მისამართი სტრიქონი (*) მისამართი, საიდანაც იწყება მარშრუტი
დასაწყისი_გრძედი ათობითი 0 საჭიროა ან start_address ან start_latitude, start_longitude
დასაწყისი_გრძედი ათობითი 0 საჭიროა ან start_address ან start_latitude, start_longitude
ბოლოს_მისამართი სიმებიანი მარშრუტის ბოლო მდებარეობა
ბოლო_გრძედი ათობითი საჭიროა ან ბოლო_მისამართი ან ბოლო_გრძედი, ბოლო_გრძედი
დასასრული_გრძედი ათობითი საჭიროა ან ბოლო_მისამართი ან ბოლო_გრძედი, ბოლო_გრძედი
მარშრუტის_სახელი სტრიქონი (*) მიმდინარე თარიღი (დდ/მმ/წწ) მარშრუტის სახელი
აჩერებს ობიექტების მასივი (*) აჩერებს ინფორმაციას ობიექტების მასივში

აჩერებს ობიექტის პარამეტრებს

პარამეტრი Მონაცემთა ტიპი Default აღწერა
id Int (*) 0 1. თუ stop_type არის მიწოდება, არ არის საჭირო ID-ის გაგზავნა
2. თუ stop_type pickup, მაშინ უნდა გამოაგზავნოთ 20 ციფრიანი ID
Stop_Order int (*) 0 დაამატეთ გაჩერების რიგი
share_stop_id int 0 1. თუ stop_type არის პიკაპის დატოვება ნაგულისხმევად
2. თუ stop_type არის მიწოდება და არ გსურთ პიკაპთან დაკავშირება, დატოვეთ ის ნაგულისხმევად
3. თუ გსურთ რაიმე პიკაპთან დაკავშირება, ჩადეთ ამ პიკაპის გაჩერების ID
გაჩერების_ტიპი სიმებიანი მიწოდების ღირებულებები უნდა იყოს მიწოდება და მიღება
მისამართი სიმებიანი საჭიროა მისამართი ან გრძედი, განედი
გრძედი ათობითი 0 საჭიროა მისამართი ან გრძედი, განედი
გრძედი ათობითი 0 საჭიროა მისამართი ან გრძედი, განედი
აღნიშნავს სიმებიანი შეაჩერე დაკავშირებული ინფორმაცია
გაჩერება_ხანგრძლივობა int 2 განსაზღვრავს გაჩერების ხანგრძლივობას წუთებში, ანუ რამდენი ხანი სჭირდება მომხმარებლის ადგილზე.
მომხმარებლის სახელი სიმებიანი მომხმარებლის ინფორმაცია
კლიენტის_მობილური_ნომერი სიმებიანი მომხმარებლის ინფორმაცია
კლიენტი_ელფოსტა სიმებიანი მომხმარებლის ინფორმაცია
მისამართი_აკრეფილი {} {} 1. თუ stop_type არის აღება, მაშინ გასაღები არის delivery_count და მნიშვნელობა არის მიწოდების მთლიანი რაოდენობა, რომელიც დაკავშირებულია ამ აღებასთან
2. თუ stop_type არის მიწოდება, დატოვეთ ის ნაგულისხმევად

მარშრუტის განახლება

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
    }
  ]
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
    "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
                }
            ]
        }
    }
}

ეს ბოლო წერტილის განახლების მარშრუტი.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

შეკითხვის პარამეტრები

პარამეტრი Მონაცემთა ტიპი Default აღწერა
მძღოლის_იდენტიფიკატორი int (*) მარშრუტის შესაქმნელად საჭიროა driver_id
საწყისი_მისამართი სტრიქონი (*) მისამართი, საიდანაც იწყება მარშრუტი
დასაწყისი_გრძედი ათობითი 0 საჭიროა ან start_address ან start_latitude, start_longitude
დასაწყისი_გრძედი ათობითი 0 საჭიროა ან start_address ან start_latitude, start_longitude
ბოლოს_მისამართი სიმებიანი მარშრუტის ბოლო მდებარეობა
ბოლო_გრძედი ათობითი საჭიროა ან ბოლო_მისამართი ან ბოლო_გრძედი, ბოლო_გრძედი
დასასრული_გრძედი ათობითი საჭიროა ან ბოლო_მისამართი ან ბოლო_გრძედი, ბოლო_გრძედი
მარშრუტის_სახელი სტრიქონი (*) მიმდინარე თარიღი (დდ/მმ/წწ) მარშრუტის სახელი
აჩერებს ობიექტების მასივი (*) აჩერებს ინფორმაციას ობიექტების მასივში

აჩერებს ობიექტის პარამეტრებს

პარამეტრი Მონაცემთა ტიპი Default აღწერა
id Int (*) 0 1. თუ stop_type არის მიწოდება, არ არის საჭირო ID-ის გაგზავნა
2. თუ stop_type pickup, მაშინ უნდა გამოაგზავნოთ 20 ციფრიანი ID
Stop_Order int (*) 0 დაამატეთ გაჩერების რიგი
share_stop_id int 0 1. თუ stop_type არის პიკაპის დატოვება ნაგულისხმევად
2. თუ stop_type არის მიწოდება და არ გსურთ პიკაპთან დაკავშირება, დატოვეთ ის ნაგულისხმევად
3. თუ გსურთ რაიმე პიკაპთან დაკავშირება, ჩადეთ ამ პიკაპის გაჩერების ID
გაჩერების_ტიპი სიმებიანი მიწოდების ღირებულებები უნდა იყოს მიწოდება და მიღება
მისამართი სიმებიანი საჭიროა მისამართი ან გრძედი, განედი
გრძედი ათობითი 0 საჭიროა მისამართი ან გრძედი, განედი
გრძედი ათობითი 0 საჭიროა მისამართი ან გრძედი, განედი
აღნიშნავს სიმებიანი შეაჩერე დაკავშირებული ინფორმაცია
გაჩერება_ხანგრძლივობა int 2 განსაზღვრავს გაჩერების ხანგრძლივობას წუთებში, ანუ რამდენი ხანი სჭირდება მომხმარებლის ადგილზე.
მომხმარებლის სახელი სიმებიანი მომხმარებლის ინფორმაცია
კლიენტის_მობილური_ნომერი სიმებიანი მომხმარებლის ინფორმაცია
კლიენტი_ელფოსტა სიმებიანი მომხმარებლის ინფორმაცია
მისამართი_აკრეფილი {} {} 1. თუ stop_type არის აღება, მაშინ გასაღები არის delivery_count და მნიშვნელობა არის მიწოდების მთლიანი რაოდენობა, რომელიც დაკავშირებულია ამ აღებასთან
2. თუ stop_type არის მიწოდება, დატოვეთ ის ნაგულისხმევად

მიიღეთ მარშრუტის ინფორმაცია

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
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

{
    "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
                }
            ]
        }
    }
}

ეს ბოლო წერტილი მიიღეთ მარშრუტის ინფორმაცია.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მარშრუტი_იდი "" მარშრუტის id-ს ვიღებთ მარშრუტების სიიდან
მძღოლის_იდენტიფიკატორი "" მარშრუტის მძღოლის ID

წაშალეთ პიკაპის მიწოდების მარშრუტი

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
}'

ზემოაღნიშნული ბრძანება აბრუნებს JSON სტრუქტურას ასე:

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

ამ ბოლო წერტილის წაშლის მარშრუტი.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მარშრუტი_იდი "" მარშრუტის id-ს ვიღებთ მარშრუტების სიიდან
მძღოლის_იდენტიფიკატორი "" მარშრუტის მძღოლის ID

მიიღეთ მარშრუტის ოპტიმიზებული ინფორმაცია

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
}'

ზემოთ მოყვანილი ბრძანება აბრუნებს JSON სტრუქტურირებულს, თუ optimize: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"
            }
        ]
    }
}

ზემოთ მოყვანილი ბრძანება აბრუნებს JSON სტრუქტურირებულს, თუ optimize:false:

{
    "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"
            ]
          }
        ]
    }
}

ეს ბოლო წერტილი მიიღეთ მარშრუტის ინფორმაცია.

HTTP მოთხოვნა

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

შეკითხვის პარამეტრები

პარამეტრი Default აღწერა
api_key "" Api Access გასაღები
მძღოლის_იდენტიფიკატორი "" მარშრუტის მძღოლის ID

ვებჰუკები

ZeoRoutePlanner გაძლევთ საშუალებას გამოიყენოთ webhook, ჩვენ შეგვიძლია შეგატყობინოთ მოვლენების შესახებ. თქვენ შეგიძლიათ დაარეგისტრიროთ ახალი ვებჰუკი ჩვენს პლატფორმაზე ("https://zeorouteplanner.com/app/team/settings/genrate-token").

ივენთი

შეცდომები

Zeo Route Planner API იყენებს შეცდომის შემდეგ კოდებს:

შეცდომის კოდი რაც იმას ნიშნავს,
400 ცუდი მოთხოვნა -- თქვენი მოთხოვნა არასწორია.
401 არაავტორიზებული -- თქვენი API გასაღები არასწორია.
404 ვერ მოიძებნა -- მითითებული მოთხოვნა ვერ მოიძებნა.
500 შიდა სერვერის შეცდომა -- ჩვენ გვქონდა პრობლემა ჩვენს სერვერთან. Მოგვიანებით სცადეთ.
503 სერვისი მიუწვდომელია -- ჩვენ დროებით ხაზგარეშე ვართ ტექნიკური მომსახურებისთვის. Გთხოვთ სცადოთ მოგვიანებით.