מבוא
מתכנן מסלולי 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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
עוצר | [{}] | עוצר מערך |
עוצר פרמטרים של אובייקט
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
כתובת | "" | כתובת עצור |
רוחב | "" | כתובת Latitude |
אורך | "" | כתובת קו אורך |
הערות | "" | כל הודעה להוסיף |
optimize_status | "נוֹרמָלִי" | |
stop_duration | "הישאר בתחנה" | |
להגיע_התחל | "" | "עַכשָׁיו" |
להגיע_סוף | "" | "בכל עת" |
הכי מוקדם | "" | |
האחרון | "" | |
stop_type | "" | (משלוח/איסוף) |
שם לקוח | "" | שם לקוח |
לקוח_נייד_מספר | "" | מספר איש קשר ללקוח |
מזהה_נהג | "" | זיהוי נהג |
תאריך_עצירה | "" | תאריך עצור |
ספירת_חבילות | 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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
צור דרייבר
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
אמייל | "" | דוא"ל לנהג |
כתובת | "" | כתובת נהג |
סיסמא | "" | סיסמא לחשבון נהג |
שם | "" | שם הנהג |
בטלפון | "" | מספר איש קשר של |
עדכון מנהל התקן
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
כתובת | "" | כתובת נהג |
שם | "" | שם הנהג |
בטלפון | "" | מספר איש קשר של הנהג |
מזהה_נהג | "" | מזהה דרייבר אנו מקבלים מכל ממשקי ה-Driver |
מחק דרייבר
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
מזהה_נהג | "" | מזהה דרייבר אנו מקבלים מכל ממשקי ה-Driver |
צור מסלול
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
מזהה_נהג | "" | מזהה דרייבר אנו מקבלים מכל ממשקי ה-Driver |
start_address | "" | כתובת התחלה של מסלול |
start_latitude | "" | התחל כתובת Latitude |
start_longitude | "" | כתובת התחלה קו אורך |
כתובת קצה | "" | כתובת סיום המסלול |
end_latitude | "" | כתובת סיום Latitude |
end_longitude | "" | כתובת סיום קו אורך |
route_name | "" | שם המסלול |
מזהה_נהג | "" | זיהוי נהג להקצאת מסלול |
אורגינל | "" | |
עוצר | [] | עצירות בין מסלולים |
תאריך_מסלול | '' | תאריך מסלול |
עוצר פרמטרים של אובייקט
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
כתובת | "" | כתובת עצור |
רוחב | "" | כתובת Latitude |
אורך | "" | כתובת קו אורך |
הערות | "" | כל הודעה להוסיף |
optimize_status | "נוֹרמָלִי" | |
stop_duration | "הישאר בתחנה" | |
להגיע_התחל | "" | "עַכשָׁיו" |
להגיע_סוף | "" | "בכל עת" |
הכי מוקדם | "" | |
האחרון | "" | |
stop_type | "" | (משלוח/איסוף) |
שם לקוח | "" | שם לקוח |
לקוח_נייד_מספר | "" | מספר איש קשר ללקוח |
ספירת_חבילות | 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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
route_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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
מזהה_נהג | "" | זיהוי הנהג של המסלול |
מחק מסלול
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
route_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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
להגביל | 50 | רשומות להחזר |
לקזז | 0 | השיאים הבאים להחזיר |
מזהה_נהג | מזהה נהג |
קבל את כל מסלולי בעלי החנות
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
להגביל | 50 | רשומות להחזר |
לקזז | 0 | השיאים הבאים להחזיר |
תאריך התחלה | אפס | תאריך תחילת המסלול (dd-mm-yyyy) |
תאריך סיום | אפס | תאריך סיום המסלול (dd-mm-yyyy) |
קבל יצירת מסלול לנהג על ידי בעל החנות
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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API (עבור לדף כתובת אתר היכנס לחשבון בעל החנות ולאחר מכן עבור לדף דף הגדרותבחר קבל אסימון API וצור api_key) |
start_address | "" | כתובת ההתחלה של המסלול |
כתובת קצה | "" | כתובת הסיום של המסלול |
driver_email | "" | אימייל של הנהג |
פילה | "" | העלה קובץ בפורמט 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
פרמטרי שאילתה
פרמטר | סוג נתונים | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
מזהה_נהג | int (*) | צריך driver_id ליצירת מסלול | |
start_address | מחרוזת (*) | כתובת מהיכן מתחיל המסלול | |
start_latitude | עֶשׂרוֹנִי | 0 | חובה או start_address או start_latitude,start_longitude |
start_longitude | עֶשׂרוֹנִי | 0 | חובה או start_address או start_latitude,start_longitude |
כתובת קצה | מחרוזת | מיקום סיום המסלול | |
end_latitude | עֶשׂרוֹנִי | נדרש או end_address או end_latitude, end_longitude | |
end_longitude | עֶשׂרוֹנִי | נדרש או end_address או end_latitude, end_longitude | |
route_name | מחרוזת (*) | תאריך נוכחי (dd/mm/yy) | שם המסלול |
עוצר | מערך אובייקטים (*) | עוצר מידע במערך האובייקט |
עוצר פרמטרים של אובייקט
פרמטר | סוג נתונים | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
id | INT (*) | 0 | 1. אם stop_type הוא משלוח אין צורך לשלוח מזהה 2. אם stop_type איסוף אז צריך לשלוח מזהה בן 20 ספרות |
stop_order | int (*) | 0 | הוסף סדר עצירה |
share_stop_id | int | 0 | 1. אם stop_type הוא איסוף השאר אותו כברירת מחדל 2. אם stop_type הוא משלוח ואינך רוצה לקשר לאיסוף השאר אותו כברירת מחדל 3. אם ברצונך לקשר עם איסוף כלשהו, שים את הזיהוי של מזהה עצירת האיסוף הזה |
stop_type | מחרוזת | מסירה | הערכים צריכים להיות משלוח ואיסוף |
כתובת | מחרוזת | דרושה כתובת או קו רוחב, קו אורך | |
רוחב | עֶשׂרוֹנִי | 0 | דרושה כתובת או קו רוחב, קו אורך |
אורך | עֶשׂרוֹנִי | 0 | דרושה כתובת או קו רוחב, קו אורך |
הערות | מחרוזת | הפסק מידע קשור | |
stop_duration | int | 2 | מציין את משך העצירה בדקות, כלומר כמה זמן לוקח באתר הלקוח. |
שם לקוח | מחרוזת | מידע ללקוח | |
לקוח_נייד_מספר | מחרוזת | מידע ללקוח | |
customer_email | מחרוזת | מידע ללקוח | |
כתובת_מוקלדת | {} | {} | 1. אם stop_type הוא איסוף, המפתח הוא delivery_count והערך הוא ב-int המספר הכולל של משלוחים מקושר לאיסוף זה 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
פרמטרי שאילתה
פרמטרי שאילתה
פרמטר | סוג נתונים | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
מזהה_נהג | int (*) | צריך driver_id ליצירת מסלול | |
start_address | מחרוזת (*) | כתובת מהיכן מתחיל המסלול | |
start_latitude | עֶשׂרוֹנִי | 0 | חובה או start_address או start_latitude,start_longitude |
start_longitude | עֶשׂרוֹנִי | 0 | חובה או start_address או start_latitude,start_longitude |
כתובת קצה | מחרוזת | מיקום סיום המסלול | |
end_latitude | עֶשׂרוֹנִי | נדרש או end_address או end_latitude, end_longitude | |
end_longitude | עֶשׂרוֹנִי | נדרש או end_address או end_latitude, end_longitude | |
route_name | מחרוזת (*) | תאריך נוכחי (dd/mm/yy) | שם המסלול |
עוצר | מערך אובייקטים (*) | עוצר מידע במערך האובייקט |
עוצר פרמטרים של אובייקט
פרמטר | סוג נתונים | בְּרִירַת מֶחדָל | תיאור |
---|---|---|---|
id | INT (*) | 0 | 1. אם stop_type הוא משלוח אין צורך לשלוח מזהה 2. אם stop_type איסוף אז צריך לשלוח מזהה בן 20 ספרות |
stop_order | int (*) | 0 | הוסף סדר עצירה |
share_stop_id | int | 0 | 1. אם stop_type הוא איסוף השאר אותו כברירת מחדל 2. אם stop_type הוא משלוח ואינך רוצה לקשר לאיסוף השאר אותו כברירת מחדל 3. אם ברצונך לקשר עם איסוף כלשהו, שים את הזיהוי של מזהה עצירת האיסוף הזה |
stop_type | מחרוזת | מסירה | הערכים צריכים להיות משלוח ואיסוף |
כתובת | מחרוזת | דרושה כתובת או קו רוחב, קו אורך | |
רוחב | עֶשׂרוֹנִי | 0 | דרושה כתובת או קו רוחב, קו אורך |
אורך | עֶשׂרוֹנִי | 0 | דרושה כתובת או קו רוחב, קו אורך |
הערות | מחרוזת | הפסק מידע קשור | |
stop_duration | int | 2 | מציין את משך העצירה בדקות, כלומר כמה זמן לוקח באתר הלקוח. |
שם לקוח | מחרוזת | מידע ללקוח | |
לקוח_נייד_מספר | מחרוזת | מידע ללקוח | |
customer_email | מחרוזת | מידע ללקוח | |
כתובת_מוקלדת | {} | {} | 1. אם stop_type הוא איסוף, המפתח הוא delivery_count והערך הוא ב-int המספר הכולל של משלוחים מקושר לאיסוף זה 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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
route_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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
route_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
פרמטרי שאילתה
פרמטר | בְּרִירַת מֶחדָל | תיאור |
---|---|---|
api_key | "" | מפתח גישה ל-API |
מזהה_נהג | "" | זיהוי הנהג של המסלול |
WebHooks
ZeoRoutePlanner מאפשר לך להשתמש ב-webhook אנחנו יכולים להודיע לך על האירועים. אתה יכול לרשום webhook חדש בפלטפורמה שלנו ("https://zeorouteplanner.com/app/team/settings/genrate-token").
אירועים
- עצור את Progress Webhook
שגיאות
ה-API של Zeo Route Planner משתמש בקודי השגיאה הבאים:
קוד שגיאה | משמעות |
---|---|
400 | בקשה שגויה -- בקשתך אינה חוקית. |
401 | לא מורשה -- מפתח ה-API שלך שגוי. |
404 | לא נמצא -- הבקשה שצוינה לא נמצאה. |
500 | שגיאת שרת פנימית -- הייתה לנו בעיה עם השרת שלנו. נסה שוב מאוחר יותר. |
503 | השירות לא זמין -- אנחנו במצב לא מקוון באופן זמני לצורך תחזוקה. בבקשה נסה שוב מאוחר יותר. |