Manual de usuario jRutAppGraph

Alumno:

Antonio Feregrino Bolaos

Asignatura: Programacin Orientada a Objetos Escuela: Escuela Superior de Cmputo Profesor: Roberto Tecla Parra

Antonio Feregrinio Bolaos

jRutAppGraph

Manual de usuario
Introduccin

jRutAppGraph es un sistema para calcular las rutas ptimas entre dos puntos en la ciudad a travs del diversos sistemas de transporte colectivo. Para esto hace uso de informacin pblica tal como: la distancia entre estaciones de un mismo servicio, la velocidad promedio del transporte y la ubicacin geogrfica de las estaciones.

Implementacin

jRutAppGraph presta sus servicios a travs de un servicio web, montado en un servidor, como puede ser Glassfish o Apache. Por el momento el API est muy limitada pudiendo solo consultar una sola ruta entre dos puntos.

Proyecto Final, Programacin orientada a objetos.

ESCOM

Antonio Feregrinio Bolaos

jRutAppGraph

Forma de uso

Para consumir la informacin otorgada por jRutAppGraph es necesario realizar una peticin al servidor en el que este se encuentra montado. Para el ejemplo usaremos un navegador, sin embargo, puedes visitar el enlace http://bit.ly/RutAppDF8 para ver un ejemplo de lo que actualmente se puede hacer con la aplicacin.

Parmetros de entrada

Como ya se mencion antes, la aplicacin nos ayuda a encontrar rutas entre dos puntos, para lo cual es necesario alimentar al sistema con dichos puntos. Al funcionar con informacin geoespacial hay una forma peculiar de enviar los parmetros (se usa GET para recogerlos en el servidor). Siendo el parmetro origen y destino una composicin de dos nmeros punto flotante separados por comas: origen=19.341172,-99.137517 y destino=19.439642,-99.192651

Como se muestra en la imagen:

Proyecto Final, Programacin orientada a objetos.

ESCOM

Antonio Feregrinio Bolaos

jRutAppGraph

Al hacer la peticin el sistema procesar la solicitud y le mostrar los datos que correspondan a su peticin.

Entendiendo las respuestas:

Al terminar de calcular y evaluar su peticin, el sistema puede entregarle dos tipos de respuesta, una de xito (en cuyo caso contendr el valor true en la propiedad success)

Respuesta exitosa En caso de que la respuesta sea exitosa, el sistema desplegar la informacin de la siguiente manera:
{ "success": true, "rutaTiempo": { "estaciones": [ { "id": "_UserStart_", "nombre": "Inicio usuario", "latitud": 19.341172, "servicio": "USR", "longitud": -99.137517}, {},{},{},{},{}, // Conjunto de otros objetos del tipo estacin { "id": "JOAMTRX7", "nombre": "San Joaqun", "linea": "7", "latitud": -99.1917, "servicio": "MTR", "longitud": 19.4458 }, { "id": "_UserFinish_", "nombre": "Final usuario", "latitud": 19.439642, "servicio": "USR",

Proyecto Final, Programacin orientada a objetos.

ESCOM

Antonio Feregrinio Bolaos

"longitud": -99.192651 } ], "metros": 16923.739438380948, "costo": 6, "transbordos": 2, "tiempo_estimado": 2931.862581592861, "estaciones_ct": 25, "estaciones_st": 23 } }

jRutAppGraph

En donde: success indicando que la peticin fue exitosa. rutaTiempo es un arreglo de objetos estacion y contiene las estaciones por las que la ruta fue ubicada. metros es la cantidad de metros que recorre esa ruta. costo es el costo en monetario de la ruta. transbordos es la cantidad de transbordos que se hacen a usar la ruta. tiempo_estimado es el tiempo estimado en segundos que se hace al usar la ruta. estaciones_ct transbordos. estaciones_st el nmero total de estaciones que se recorren, sin transbordos. el nmero total de estaciones que se recorren, contando

Respuesta no exitosa En caso de que el sistema detecte algn fallo le notificar al usuario de la siguiente manera:
{ "success": false, "error": "No encontr estaciones cercanas a tu origen" }

Proyecto Final, Programacin orientada a objetos.

ESCOM

Antonio Feregrinio Bolaos En donde: success indicando si la peticin fall. error el detalle de por qu la peticin fall. Entre los mensajes de error estn:
"No encontr estaciones cercanas a tu origen" "No encontr estaciones cercanas a tu destino"

jRutAppGraph

"Al parecer no hay un camino entre [estacin origen] y [estacin destino]"

Proyecto Final, Programacin orientada a objetos.

ESCOM

Antonio Feregrinio Bolaos

jRutAppGraph

Contacto

Para cualquier duda y/o aclaracin, estoy a su disposicin en la cuenta de correo: antonio.feregrino@gmail.com o en la pgina web http://rutapp.azurewebsites.net

Proyecto Final, Programacin orientada a objetos.

ESCOM