# 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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken.wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idIdentificador único de la ruta en el sistema. 1382123
idrutaIdentificador único de la ruta que se va a utilizar para la programación de salida de ruta. 34534
idactivoIdentificador único del activo que realizará el recorrido de la ruta seleccionada. 245855
nombreNombre 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: ```shell 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: ```JSON { "status": 200, "data": "" } ```