Увядзенне
Планавальнік маршрутаў Zeo дапамагае ўладальнікам аўтапаркаў ствараць і аптымізаваць маршруты для сваіх кіроўцаў. Уладальнікі аўтапаркаў або малыя прадпрыемствы, якія займаюцца дастаўкай у апошнюю мілю, могуць адсочваць стан дастаўкі, месцазнаходжанне кіроўцаў у рэальным часе і адпраўляць абнаўленні ў рэжыме рэальнага часу кліентам. Мабільныя прыкладанні Zeo для кіроўцаў-дастаўшчыкоў абсталяваны поўнай інтэграцыяй з усімі папулярнымі інструментамі навігацыі, уключаючы waze, tomtom, карты Google і г.д. Вадзіцель мае пад рукой усе важныя дэталі, уключаючы нататкі, звесткі аб кліентах і колькасць пасылак. Zeo апрацоўвае дынамічнае даданне і выдаленне адрасоў і перанакіроўвае паслядоўнасць, каб забяспечыць найбольш аптымізаваны маршрут. З Zeo ўладальнікі парку эканомяць да 200 долараў у месяц на кіроўцы і атрымліваюць доступ да высакаякасных справаздач, такіх як доказы дастаўкі, подпісы і пазнакі часу дастаўкі
Ідэнтыфікацыя
ZeoRoutePlanner выкарыстоўвае ключы API, каб дазволіць доступ да API. Вы можаце зарэгістраваць новы ключ API на нашай платформе (https://zeorouteplanner.com/app/team/settings/genrate-token).
ZeoRoutePlanner чакае, што ключ API будзе ўключаны ва ўсе запыты API да сервера ў параметрах, якія выглядаюць наступным чынам:
api_key: api_key
API ўладальніка крамы
Стварэнне прыпынкаў
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 |
| спыняецца | [{}] | Масіў прыпынкаў |
Спыняе параметры аб'екта
| Параметр | дэфолт | Апісанне |
|---|---|---|
| адрас | "" | Адрас прыпынку |
| шырата | "" | Шырата адраса |
| даўгата | "" | Даўгата адраса |
| ноты | "" | Любое паведамленне для дадання |
| аптымізаваць_статус | "нармальны" | |
| прыпынак_працягласць | «Стой на прыпынку» | |
| прыбыць_старт | "" | "цяпер" |
| прыбыць_канец | "" | "у любы час" |
| ранняе | "" | |
| апошні | "" | |
| стоп_тып | "" | (дастаўка/вываз) |
| Імя кліента | "" | Імя кліента |
| мабільны_нумар_кліента | "" | Кантактны нумар кліента |
| ідэнтыфікатар_кіроўца | "" | Ідэнтыфікатар драйвера |
| дата_прыпынку | "" | Дата спынення |
| колькасць пасылак | 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 |
| адрас | "" | Адрас кіроўцы |
| імя | "" | Імя кіроўцы |
| нумар_тэлефона | "" | Кантактны нумар кіроўцы |
| ідэнтыфікатар_кіроўца | "" | Ідэнтыфікатар драйвера мы атрымліваем з усіх 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 |
| ідэнтыфікатар_кіроўца | "" | Ідэнтыфікатар драйвера мы атрымліваем з усіх 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 |
| ідэнтыфікатар_кіроўца | "" | Ідэнтыфікатар драйвера мы атрымліваем з усіх API драйвераў |
| пачатковы_адрас | "" | Адрас пачатку маршруту |
| пачатковая_шырата | "" | Пачатковы адрас Latitude |
| пачатковая_даўгата | "" | Пачатковы адрас Даўгата |
| канчатковы_адрас | "" | Канчатковы адрас маршруту |
| канечная_шырата | "" | Канчатковы адрас 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
Параметры запыту
| Параметр | дэфолт | Апісанне |
|---|---|---|
| api_key | "" | Ключ доступу да api |
| маршрут_ідэнтыфікатар | "" | Ідэнтыфікатар маршруту мы атрымліваем са спісу маршрутаў |
| ідэнтыфікатар_кіроўца | "" | 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 |
| ідэнтыфікатар_кіроўца | "" | 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 драйвера маршруту |
Атрымаць усе маршруты драйвераў
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 | Наступныя запісы для вяртання |
| Дата пачатку | нуль | Дата пачатку маршруту (дд-мм-гггг) |
| канчатковая_дата | нуль | Дата заканчэння маршруту (дд-мм-гггг) |
Стварыце маршрут для кіроўцы ўладальнікам крамы
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) |
| пачатковы_адрас | "" | пачатковы адрас маршруту |
| канчатковы_адрас | "" | канчатковы адрас маршруту |
| электронная пошта драйвера | "" | электронная пошта кіроўцы |
| файл | "" | загрузіць файл у фармаце 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 для стварэння маршруту | |
| пачатковы_адрас | радок (*) | Адрас, адкуль пачынаецца маршрут | |
| пачатковая_шырата | дзесятковы | 0 | Патрабуецца альбо пачатковы_адрас, АБО пачатковая_шырата, пачатковая_даўгата |
| пачатковая_даўгата | дзесятковы | 0 | Патрабуецца альбо пачатковы_адрас, АБО пачатковая_шырата, пачатковая_даўгата |
| канчатковы_адрас | радок | Канцавое месцазнаходжанне маршруту | |
| канечная_шырата | дзесятковы | Патрабуецца альбо end_address, АБО end_latitude, end_longitude | |
| канец_даўгаты | дзесятковы | Патрабуецца альбо end_address, АБО end_latitude, end_longitude | |
| назва маршруту | радок (*) | бягучая дата (дд/мм/гг) | Назва маршруту |
| спыняецца | масіў аб'ектаў (*) | Спыняе інфармацыю ў масіве аб'екта |
Спыняе параметры аб'екта
| Параметр | Дататып | дэфолт | Апісанне |
|---|---|---|---|
| id | INT (*) | 0 | 1. Калі stop_type - гэта дастаўка, не трэба адпраўляць ідэнтыфікатар 2. Калі stop_type pickup, трэба адправіць 20-значны ідэнтыфікатар |
| стоп_загад | int (*) | 0 | Дадайце парадак прыпынку |
| доля_стоп_ідэнтыфікатар | INT | 0 | 1. Калі stop_type - пікапа, пакіньце яго па змаўчанні 2. Калі stop_type - гэта дастаўка і вы не хочаце звязвацца з самавывазам, пакіньце яго па змаўчанні 3. Калі вы хочаце звязацца з любым пад'ёмам, увядзіце ідэнтыфікатар гэтага прыпынку |
| стоп_тып | радок | дастаўка | значэннямі павінны быць дастаўка і самавываз |
| адрас | радок | Патрабуецца альбо адрас, АБО шырыня, даўгата | |
| шырата | дзесятковы | 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
Параметры запыту
Параметры запыту
| Параметр | Дататып | дэфолт | Апісанне |
|---|---|---|---|
| ідэнтыфікатар_кіроўца | int (*) | Патрэбен driver_id для стварэння маршруту | |
| пачатковы_адрас | радок (*) | Адрас, адкуль пачынаецца маршрут | |
| пачатковая_шырата | дзесятковы | 0 | Патрабуецца альбо пачатковы_адрас, АБО пачатковая_шырата, пачатковая_даўгата |
| пачатковая_даўгата | дзесятковы | 0 | Патрабуецца альбо пачатковы_адрас, АБО пачатковая_шырата, пачатковая_даўгата |
| канчатковы_адрас | радок | Канцавое месцазнаходжанне маршруту | |
| канечная_шырата | дзесятковы | Патрабуецца альбо end_address, АБО end_latitude, end_longitude | |
| канец_даўгаты | дзесятковы | Патрабуецца альбо end_address, АБО end_latitude, end_longitude | |
| назва маршруту | радок (*) | бягучая дата (дд/мм/гг) | Назва маршруту |
| спыняецца | масіў аб'ектаў (*) | Спыняе інфармацыю ў масіве аб'екта |
Спыняе параметры аб'екта
| Параметр | Дататып | дэфолт | Апісанне |
|---|---|---|---|
| id | INT (*) | 0 | 1. Калі stop_type - гэта дастаўка, не трэба адпраўляць ідэнтыфікатар 2. Калі stop_type pickup, трэба адправіць 20-значны ідэнтыфікатар |
| стоп_загад | int (*) | 0 | Дадайце парадак прыпынку |
| доля_стоп_ідэнтыфікатар | INT | 0 | 1. Калі stop_type - пікапа, пакіньце яго па змаўчанні 2. Калі stop_type - гэта дастаўка і вы не хочаце звязвацца з самавывазам, пакіньце яго па змаўчанні 3. Калі вы хочаце звязацца з любым пад'ёмам, увядзіце ідэнтыфікатар гэтага прыпынку |
| стоп_тып | радок | дастаўка | значэннямі павінны быць дастаўка і самавываз |
| адрас | радок | Патрабуецца альбо адрас, АБО шырыня, даўгата | |
| шырата | дзесятковы | 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
Параметры запыту
| Параметр | дэфолт | Апісанне |
|---|---|---|
| api_key | "" | Ключ доступу да api |
| маршрут_ідэнтыфікатар | "" | Ідэнтыфікатар маршруту мы атрымліваем са спісу маршрутаў |
| ідэнтыфікатар_кіроўца | "" | 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 драйвера маршруту |
Атрымлівайце інфармацыю пра аптымізаваны маршрут
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 |
| ідэнтыфікатар_кіроўца | "" | ID драйвера маршруту |
WebHooks
ZeoRoutePlanner дазваляе выкарыстоўваць webhook, мы можам паведамляць вам аб падзеях. Вы можаце зарэгістраваць новы вэбхук на нашай платформе ("https://zeorouteplanner.com/app/team/settings/genrate-token").
падзеі
- Спыніць вэб-хук прагрэсу
памылкі
Zeo Route Planner API выкарыстоўвае наступныя коды памылак:
| код памылкі | Сэнс |
|---|---|
| 400 | Дрэнны запыт -- Ваш запыт несапраўдны. |
| 401 | Несанкцыянавана - Ваш ключ API няправільны. |
| 404 | Не знойдзена -- указаны запыт не знойдзены. |
| 500 | Унутраная памылка сервера - у нас была праблема з нашым серверам. Паўтарыце спробу пазней. |
| 503 | Паслуга недаступная -- мы часова адключаны для абслугоўвання. Калі ласка паспрабуйце зноў пазней. |