Información
Contenido

Crear programación de ruta - programRoute

POST https://api.service24gps.com/api/v1/programRoute

Permite crear la definición o serie de puntos que conforman una ruta.

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
id

Identificador único de la ruta en el sistema.

 1382123
idruta

Identificador único de la ruta que se va a utilizar para la programación de salida de ruta.

 34534
idactivo

Identificador único del activo que realizará el recorrido de la ruta seleccionada.

 245855
nombre

Nombre con el que se identificará la ruta dentro de la plataforma.

 Prueba nombre ruta

definición

Definición de puntos.

{

   "distancia":80,
   "lugares":[

      {
           "id":"36589",
           "tipo":1,
           "orden":"1",
           "nombre":"Departamento 1",
           "dist_pa":0,
           "latLng":"18.900479,-98.435602",
           "fEstimada":"",
           "tolerancia":0,
           "timeBetween":0,
           "distLleg":0,
           "orientacion":""
       } ],
   "waypoints":[
    ],
   "puntos":[
    ],
   "rutas":[
    ],
   "sinoGarmin":0,
   "useRoutePlaces":0

}

fecha_inicio

Fecha en la que deberá iniciar la salida de ruta.

2022-02-27

hora_inicio

Hora en la que deberá iniciar la salida de ruta.

15:30:00

fecha_fin

Fecha en la que finalizará la ruta (se debe enviar vacío en caso de no utilizarlo).

2022-02-28

hora_fin

Hora en la que finalizará la ruta (se debe enviar vacío en caso de no utilizarlo).

20:00:00

dias

Días de la semana en que se ejecutará la salida de
ruta, los valores aceptados son: Lu, Ma, Mi, Ju, Vi.
Sa, Do; los días se separan con el signo “-”.

Lu-Mi-Vi-Sa

periodo

Periodo en que se reprogramará la ruta, los valores
aceptados son:
1 = Todos los días
2 = Todas las semanas
3 = Todos los meses
4 = Todos los años
5 = Continuamente

2

repetir

Indica la frecuencia de días, semanas, meses o años en que se debe repetir la ruta.

1

veces

Número de veces que se debe cumplir la ruta antes de finalizarla (enviar 0 en caso de no utilizarlo).

0

termina

Indica cuando se debe considerar la ruta como
finalizada. Los valores aceptados son:
1 = Nunca, la ruta se repite indefinidamente
2 = Después de n veces (la cantidad de repeticiones
se especifica en el parámetro anterior “veces”)
3 = Finaliza en una fecha y hora específica (la fecha
se indica en “fecha_fin” y “hora_fin”)
4 = Finaliza automáticamente al llegar al último
punto.

4

Nota: La definición debe tener el mismo formato que el utilizado en el método createRoute.

Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/programRoute' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'id="1382123"' \
--form 'idruta="34534"' \
--form 'idactivo="245855"' \
--form 'nombre="Prueba nombre ruta"' \
--form 'definicion="{"distancia":80,"lugares":[{"id":"36589","tipo":1,"orden":"1","nombre":"Departamento 1","dist_pa":0,"latLng":"18.900479,-98.435602","fEstimada":"","tolerancia":0,"timeBetween":0,"distLleg":0,"orientacion":""}],"waypoints":{},"puntos":{},"rutas":[],"sinoGarmin":0,"useRoutePlaces":0}"' \
--form 'fecha_inicio="2022-02-27"' \
--form 'hora_inicio="15:30:00"' \
--form 'fecha_fin=""' \
--form 'hora_fin=""' \
--form 'dias="Lu-Mi-Vi-Sa"' \
--form 'periodo="2"' \
--form 'repetir="1"' \
--form 'veces="0"' \
--form 'termina="4"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": ""
}
Volver arriba