introdución
O planificador de rutas Zeo axuda aos propietarios de flotas a crear e optimizar rutas para os seus condutores. Os propietarios de flotas ou as pequenas empresas que realizan entregas locais na última milla poden facer un seguimento do estado da entrega, a localización en directo dos condutores e enviar actualizacións en tempo real aos clientes. As aplicacións móbiles de Zeo para os condutores de entrega están equipadas con integracións perfectas con todas as ferramentas de navegación populares, incluíndo waze, tomtom, Google maps, etc. O condutor ten todos os detalles importantes ao alcance dos seus dedos, incluíndo notas, detalles do cliente e conta de paquetes. Zeo xestiona a adición e o borrado de enderezos dinámicos e redirecciona a secuencia para ofrecer a ruta máis optimizada. Con Zeo, os propietarios de flotas aforran ata 200 $ ao mes por condutor e obteñen acceso a informes de alta calidade como probas de entrega, sinaturas e selos de prazo de entrega.
Identificación
ZeoRoutePlanner usa claves API para permitir o acceso á API. Pode rexistrar unha nova clave API na nosa plataforma (https://zeorouteplanner.com/app/team/settings/genrate-token).
ZeoRoutePlanner espera que a clave de API se inclúa en todas as solicitudes de API ao servidor nun parámetro que semella o seguinte:
api_key: api_key
Api do propietario da tenda
Crear paradas
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": [{}]
}
]
}'
O comando anterior devolve JSON estruturado así:
{
"code": 200,
"status": true,
"message": "Stops added successfully"
}
Este punto final recupera todos os controladores.
Solicitude HTTP
POST {{base_url}}/api/v5/route_stop
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| stops | [{}] | Detén Array |
Detén os parámetros do obxecto
| Parámetro | defecto | descrición |
|---|---|---|
| enderezo | "" | Deter o enderezo |
| latitud | "" | Enderezo Latitude |
| lonxitude | "" | Lonxitude do enderezo |
| notas | "" | Calquera mensaxe para engadir |
| optimize_status | "normal" | |
| parar_duración | "Quédate en parada" | |
| chegar_iniciar | "" | "agora" |
| chegar_final | "" | "en calquera momento" |
| o máis antigo | "" | |
| última | "" | |
| tipo_parada | "" | (entrega/recollida) |
| nome_cliente | "" | Nome do cliente |
| número_móbil_cliente | "" | Número de contacto do cliente |
| controlador_id | "" | ID do condutor |
| data_parada | "" | Data de parada |
| número de parcelas | 1 | Número de paquetes |
| metadatos | [] | Campo personalizado |
Obter todos os controladores
curl --location -g --request GET '{{base_url}}/api/v5/drivers?api_key=api_key'
O comando anterior devolve JSON estruturado así:
{
"code": 200,
"status": true,
"message": "success",
"data": {
"drivers": [
{
"id": 44914,
"email": "0f12ebdd@gmail.com",
"name": "nishu jain",
"address": null,
"phone_no": "8959294300",
"active": true
}
]
}
}
Este punto final recupera todos os controladores.
Solicitude HTTP
GET {{base_url}}/api/v5/drivers
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
Crear controlador
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": " "
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
}
}
Este controlador de creación de punto final.
Solicitude HTTP
POST {{base_url}}/api/v5/drivers
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| correo electrónico | "" | Correo electrónico do controlador |
| enderezo | "" | Enderezo do condutor |
| contrasinal | "" | Contrasinal para a conta do controlador |
| nome | "" | Nome do condutor |
| teléfono_no | "" | Número de contacto de |
Actualizar o controlador
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"
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
}
}
Detalles do controlador de actualización deste punto final.
Solicitude HTTP
PUT {{base_url}}/api/v5/drivers/:driver_id
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| enderezo | "" | Enderezo do condutor |
| nome | "" | Nome do condutor |
| teléfono_no | "" | Número de contacto do condutor |
| controlador_id | "" | ID do controlador que obtemos de todas as API do controlador |
Eliminar controlador
curl --location -g --request DELETE '{{base_url}}/api/v5/drivers/:driver_id' \
--header 'Content-Type: application/json' \
--data-raw '{
"api_key": "api_key"
}'
O comando anterior devolve JSON estruturado así:
{
"code": 200,
"status": true,
"message": "Driver deleted successful"
}
Este controlador elimina este punto final.
Solicitude HTTP
DELETE {{base_url}}/api/v5/drivers/:driver_id
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| controlador_id | "" | ID do controlador que obtemos de todas as API do controlador |
Crear ruta
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": [{}]
}
]
}'
O comando anterior devolve JSON estruturado así:
{
"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": ""
}
]
}
}
}
Este punto final crea unha ruta.
Solicitude HTTP
POST {{base_url}}/api/v5/routes
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| controlador_id | "" | ID do controlador que obtemos de todas as API do controlador |
| enderezo_inicio | "" | Enderezo de inicio da ruta |
| latitude_inicio | "" | Enderezo de inicio Latitude |
| lonxitude_inicio | "" | Enderezo de inicio Lonxitude |
| enderezo_final | "" | Enderezo final da ruta |
| latitude_final | "" | Enderezo final Latitude |
| lonxitude_final | "" | Enderezo final Lonxitude |
| nome_ruta | "" | Nome da ruta |
| controlador_id | "" | ID do condutor para asignar ruta |
| orixinal | "" | |
| stops | [] | Paradas entre rutas |
| ruta_data | '' | Data da ruta |
Detén os parámetros do obxecto
| Parámetro | defecto | descrición |
|---|---|---|
| enderezo | "" | Deter o enderezo |
| latitud | "" | Enderezo Latitude |
| lonxitude | "" | Lonxitude do enderezo |
| notas | "" | Calquera mensaxe para engadir |
| optimize_status | "normal" | |
| parar_duración | "Quédate en parada" | |
| chegar_iniciar | "" | "agora" |
| chegar_final | "" | "en calquera momento" |
| o máis antigo | "" | |
| última | "" | |
| tipo_parada | "" | (entrega/recollida) |
| nome_cliente | "" | Nome do cliente |
| número_móbil_cliente | "" | Número de contacto do cliente |
| número de parcelas | 1 | Número de paquetes |
| metadatos | [{}] | Campo personalizado |
Obter información da ruta
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
}'
O comando anterior devolve JSON estruturado así:
{
"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": ""
}
]
}
}
}
Información da ruta GET deste punto final.
Solicitude HTTP
GET {{base_url}}/api/v5/routes/:route_id
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| ruta_id | "" | ID de ruta que obtemos da lista de rutas |
| controlador_id | "" | Identificación do condutor da ruta |
Obter información de ruta optimizada
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
}'
O comando anterior devolve JSON estruturado así:
{
"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"
}
]
}
}
Información da ruta GET deste punto final.
Solicitude HTTP
GET {{base_url}}/api/v5/routes/:route_id/optimize_route
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| controlador_id | "" | Identificación do condutor da ruta |
Eliminar ruta
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
}'
O comando anterior devolve JSON estruturado así:
{
"code": 200,
"status": true,
"message": "Route deleted successfully"
}
Este punto final elimina a ruta.
Solicitude HTTP
DELETE {{base_url}}/api/v5/routes/:route_id
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| ruta_id | "" | ID de ruta que obtemos da lista de rutas |
| controlador_id | "" | Identificación do condutor da ruta |
Obter todas as rutas dos condutores
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"
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
}
Este punto final obtén todas as rutas.
Solicitude HTTP
GET {{base_url}}/api/v5/routes
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| limitar | 50 | Rexistros para devolver |
| compensar | 0 | Próximos rexistros para devolver |
| controlador_id | ID do controlador |
Obter todas as rutas do propietario da tenda
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
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
}
Este punto final obtén todas as rutas.
Solicitude HTTP
GET {{base_url}}/api/v5/routes/all_routes
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| limitar | 50 | Rexistros para devolver |
| compensar | 0 | Próximos rexistros para devolver |
| data_inicio | cero | Data de inicio da ruta (dd-mm-aaaa) |
| data_final | cero | Data de finalización da ruta (dd-mm-aaaa) |
Obtén a creación de ruta para o condutor polo propietario da tenda
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"'
O comando anterior devolve JSON estruturado así:
{
"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": ""
}
]
}
}
}
Este punto final utilizouse para crear unha ruta para o condutor.
Solicitude HTTP
POST {{base_url}}/api/v5/routes/import_orders
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API (Ir á páxina URL do sitio web inicia sesión na conta do propietario da tenda e despois Ir á páxina Páxina de configuraciónseleccione obter o token api e xerar api_key) |
| enderezo_inicio | "" | enderezo de inicio da ruta |
| enderezo_final | "" | enderezo final da ruta |
| controlador_correo electrónico | "" | correo electrónico do condutor |
| arquivo | "" | carga o ficheiro en formato xlsx que podes descargar facendo clic na ligazón (Ligazón ao ficheiro de mostra) |
Entregas de recollida
Crear ruta
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
}
]
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
]
}
}
}
Este punto final crea unha ruta.
Solicitude HTTP
POST {{base_url}}/api/v6/routes
Parámetros de consulta
| Parámetro | Tipo de datos | defecto | descrición |
|---|---|---|---|
| controlador_id | int (*) | Precísase driver_id para crear unha ruta | |
| enderezo_inicio | cadea (*) | Enderezo desde onde comeza a ruta | |
| latitude_inicio | decimal | 0 | Requírese start_address OU start_latitude,start_longitude |
| lonxitude_inicio | decimal | 0 | Requírese start_address OU start_latitude,start_longitude |
| enderezo_final | corda | Localización final da ruta | |
| latitude_final | decimal | Requírese end_address OU end_latitude,end_longitude | |
| lonxitude_final | decimal | Requírese end_address OU end_latitude,end_longitude | |
| nome_ruta | cadea (*) | data actual (dd/mm/aa) | Nome da ruta |
| stops | matriz de obxectos (*) | Detén información na matriz de obxectos |
Detén os parámetros do obxecto
| Parámetro | Tipo de datos | defecto | descrición |
|---|---|---|---|
| id | INT (*) | 0 | 1. Se stop_type é a entrega, non é necesario enviar a identificación 2. Se a recollida de stop_type é necesario enviar unha identificación de 20 díxitos |
| parar_orde | int (*) | 0 | Engadir orde de parada |
| share_stop_id | int | 0 | 1. Se stop_type é pickup déixao como predeterminado 2. Se stop_type é entrega e non queres vincular coa recollida, déixao como predeterminado 3. Se queres enlazar con calquera pickup, pon a identificación desa parada de recollida |
| tipo_parada | corda | entrega | os valores deben ser a entrega e a recollida |
| enderezo | corda | Requírese o enderezo OU latitude,Lonxitude | |
| latitud | decimal | 0 | Requírese o enderezo OU latitude,Lonxitude |
| lonxitude | decimal | 0 | Requírese o enderezo OU latitude,Lonxitude |
| notas | corda | Detén a información relacionada | |
| parar_duración | int | 2 | Especifica a duración da parada en minutos, é dicir, canto tempo leva no sitio do cliente. |
| nome_cliente | corda | Información do cliente | |
| número_móbil_cliente | corda | Información do cliente | |
| customer_email | corda | Información do cliente | |
| enderezo_escrito | {} | {} | 1. Se stop_type é pickup, a clave é delivery_count e o valor está en int. O número total de entregas está ligado a esta recollida 2. se stop_type é a entrega déixao por defecto |
Actualizar ruta
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
}
]
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
]
}
}
}
Esta ruta de actualización do punto final.
Solicitude HTTP
POST {{base_url}}/api/v6/routes/:route_id
Parámetros de consulta
Parámetros de consulta
| Parámetro | Tipo de datos | defecto | descrición |
|---|---|---|---|
| controlador_id | int (*) | Precísase driver_id para crear unha ruta | |
| enderezo_inicio | cadea (*) | Enderezo desde onde comeza a ruta | |
| latitude_inicio | decimal | 0 | Requírese start_address OU start_latitude,start_longitude |
| lonxitude_inicio | decimal | 0 | Requírese start_address OU start_latitude,start_longitude |
| enderezo_final | corda | Localización final da ruta | |
| latitude_final | decimal | Requírese end_address OU end_latitude,end_longitude | |
| lonxitude_final | decimal | Requírese end_address OU end_latitude,end_longitude | |
| nome_ruta | cadea (*) | data actual (dd/mm/aa) | Nome da ruta |
| stops | matriz de obxectos (*) | Detén información na matriz de obxectos |
Detén os parámetros do obxecto
| Parámetro | Tipo de datos | defecto | descrición |
|---|---|---|---|
| id | INT (*) | 0 | 1. Se stop_type é a entrega, non é necesario enviar a identificación 2. Se a recollida de stop_type é necesario enviar unha identificación de 20 díxitos |
| parar_orde | int (*) | 0 | Engadir orde de parada |
| share_stop_id | int | 0 | 1. Se stop_type é pickup déixao como predeterminado 2. Se stop_type é entrega e non queres vincular coa recollida, déixao como predeterminado 3. Se queres enlazar con calquera pickup, pon a identificación desa parada de recollida |
| tipo_parada | corda | entrega | os valores deben ser a entrega e a recollida |
| enderezo | corda | Requírese o enderezo OU latitude,Lonxitude | |
| latitud | decimal | 0 | Requírese o enderezo OU latitude,Lonxitude |
| lonxitude | decimal | 0 | Requírese o enderezo OU latitude,Lonxitude |
| notas | corda | Detén a información relacionada | |
| parar_duración | int | 2 | Especifica a duración da parada en minutos, é dicir, canto tempo leva no sitio do cliente. |
| nome_cliente | corda | Información do cliente | |
| número_móbil_cliente | corda | Información do cliente | |
| customer_email | corda | Información do cliente | |
| enderezo_escrito | {} | {} | 1. Se stop_type é pickup, a clave é delivery_count e o valor está en int. O número total de entregas está ligado a esta recollida 2. se stop_type é a entrega déixao por defecto |
Obter información da ruta
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
}'
O comando anterior devolve JSON estruturado así:
{
"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
}
]
}
}
}
Información da ruta GET deste punto final.
Solicitude HTTP
GET {{base_url}}/api/v6/routes/:route_id
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| ruta_id | "" | ID de ruta que obtemos da lista de rutas |
| controlador_id | "" | Identificación do condutor da ruta |
Eliminar a ruta de entrega de recollida
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
}'
O comando anterior devolve JSON estruturado así:
{
"code": 200,
"status": true,
"message": "Route deleted successfully"
}
Este punto final elimina a ruta.
Solicitude HTTP
DELETE {{base_url}}/api/v6/routes/:route_id
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| ruta_id | "" | ID de ruta que obtemos da lista de rutas |
| controlador_id | "" | Identificación do condutor da ruta |
Obter información de ruta optimizada
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
}'
O comando anterior devolve JSON estruturado así se 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"
}
]
}
}
O comando anterior devolve JSON estruturado así se 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"
]
}
]
}
}
Información da ruta GET deste punto final.
Solicitude HTTP
GET {{base_url}}/api/v6/routes/:route_id/optimize_route
Parámetros de consulta
| Parámetro | defecto | descrición |
|---|---|---|
| chave_api | "" | Tecla de acceso API |
| controlador_id | "" | Identificación do condutor da ruta |
WebHooks
ZeoRoutePlanner permíteche usar o webhook, podemos notificarche sobre os eventos. Podes rexistrar un novo webhook na nosa plataforma ("https://zeorouteplanner.com/app/team/settings/genrate-token").
eventos
- Deter o progreso webhook
erros
A API de Zeo Route Planner usa os seguintes códigos de erro:
| Código de erro | Significado |
|---|---|
| 400 | Solicitude incorrecta: a túa solicitude non é válida. |
| 401 | Non autorizado: a túa clave API é incorrecta. |
| 404 | Non atopado: non se puido atopar a solicitude especificada. |
| 500 | Erro interno do servidor: tivemos un problema co noso servidor. Téntao de novo máis tarde. |
| 503 | Servizo non dispoñible: estamos temporalmente fóra de liña para realizar o mantemento. Por favor inténtao de novo máis tarde. |