Con este proyecto tendremos una app estilo Waze o como las indicaciones de Google Maps, así que es una app 100% práctica. Aquí haremos una app bastante completa pero perfectible de muchísimas maneras, siendo precisamente éste uno de los propósitos del curso. Conscientes de ello, esta versión es funcional pero no sobrecargada.
Esta app usa un Mapa como componente indispensable para mostrar la información. Un mapa es un contenedor bidimensional que muestra bloques de mapas, los cuales son subministrados por contribuyentes de OpenStreetMap y por el Servicio Geológico de los Estados Unidos. Al inicio de la app debemos especificar:
el medio de transporte, que puede ser: caminando, auto o bicicleta,
una posición de inicio, escribiendo una dirección o, si esperamos y desplazamos un breve momento, se entiende que es la ubicación actual.
una posición destino, escribiendo una dirección como texto.
Al dar clic después en el botón de búsqueda, si todo está correcto, aparece en el mapa la trayectoria encontrada de manera resaltada. En la parte inferior de la pantalla se indican la distancia (en km) del recorrido y una aproximación del tiempo (en minutos) del trayecto.
Si damos clic después en el botón de Detalles aparece otra ventana indicando los pasos a seguir para realizar el recorrido. Todo esto se lleva a cabo usando OpenStreetMap.
Diseño
A continuación mostramos (parte de) el diseño de la app:
Los componentes a usar son:
Una 'Tabla' con 4 renglones y dos columnas para leer los datos. Como es usual, la primera columna tiene los nombres de los datos y la segunda columna sirve para especificar cuales son estos datos. Así, esta tabla contiene:
Una 'Etiqueta', TransporteLbl, primer renglón, primera columna, cuyo texto sea 'Medio de transporte', abajo:
Una 'Etiqueta', InicioLbl, para especificar la dirección de inicio, abajo:
Una 'Etiqueta', DestinoLbl, para especificar la dirección de destino, abajo:
Un 'Botón', BuscaBoton, que al dar clic buscará la ruta para ir del Inicio al Destino, si es que todo está correcto. En la segunda columna:
Un (menú) 'Desplegable', menuTransporte, que nos permita elegir el medio de transporte que deseamos utilizar. Los valores que hemos puesto en la propiedad 'ElementosDesdeCadena' son: foot-walking, driving-car, cycling-regular. Estos tres valores se deben escribir tal cual, pues así los utiliza el componente Navigation, quien es el encargado de encontrar la ruta deseada. Abajo:
Un 'cuadro de texto', Inicio, para escribir la dirección de inicio del recorrido. Abajo:
Un 'cuadro de texto', Destino, para escribir la dirección destino. Abajo:
Un 'botón', Detalles, para que después de haber obtenido la trayectoria deseada escriba los detalles del viaje. Son como los 'Detalles' de Google maps. Después, afuera de esta tabla:
Un 'Mapa' para mostrar la trayectoria. Dentro del mapa ponemos un componente 'LineString' para mostrar en el mapa la trayectoria encontrada. En el Diseñador indicamos que aparezca centrado en el punto indicado en la propiedad 'CenterFromString', nosotros hemos puesto como valor las coordenadas 19.424265, -99.138432, que corresponden a la UACM, Centro Histórico. El nivel de detalle de cómo se presenta el Mapa se indica en la propiedad 'ZoomLevel'; nosotros hemos puesto su valor igual a 16 que es una resolución media; mientras más pequeño sea el valor tendrá más resolución pero se abarca menos territorio, consideramos que el valor 16 representa un valor intermedio.
Abajo del mapa otra tabla para mostrar los resultados de distancia, en kilómetros, y un aproximación del tiempo que emplearemos, en minutos. Es decir, tenemos:
Una 'tabla' de dos renglones y dos columnas. La primera columna contiene los nombres de los resultados y la segunda los dos resultados, precisamente. Son entonces cuatro 'Etiquetas' en sus cuatro casillas:
DistanciaLbl y TiempoLbl en donde está la explicación de los resultados, primera columna, y
Distancia y Tiempo en la segunda columna para mostrar los resultados.
Estos elementos son los que se muestran al inicio de la app, y también después de encontrar el camino deseado. Si queremos conocer los detalles del recorrido, dando clic en el botón Detalles, aparece una "segunda pantalla" mostrando estos pasos. En realidad no es una segunda pantalla, es la misma pantalla pero el truco consiste en poner las dos Tablas y el Mapa como 'no Visibles' y al mismo tiempo poner como 'Visibles' la Etiqueta que muestra los detalles así como el botón para "regresar" a la primera pantalla. Este es un "truco" muy útil cuando se quiere dar la impresión de presentar múltiples pantallas de una forma simple, Por consecuencia, también tenemos como componentes, después de los anteriores los siguientes:
Una 'Disposición vertical', DetallesDisposiciónVertical, que contiene dos componentes:
Una 'Etiqueta', DetallesLbl, para mostrar precisamente los pasos a seguir en el recorrido, y
Un 'Botón', RegresarBoton, para que al darle clic "regrese" a la "pantalla" anterior. Finalmente, pero no menos importante:
Un 'componente de navegación', Navigation1, componente no-visible. El componente de Navegación genera direcciones entre dos ubicaciones utilizando un servicio llamado OpenRouteService. Se debe proporcionar una clave API válida para que este componente funcione.
Un componente 'LineString', dentro del componente de Mapas, que nos sirve para dibujar la trayectoria encontrada sobre el mapa y, finalmente:
Un 'sensor de ubicación', componente no-visible que sirve para encontrar la latitud y longitud de una dirección dada como texto de inicio o final del recorrido, o también para encontrar nuestra ubicación actual, si es que se desea.
Explicaremos los bloques de acuerdo al orden de su uso:
El medio de transporte se indica mediante el menú desplegable. Al seleccionarlo, se dispara el evento 'DespuésdeSelecionar' y dentro de este evento debemos poner el medio de transporte adecuado en la propiedad 'TransportationMethod' del componente Navigation1, quien será el encargado de buscar el trayecto deseado. Los valores que necesariamente puede tener la propiedad 'TransportationMethod' son, textualmente: foot-walking, driving-car, cycling-regular. Así que lo más fácil es poner el valor de la propiedad 'ElementosDesdeCadena' del menú desplegable igual a foot-walking,driving-car,cycling-regular.
Especificación de las direcciones inicial y final del recorrido
Se deben especificar las direcciones inicial y final. Para la dirección de Inicio, se puede esperar unos instantes a que el sensor tome la ubicación actual como el inicio, o bien se puede escribir una posición inicial.
Para el caso del destino se debe proporcionar una dirección final.
Hablar de la API de OpenRoute.
El proceso más importante de esta aplicación es obtener la trayectoria (o direcciones) para llegar de un origen a un destino. Este proceso lo realiza el componente 'Navigation' usando un servicio llamado OpenRouteService y se debe proporcionar una llave API válida para que este componente funcione. Para solicitar la llave se debe ir a la página https://openrouteservice.org. Una vez ahí se crea una cuenta (si es que no se tiene una), se identifica el usuario y se solicita un token , se debe indicar el tipo Free y ponerle un nombre arbitrario. Después de dar clic en el botón Create token se nos proporciona una llave para poder utilizar el servicio. No debemos recordar la llave pues se queda registrada en nuestra cuenta, pero este valor es el que debemos de copiar y pegar en la propiedad 'ClaveAPI' del componente de Navegación1 en el Diseñador, puesto que esta llave permanecerá fija en nuestra app.
El componente de Navegation1 se ejecuta cuando damos clic al botón de 'Busca ruta' quien llama al método 'RequestDirections' de Navegation1. Para que este método funcione se deben haber proporcionado antes la llave (una sola vez pues es constante) y las direcciones inicial y final del trayecto. Se debe proporcionar también el medio de transporte a utilizar y las coordenadas del Inicio y Destino.
Para cuando se haya escrito una dirección de inicio y para la dirección destino se deben buscar la latitud y longitud a partir de una dirección de texto. Sabemos que estamos en este caso si se ha especificado un inicio (el texto no está vacío) y este texto no contiene una coma (pues en este caso ya están especificadas las coordenadas). Para encontrar la latitud de la dirección inicial proporcionada como texto se usa el método 'LatitudDeLaDireccion' del sensor de ubicación con el texto de Inicio como 'nombreDeUbicación'. Para encontrar la longitud de la dirección inicial proporcionada como texto se usa el método 'LongitudDeLaDireccion' del sensor de ubicación con el texto de Inicio como 'nombreDeUbicación'. Lo mismo se hace para encontrar las coordenadas correspondientes al destino.
Tanto la Latitud como la Longitud iniciales se usan para que el mapa quede centrado en la dirección inicial. invocando al método 'PanTo' del mapa con la latitud y longitud del Inicio. En 'PanTo' se pone el valor del 'zoom' igual a 16 que es un valor intermedio.
Finalmente, habiendo especificado estos cuatro valores se invoca al método 'RequestDirections', quien, si tiene éxito en encontrar la trayectoria activará al evento 'GotDirections', mientras que si ocurre un error, éste será reportado mediante el evento 'ErrorOcurred´de la Pantalla:
Si sucede que la trayectoria ha podido ser encontrada (puede no encontrarse si alguna dirección especificada no ha podido localizarse) esta trayectoria se visualizará en el mapa durante la ocurrencia del evento 'GotDirections' de Navigation1. Ahí, los puntos de la trayectoria están almacenados en la variable local 'points' y se trata de una lista App Inventor de listas de dos componentes de la forma [latitud, longitud] cada uno de los puntos del trayecto encontrado. A su vez, estos puntos se ponen como el valor de la propiedad 'Points' del componente LineString1 para que la ruta quede especificada en el mapa.
También se pone la distancia del recorrido (en kilómetros) dividiendo el valor de la variable local 'distancia' entre 1000, y el tiempo estimado del recorrido (en minutos) dividiendo el valor de la variable local 'duration' entre 60.
Los detalles del recorrido vienen dados en la variable local 'directions' y se almacenan en la variable global 'ListaDeDetalles' para poder ser mostrados si se solicita esto.
Si el usuario desea ver los detalles del camino, dará clic al botón 'Detalles'. Para lograr que los detalles de la trayectoria se muestren en "otra pantalla" lo que necesitamos es poner los componentes que hemos utilizado hasta aquí, es decir, 'DatosTabla', 'Mapa' y 'ResultadosTabla' como no visibles, mientras que el componente de la "segunda pantalla" que es 'DetallesDisposiciónVertical' se pone como visible. A su vez, el componente 'DetallesDeDisposiciónVertical' tiene dos componentes: una etiqueta 'DetallesLbl' en donde se escribirán los detalles del trayecto y un botón para "regresar" a la primera pantalla.
Recordemos que la lista de detalles se ha almacenado en la variable global llamada precisamente 'ListaDeDetalles' y para presentar estos pasos de manera elegante se va tomando cada paso y poniendo entre ellos un cambio de línea, concatenando estos textos en la etiqueta 'DetallesLbl'.
Por último, al dar clic en el botón de 'Regresar', activamos la primera pantalla y desactivamos la segunda, haciendo visibles los tres componentes iniciales y poniendo no visible el componente 'DetallesDeDisposiciónVertical', así:
Para terminar se muestra un ejemplo de ejecución, con sus dos pantallas de resultado: