Введение
Планировщик маршрутов 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 |
останавливается | [{}] | Массив остановок |
Останавливает параметры объекта
Параметр | По умолчанию | Описание |
---|---|---|
адрес | "" | Остановить адрес |
широта | "" | Адрес Широта |
долгота | "" | Адрес Долгота |
ноты | "" | Любое сообщение для добавления |
оптимизировать_статус | «Нормальный» | |
стоп_длительность | «Оставайся на остановке» | |
прибытие_старт | "" | "Теперь" |
прибытие_конец | "" | "в любой момент" |
раннее | "" | |
последний | "" | |
стоп_тип | "" | (доставка/самовывоз) |
имя покупателя | "" | имя покупателя |
customer_mobile_number | "" | Контактный номер клиента |
driver_id | "" | Идентификатор водителя |
стоп_дата | "" | Дата окончания |
посылки_count | 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 |
"" | Электронная почта водителя | |
адрес | "" | Адрес водителя |
password | "" | Пароль от учетной записи водителя |
имя | "" | Имя водителя |
номер телефона | "" | Контактный номер |
Обновить драйвер
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_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 |
driver_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 |
driver_id | "" | Идентификатор водителя, который мы получаем из всех API драйверов. |
начальный_адрес | "" | Начальный адрес маршрута |
start_latitude | "" | Начальный адрес Широта |
start_longitude | "" | Начальный адрес Долгота |
конечный_адрес | "" | Конечный адрес маршрута |
конечная_широта | "" | Конечный адрес Широта |
end_longitude | "" | Конечный адрес Долгота |
имя_маршрута | "" | Название маршрута |
driver_id | "" | Идентификатор водителя для назначения маршрута |
оригинал | "" | |
останавливается | [] | Остановки между маршрутами |
дата_маршрута | '' | Дата маршрута |
Останавливает параметры объекта
Параметр | По умолчанию | Описание |
---|---|---|
адрес | "" | Остановить адрес |
широта | "" | Адрес Широта |
долгота | "" | Адрес Долгота |
ноты | "" | Любое сообщение для добавления |
оптимизировать_статус | «Нормальный» | |
стоп_длительность | «Оставайся на остановке» | |
прибытие_старт | "" | "Теперь" |
прибытие_конец | "" | "в любой момент" |
раннее | "" | |
последний | "" | |
стоп_тип | "" | (доставка/самовывоз) |
имя покупателя | "" | имя покупателя |
customer_mobile_number | "" | Контактный номер клиента |
посылки_count | 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 |
идентификатор_маршрута | "" | Идентификатор маршрута, который мы получаем из списка маршрутов |
driver_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 |
driver_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 |
идентификатор_маршрута | "" | Идентификатор маршрута, который мы получаем из списка маршрутов |
driver_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 | Следующие записи для возврата |
driver_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 | Следующие записи для возврата |
Дата начала | ноль | Дата начала маршрута (дд-мм-гггг) |
Дата окончания | ноль | Дата окончания маршрута (дд-мм-гггг) |
Получить маршрут, созданный для водителя владельцем магазина
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) |
начальный_адрес | "" | начальный адрес маршрута |
конечный_адрес | "" | конечный адрес маршрута |
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
Параметры запроса
Параметр | Тип данных | По умолчанию | Описание |
---|---|---|---|
driver_id | интервал (*) | Нужен driver_id для создания маршрута | |
начальный_адрес | нить (*) | Адрес начала маршрута | |
start_latitude | десятичная дробь | 0 | Требуется либо start_address ИЛИ start_latitude,start_longitude. |
start_longitude | десятичная дробь | 0 | Требуется либо start_address ИЛИ start_latitude,start_longitude. |
конечный_адрес | string | Конечная точка маршрута | |
конечная_широта | десятичная дробь | Требуется либо end_address ИЛИ end_latitude,end_longitude. | |
end_longitude | десятичная дробь | Требуется либо end_address ИЛИ end_latitude,end_longitude. | |
имя_маршрута | нить (*) | текущая дата (дд/мм/гг) | Название маршрута |
останавливается | массив объектов (*) | Останавливает информацию в массиве объекта |
Останавливает параметры объекта
Параметр | Тип данных | По умолчанию | Описание |
---|---|---|---|
id | ЦЕЛОЕ (*) | 0 | 1. Если stop_type является доставкой, идентификатор отправлять не нужно. 2. При получении stop_type необходимо отправить 20-значный идентификатор. |
стоп_ордер | интервал (*) | 0 | Добавить порядок остановки |
Share_stop_id | Int | 0 | 1. Если тип_остановки — самовывоз, оставьте его по умолчанию. 2. Если stop_type — это доставка и вы не хотите связываться с самовывозом, оставьте его по умолчанию. 3. Если вы хотите связать какой-либо пикап, укажите идентификатор этого идентификатора остановки пикапа. |
стоп_тип | string | поставка | значения должны быть доставка и самовывоз |
адрес | string | Требуется либо адрес ИЛИ широта,долгота | |
широта | десятичная дробь | 0 | Требуется либо адрес ИЛИ широта,долгота |
долгота | десятичная дробь | 0 | Требуется либо адрес ИЛИ широта,долгота |
ноты | string | Остановить соответствующую информацию | |
стоп_длительность | Int | 2 | Указывает продолжительность остановки в минутах, т.е. сколько времени она занимает на объекте клиента. |
имя покупателя | string | Информация для клиентов | |
customer_mobile_number | string | Информация для клиентов | |
customer_email | string | Информация для клиентов | |
адрес_типизированный | {} | {} | 1. Если тип_остановки — это самовывоз, то ключ — 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
Параметры запроса
Параметры запроса
Параметр | Тип данных | По умолчанию | Описание |
---|---|---|---|
driver_id | интервал (*) | Нужен driver_id для создания маршрута | |
начальный_адрес | нить (*) | Адрес начала маршрута | |
start_latitude | десятичная дробь | 0 | Требуется либо start_address ИЛИ start_latitude,start_longitude. |
start_longitude | десятичная дробь | 0 | Требуется либо start_address ИЛИ start_latitude,start_longitude. |
конечный_адрес | string | Конечная точка маршрута | |
конечная_широта | десятичная дробь | Требуется либо end_address ИЛИ end_latitude,end_longitude. | |
end_longitude | десятичная дробь | Требуется либо end_address ИЛИ end_latitude,end_longitude. | |
имя_маршрута | нить (*) | текущая дата (дд/мм/гг) | Название маршрута |
останавливается | массив объектов (*) | Останавливает информацию в массиве объекта |
Останавливает параметры объекта
Параметр | Тип данных | По умолчанию | Описание |
---|---|---|---|
id | ЦЕЛОЕ (*) | 0 | 1. Если stop_type является доставкой, идентификатор отправлять не нужно. 2. При получении stop_type необходимо отправить 20-значный идентификатор. |
стоп_ордер | интервал (*) | 0 | Добавить порядок остановки |
Share_stop_id | Int | 0 | 1. Если тип_остановки — самовывоз, оставьте его по умолчанию. 2. Если stop_type — это доставка и вы не хотите связываться с самовывозом, оставьте его по умолчанию. 3. Если вы хотите связать какой-либо пикап, укажите идентификатор этого идентификатора остановки пикапа. |
стоп_тип | string | поставка | значения должны быть доставка и самовывоз |
адрес | string | Требуется либо адрес ИЛИ широта,долгота | |
широта | десятичная дробь | 0 | Требуется либо адрес ИЛИ широта,долгота |
долгота | десятичная дробь | 0 | Требуется либо адрес ИЛИ широта,долгота |
ноты | string | Остановить соответствующую информацию | |
стоп_длительность | Int | 2 | Указывает продолжительность остановки в минутах, т.е. сколько времени она занимает на объекте клиента. |
имя покупателя | string | Информация для клиентов | |
customer_mobile_number | string | Информация для клиентов | |
customer_email | string | Информация для клиентов | |
адрес_типизированный | {} | {} | 1. Если тип_остановки — это самовывоз, то ключ — 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 |
идентификатор_маршрута | "" | Идентификатор маршрута, который мы получаем из списка маршрутов |
driver_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 |
идентификатор_маршрута | "" | Идентификатор маршрута, который мы получаем из списка маршрутов |
driver_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 со следующей структурой, если оптимизировать: 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 со следующей структурой, если оптимизировать: 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 |
driver_id | "" | Идентификатор водителя маршрута |
Вебхуки
ZeoRoutePlanner позволяет вам использовать вебхук, с помощью которого мы можем уведомлять вас о событиях. Вы можете зарегистрировать новый вебхук на нашей платформе ("https://zeorouteplanner.com/app/team/settings/genrate-token").
Мероприятия
- Вебхук остановки прогресса
ошибки
API Zeo Route Planner использует следующие коды ошибок:
Код ошибки | Смысл |
---|---|
400 | Неверный запрос. Ваш запрос недействителен. |
401 | Несанкционировано – ваш ключ API неверен. |
404 | Не найдено — указанный запрос не найден. |
500 | Внутренняя ошибка сервера. У нас возникла проблема с нашим сервером. Попробуйте позже. |
503 | Служба недоступна – мы временно недоступны для проведения технического обслуживания. Пожалуйста, повторите попытку позже. |