บทนำ
เครื่องมือวางแผนเส้นทาง Zeo ช่วยให้เจ้าของกลุ่มยานพาหนะสร้างและเพิ่มประสิทธิภาพเส้นทางสำหรับผู้ขับขี่ของตน เจ้าของกลุ่มยานพาหนะหรือธุรกิจขนาดเล็กที่ดำเนินการจัดส่งระยะทางสุดท้ายในพื้นที่สามารถติดตามสถานะการจัดส่ง ตำแหน่งที่อยู่ของคนขับ และส่งการอัปเดตแบบเรียลไทม์ให้กับลูกค้า แอปมือถือของ Zeo สำหรับคนขับรถส่งของนั้นมาพร้อมกับการผสานรวมที่ราบรื่นกับเครื่องมือนำทางยอดนิยมทั้งหมด รวมถึง waze, tomtom, Google Maps ฯลฯ คนขับมีรายละเอียดที่สำคัญทั้งหมดอยู่เพียงปลายนิ้วสัมผัส รวมถึงบันทึกย่อ รายละเอียดลูกค้า และจำนวนพัสดุ Zeo จัดการการเพิ่มและการลบที่อยู่แบบไดนามิก และกำหนดเส้นทางใหม่ตามลำดับเพื่อมอบเส้นทางที่เหมาะสมที่สุด เจ้าของกลุ่มยานพาหนะ Zeo ประหยัดเงินได้มากถึง 200$ ต่อเดือนต่อคนขับ XNUMX คน และเข้าถึงรายงานคุณภาพสูง เช่น หลักฐานการจัดส่ง ลายเซ็น และการประทับเวลาการส่งมอบ
การยืนยันตัวตน
ZeoRoutePlanner ใช้คีย์ API เพื่ออนุญาตการเข้าถึง API คุณสามารถลงทะเบียนคีย์ API ใหม่ได้ที่แพลตฟอร์มของเรา (https://zeorouteplanner.com/app/team/settings/genrate-token).
ZeoRoutePlanner คาดว่าคีย์ API จะรวมอยู่ในคำขอ API ทั้งหมดที่ไปยังเซิร์ฟเวอร์ในพารามิเตอร์ที่มีลักษณะดังนี้:
api_key: api_key
เจ้าของร้าน อภิ'ส
สร้างจุดหยุด
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 |
หยุด | - | หยุดอาร์เรย์ |
หยุดพารามิเตอร์ออบเจ็กต์
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
ที่อยู่ | "" | ที่อยู่หยุด |
ละติจูด | "" | ที่อยู่ละติจูด |
ลองจิจูด | "" | ที่อยู่ ลองจิจูด |
บันทึก | "" | ข้อความใด ๆ ที่จะเพิ่ม |
ปรับให้เหมาะสม_สถานะ | "ปกติ" | |
stop_duration | "จอดอยู่" | |
มาถึง_start | "" | "ตอนนี้" |
มาถึง_end | "" | "ตลอดเวลา" |
ที่เก่าแก่ที่สุด | "" | |
ล่าสุด | "" | |
stop_type | "" | (จัดส่ง/นัดรับ) |
ชื่อลูกค้า | "" | ชื่อลูกค้า |
ลูกค้า_มือถือ_หมายเลข | "" | เบอร์ติดต่อลูกค้า |
ไดร์เวอร์_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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
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 |
อีเมล | "" | อีเมล์คนขับ |
ที่อยู่ | "" | ที่อยู่ของผู้ขับ |
รหัสผ่าน | "" | รหัสผ่านสำหรับบัญชีผู้ขับขี่ |
ชื่อ | "" | ชื่อคนขับ |
phone_no | "" | เบอร์ติดต่อของ |
การปรับปรุงโปรแกรมควบคุม
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 |
ที่อยู่ | "" | ที่อยู่ของผู้ขับ |
ชื่อ | "" | ชื่อคนขับ |
phone_no | "" | เบอร์ติดต่อคนขับรถ |
ไดร์เวอร์_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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
ไดร์เวอร์_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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
ไดร์เวอร์_id | "" | รหัสไดรเวอร์ที่เราได้รับจาก API ไดรเวอร์ทั้งหมด |
start_address | "" | ที่อยู่เริ่มต้นเส้นทาง |
start_latitude | "" | ที่อยู่เริ่มต้น ละติจูด |
start_longitude | "" | ที่อยู่เริ่มต้น ลองจิจูด |
end_address | "" | ที่อยู่สิ้นสุดเส้นทาง |
end_latitude | "" | ที่อยู่ปลายทางละติจูด |
end_longitude | "" | ที่อยู่สิ้นสุด ลองจิจูด |
เส้นทาง_ชื่อ | "" | ชื่อของเส้นทาง |
ไดร์เวอร์_id | "" | รหัสผู้ขับขี่เพื่อกำหนดเส้นทาง |
เดิม | "" | |
หยุด | [] | หยุดระหว่างเส้นทาง |
เส้นทาง_วันที่ | '' | วันที่เส้นทาง |
หยุดพารามิเตอร์ออบเจ็กต์
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
ที่อยู่ | "" | ที่อยู่หยุด |
ละติจูด | "" | ที่อยู่ละติจูด |
ลองจิจูด | "" | ที่อยู่ ลองจิจูด |
บันทึก | "" | ข้อความใด ๆ ที่จะเพิ่ม |
ปรับให้เหมาะสม_สถานะ | "ปกติ" | |
stop_duration | "จอดอยู่" | |
มาถึง_start | "" | "ตอนนี้" |
มาถึง_end | "" | "ตลอดเวลา" |
ที่เก่าแก่ที่สุด | "" | |
ล่าสุด | "" | |
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": ""
}
]
}
}
}
ข้อมูลเส้นทาง GET ปลายทางนี้
คำขอ HTTP
GET {{base_url}}/api/v5/routes/:route_id
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
เส้นทาง_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"
}
]
}
}
ข้อมูลเส้นทาง GET ปลายทางนี้
คำขอ HTTP
GET {{base_url}}/api/v5/routes/:route_id/optimize_route
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
ไดร์เวอร์_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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
เส้นทาง_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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
จำกัด | 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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
จำกัด | 50 | บันทึกที่จะส่งคืน |
ชดเชย | 0 | บันทึกถัดไปที่จะกลับมา |
วันที่เริ่มต้น | ศูนย์ | วันที่เริ่มต้นเส้นทาง (วว-ดด-ปปปป) |
end_date | ศูนย์ | วันที่สิ้นสุดเส้นทาง (วว-ดด-ปปปป) |
รับสร้างเส้นทางสำหรับคนขับโดยเจ้าของร้านค้า
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 (ไปที่หน้า URL เว็บไซต์ เข้าสู่ระบบบัญชีเจ้าของร้านค้า จากนั้นไปที่หน้า หน้าการตั้งค่าเลือกรับโทเค็น api และสร้าง api_key) |
start_address | "" | ที่อยู่เริ่มต้นของเส้นทาง |
end_address | "" | ที่อยู่ปลายทางของเส้นทาง |
ไดร์เวอร์_อีเมล์ | "" | อีเมลของคนขับ |
ไฟล์ | "" | อัพโหลดไฟล์ในรูปแบบ 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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ประเภทข้อมูล | ค่าเริ่มต้น | รายละเอียด |
---|---|---|---|
ไดร์เวอร์_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_address | เชือก | ตำแหน่งสิ้นสุดของเส้นทาง | |
end_latitude | ทศนิยม | จำเป็นต้องมี end_address หรือ end_latitude,end_longitude | |
end_longitude | ทศนิยม | จำเป็นต้องมี end_address หรือ end_latitude,end_longitude | |
เส้นทาง_ชื่อ | สตริง (*) | วันที่ปัจจุบัน(วว/ดด/ปปป) | ชื่อเส้นทาง |
หยุด | อาร์เรย์ของวัตถุ (*) | หยุดข้อมูลในอาร์เรย์ของวัตถุ |
หยุดพารามิเตอร์ออบเจ็กต์
พารามิเตอร์ | ประเภทข้อมูล | ค่าเริ่มต้น | รายละเอียด |
---|---|---|---|
id | อินท์ (*) | 0 | 1. หาก stop_type คือการจัดส่ง ไม่จำเป็นต้องส่งรหัส 2. หากรับประเภท stop_type จะต้องส่งรหัส 20 หลัก |
stop_order | int (*) | 0 | เพิ่มลำดับการหยุด |
share_stop_id | int | 0 | 1. หาก stop_type เป็น pickup ให้ปล่อยไว้เป็นค่าเริ่มต้น 2. หาก stop_type คือการจัดส่งและไม่ต้องการเชื่อมโยงกับการรับสินค้า ให้ปล่อยไว้เป็นค่าเริ่มต้น 3. หากคุณต้องการเชื่อมโยงกับการรับสินค้าใดๆ ให้ใส่รหัสของรหัสจุดรับสินค้านั้น |
stop_type | เชือก | การจัดส่ง | ค่าควรเป็นการส่งมอบและการรับสินค้า |
ที่อยู่ | เชือก | จำเป็นต้องมีที่อยู่หรือละติจูด,ลองจิจูด | |
ละติจูด | ทศนิยม | 0 | จำเป็นต้องมีที่อยู่หรือละติจูด,ลองจิจูด |
ลองจิจูด | ทศนิยม | 0 | จำเป็นต้องมีที่อยู่หรือละติจูด,ลองจิจูด |
บันทึก | เชือก | หยุดข้อมูลที่เกี่ยวข้อง | |
stop_duration | int | 2 | ระบุระยะเวลาของการหยุดเป็นนาที กล่าวคือ ใช้เวลานานแค่ไหนที่ไซต์งานของลูกค้า |
ชื่อลูกค้า | เชือก | ข้อมูลลูกค้า | |
ลูกค้า_มือถือ_หมายเลข | เชือก | ข้อมูลลูกค้า | |
ลูกค้า_อีเมล | เชือก | ข้อมูลลูกค้า | |
ที่อยู่_พิมพ์ | {} | {} | 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
พารามิเตอร์การสืบค้น
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ประเภทข้อมูล | ค่าเริ่มต้น | รายละเอียด |
---|---|---|---|
ไดร์เวอร์_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_address | เชือก | ตำแหน่งสิ้นสุดของเส้นทาง | |
end_latitude | ทศนิยม | จำเป็นต้องมี end_address หรือ end_latitude,end_longitude | |
end_longitude | ทศนิยม | จำเป็นต้องมี end_address หรือ end_latitude,end_longitude | |
เส้นทาง_ชื่อ | สตริง (*) | วันที่ปัจจุบัน(วว/ดด/ปปป) | ชื่อเส้นทาง |
หยุด | อาร์เรย์ของวัตถุ (*) | หยุดข้อมูลในอาร์เรย์ของวัตถุ |
หยุดพารามิเตอร์ออบเจ็กต์
พารามิเตอร์ | ประเภทข้อมูล | ค่าเริ่มต้น | รายละเอียด |
---|---|---|---|
id | อินท์ (*) | 0 | 1. หาก stop_type คือการจัดส่ง ไม่จำเป็นต้องส่งรหัส 2. หากรับประเภท stop_type จะต้องส่งรหัส 20 หลัก |
stop_order | int (*) | 0 | เพิ่มลำดับการหยุด |
share_stop_id | int | 0 | 1. หาก stop_type เป็น pickup ให้ปล่อยไว้เป็นค่าเริ่มต้น 2. หาก stop_type คือการจัดส่งและไม่ต้องการเชื่อมโยงกับการรับสินค้า ให้ปล่อยไว้เป็นค่าเริ่มต้น 3. หากคุณต้องการเชื่อมโยงกับการรับสินค้าใดๆ ให้ใส่รหัสของรหัสจุดรับสินค้านั้น |
stop_type | เชือก | การจัดส่ง | ค่าควรเป็นการส่งมอบและการรับสินค้า |
ที่อยู่ | เชือก | จำเป็นต้องมีที่อยู่หรือละติจูด,ลองจิจูด | |
ละติจูด | ทศนิยม | 0 | จำเป็นต้องมีที่อยู่หรือละติจูด,ลองจิจูด |
ลองจิจูด | ทศนิยม | 0 | จำเป็นต้องมีที่อยู่หรือละติจูด,ลองจิจูด |
บันทึก | เชือก | หยุดข้อมูลที่เกี่ยวข้อง | |
stop_duration | int | 2 | ระบุระยะเวลาของการหยุดเป็นนาที กล่าวคือ ใช้เวลานานแค่ไหนที่ไซต์งานของลูกค้า |
ชื่อลูกค้า | เชือก | ข้อมูลลูกค้า | |
ลูกค้า_มือถือ_หมายเลข | เชือก | ข้อมูลลูกค้า | |
ลูกค้า_อีเมล | เชือก | ข้อมูลลูกค้า | |
ที่อยู่_พิมพ์ | {} | {} | 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
}
]
}
}
}
ข้อมูลเส้นทาง GET ปลายทางนี้
คำขอ HTTP
GET {{base_url}}/api/v6/routes/:route_id
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
เส้นทาง_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
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
เส้นทาง_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 ที่มีโครงสร้างเช่นนี้หากปรับให้เหมาะสม: จริง:
{
"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 ที่มีโครงสร้างเช่นนี้ หากปรับให้เหมาะสม: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"
]
}
]
}
}
ข้อมูลเส้นทาง GET ปลายทางนี้
คำขอ HTTP
GET {{base_url}}/api/v6/routes/:route_id/optimize_route
พารามิเตอร์การสืบค้น
พารามิเตอร์ | ค่าเริ่มต้น | รายละเอียด |
---|---|---|
api_key | "" | คีย์การเข้าถึง API |
ไดร์เวอร์_id | "" | รหัสผู้ขับขี่ของเส้นทาง |
เว็บฮุค
ZeoRoutePlanner ช่วยให้คุณใช้ webhook ที่เราสามารถแจ้งให้คุณทราบเกี่ยวกับกิจกรรมได้ คุณสามารถลงทะเบียน webhook ใหม่ได้ที่แพลตฟอร์มของเรา ("https://zeorouteplanner.com/app/team/settings/genrate-token").
เหตุการณ์ที่เกิดขึ้น
- หยุดความคืบหน้า Webhook
ข้อผิดพลาด
Zeo Route Planner API ใช้รหัสข้อผิดพลาดต่อไปนี้:
รหัสผิดพลาด | ความหมาย |
---|---|
400 | คำขอไม่ถูกต้อง -- คำขอของคุณไม่ถูกต้อง |
401 | ไม่ได้รับอนุญาต -- รหัส API ของคุณไม่ถูกต้อง |
404 | ไม่พบ -- ไม่พบคำขอที่ระบุ |
500 | ข้อผิดพลาดเซิร์ฟเวอร์ภายใน -- เราประสบปัญหากับเซิร์ฟเวอร์ของเรา ลองอีกครั้งในภายหลัง |
503 | บริการไม่พร้อมใช้งาน -- เรากำลังออฟไลน์ชั่วคราวเพื่อบำรุงรักษา กรุณาลองใหม่อีกครั้งในภายหลัง. |