Demostración de georreferenciación al estilo web 2.0
Desarrollo de software, Internet, Software geográfico September 9th, 2008
No es que me sienta viejo aún, pero como me hubiera gustado que como ahora, hubieran existido tantas cosas y que hubieran estado al alcance de los desarrolladores cuando yo era estudiante hace un tiempo ya. Gloriosa época de muchas trasnochadas expermientando cositas, en particular con Java.
Desafortunadamente, en mi época de estudiante me tocó un mundo no tan interesante como el actual, ya que empezamos con C/C++ para MS-DOS y en esa época el reto adicional era mostrar imágenes en los programas y simular el ambiente 3D de ventanas con sólo las líneas y cuadrados del BGI 
Java llegó después y me tocó la época en que todos estabamos aprendiendo y las cosas emocionantes empezaron a llegar con el tiempo y con Internet. Recuerdo que ya terminando mis clases, cuando abrí mis primeras direcciones de correo en USA.net y Hotmail, mis compañeros estuvieron renuentes por un buen tiempo porque no le veían la utilidad al correo electrónico o simplemente porque no tenían quien les escribiera. Pero por suerte ya todo eso pasó.
Ahora hay muchas cosas, tantas que no alcanza el tiempo para buscarlas, estudiarlas y hacer algo con ellas. Inclusive hay muchas cosas del mismo estilo. Todo un mundo de delicias para escoger. Lo que falta es tiempo. El trabajo y el cansancio son malos amigos para la investigación. Ahora, donde uno mire, hay cosas para probar y lo mejor de todo es que la mayoría son abiertas y grátis ... digo libres (free), el límite es el tiempo y la pereza mental de las personas.
Hoy, a pesar de que tengo muchos informes atrasados, me dieron ganas de hacer una aplicación muy sencilla para demostrar un par de estas librerías que están allí, esperando que hagamos algo interesante con ellas. Este ejemplo muy simple me tomó al rededor de 2 horas implementarlo y eso porque son muy lento para hacer las interfaces de usuario desde código.
Así surgió la demostración de georreferenciación al estilo web 2.0 que permite visualizar el mapa de cualquier ubicación del mundo y ubicar sobre él marcadores georreferenciados.
Para esto utiliza los servicios de Google Maps para la generación de las imágenes y GeoNames para la georreferenciación, es decir, para convertir las ubicaciones (Manizales, Caldas, Colombia) en sus respectivas duplas latitud/longitud para poder ser relacionadas geográficamente.
En la parte izquierda se aprecia la lista con las ubicaciones seleccionadas que corresponden con las marcas rojas en el mapa, en la parte derecha está el mapa junto con tres barras de desplazamiento que regulan su presentación y en la parte inferior se encuentran los botones de opciones.
El demo le permite al usuario Agregar y Remover ubicaciones como puntos seleccionados. Como se mencionó, estas se ingresan con los nombres de las ubicaciones y el sistema obtiene su ubicación geográfica a través de la consulta de un servicio web. Es posible en cualquier momento, Centrar el mapa al rededor de cualquiera de los puntos seleccionados almacendos.
La manipulación del mapa se realiza con las barras de desplazamiento. La naranja (derecha) corresponde con el zoom: hacia abajo aumenta, haciendo mayor el acercamiento del mapa. La horizontal, azul, corresponde con la longitud y la vertical, verde, corresponde con la latitud. Cuando se modifica cualquiera de estos valores se deberá solicitar la actualización del mapa presionando el botón Refrescar.
La aplicación ha sido desarrollada en Java por lo que su código es muy claro y modular. En términos de la implementación, el acceso al webservice de GeoNames utiliza su propio API para el cual se descargaron dos archivos: geonames-1.0-java5.jar y jdom-1.0.jar.
La georrefernciación no podría ser más fácil.
public static GeoLocation locate(String location) throws Exception { GeoLocation result = new GeoLocation(); // Creates the toponym searcher ToponymSearchCriteria searchCriteria = new ToponymSearchCriteria(); // Sets the criteria based on the specified location searchCriteria.setQ(location); // Request the geolocalization to the webserver ToponymSearchResult searchResult = WebService.search(searchCriteria); // Gets the results List toponyms = searchResult.getToponyms(); // Checks if there were results if(toponyms == null || toponyms.size() == 0) return null; // Gets the first result of all (could be many) Toponym first = toponyms.get(0); // Prepares the result with its information result.put("geoNameId", first.getGeoNameId() + ""); result.put("name", first.getName() + ""); result.put("latitude", first.getLatitude() + ""); result.put("longitude", first.getLongitude() + ""); result.put("countryCode", first.getCountryCode() + ""); result.put("countryName", first.getCountryName() + ""); return result; }
La clase GeoLocation que utilizo para manejar el resultado no es mas que un Hashtable<String, String> con algunos adendos para facilitar su uso.
Por otro lado, la generación del mapa requiere aún menos ciencia aunque la realizo en dos pasos discretos que en general no incluyen nada extraño.
public String prepareUrl() { String markers = ""; // Walks thru all the points to create its markers for(int i=0; i <points.size(); i++) { // Reads the points one by one GeoLocation point = points.elementAt(i); // The markers will be green String color = "green"; // Sets the point location information based on its longitude and latitude String pointLocation = point.get("latitude") + "," + point.get("longitude") + "," + color + point.get("name").toLowerCase().charAt(0); // Adds it to the markers accumulator markers += pointLocation + ((i < points.size() - 1) ? "%7C" : ""); } // Prepares the full URL based on markers information, centered location, size, zoom and API key String url = "http://maps.google.com/staticmap?" + "center=" + centerLatitude + "," + centerLongitude + "&" + "markers=" + markers + "&" + "zoom=" + zoomLevel + "&" + "size=" + sizeWidth + "x" + sizeHeight + "&" + "key=" + apiKey; // System.out.println(url); return url; }
En el primer paso preparo el URL del consulta al servicio basado en información como la coordenada centro del mapa, el nivel de zoom, el tamaño de la imagen, los puntos seleccionados (marcadores) y la llave del API que debe ser privada y es única para cada sitio web (FQDN), aunque para el caso específico de aplicaciones de escritorio no es muy relevante a pesar de ser obligatoria. La llave del API puede ser obtenida de manera gratuita por cualquier desarrollador desde esta dirección.
public Image prepareImage(String url) throws Exception { Image image = ImageIO.read(new URL(url)); return image; }
El segundo paso se relaciona con consultar el servicio de Google utilizando el URL recién generado, leer los bytes que conforman la imagen y crear con ellos un objeto Image para ser mostrado posteriormente en la interfaz de usuario. Con Java, este procedimiento es extremadamente sencillo: 1 línea de código.
Para su uso se deberá tener cuidado en el manejo de las posibles excepciones que pueda lanzar el requerimiento como por ejemplo, producto de un fallo de red.
// Gets the map image Image imageMap = mapService.getMap(); // Checks if was received if(imageMap == null) { JOptionPane.showMessageDialog(this, "El mapa no se pudo recuperar.", "Error recuperando mapa", JOptionPane.ERROR_MESSAGE); return; } // Puts the map on the gui map.setIcon(new ImageIcon(imageMap));
Teniendo el objeto Image lo podemos poner en cualquier componente de AWT/Swing. Por facilidad, yo utilizo un JLabel que incluye el soporte de íconos (ImageIcon) los cuales se basan en objetos de imagen.
Como se puede apreciar, la complejidad de la aplicación es muy baja por lo que reitero: la imaginación es el límite.
Es posible acceder a la aplicación desde web sin instalar ningún archivo local desde el siguiente enlace o ejecutando el siguiente comando en una consola/símbolo del sistema operativo:
$ javaws http://demo.jorgeivanmeza.com/Java/DemoGeoReferenceMap/0.1/DemoGeoReferenceMap.jnlp
Enlace:
- Código fuente y binario de la aplicación de demostración (incluye librerías de GeoNames requeridas).
Tags: GeoNames, GIS, GoogleMaps, Java
Loading ...