Introducción.
Últimamente he tenido ganas de desarrollar en C# para retomar este lenguaje que tengo un poco abandonado y al mismo tiempo probar los avances que ha tenido el proyecto Mono. Que mejor inicio que desarrollar una aplicación muy simple para georreferenciar ciudades aprovechando el servicio web de Geonames, esta a su vez me servirá para complementarla y solucionar un problema de información que tengo para otro proyecto.
Como se podrá apreciar, el código es muy sencillo ya que no utilizo ninguna librería adicional a las estándar, sin embargo es interesante y puede serle de utilidad a alguien mas.
Cuál es la necesidad ?
El problema que se tiene es la necesidad de georreferenciar ubicaciones, es decir, conociendo su nombre obtener su ubicación en términos de latitud y longitud.
Si estoy en Manizales, Caldas, Colombia estaré realmente en latitud 5.07, longitud -75.52056.
Es necesario tener en cuenta que muchas veces el servicio de georreferenciación retorna múltiples resultados ya que pueden haberse referenciado varios sitios con el mismo nombre, haberse cambiado el nombre de la ubicación o tenerse varios hitos de diferente nivel administrativo. En Geonames esto último se identifica mediante los campos de características. Consulte el sitio web de Geonames para mas información acerca de los feature codes.
Cómo es el servicio web ?
El servicio web de búsquedas de Geonames recibe una cadena de texto con la ubicación que se desea georreferenciar y retorna una cadena de texto en formato XML (en este caso) con los resultados obtenidos.
Por ejemplo, la consulta de Manizales, Caldas, Colombia se realizaría a través del siguiente URL.
http://ws.geonames.org/search?lang=es&type=xml&style=FULL&q=Manizales,Caldas,Colombia
Retornará el siguiente resultado.
<geonames style="FULL">
<totalResultsCount>2</totalResultsCount>
<geoname>
<toponymName>Manizales</toponymName>
<name>Manizales</name>
<lat>5.07</lat>
<lng>-75.52056</lng>
<geonameId>3675443</geonameId>
<countryCode>CO</countryCode>
<countryName>Colombia</countryName>
<fcl>P</fcl>
<fcode>PPLA</fcode>
<fclName>city, village,...</fclName>
<fcodeName>seat of a first-order administrative division</fcodeName>
<population>357814</population>
<alternateNames>Manisales,Manisalesas,Manizales,Манисалес</alternateNames>
<elevation/>
<continentCode>SA</continentCode>
<adminCode1>37</adminCode1>
<adminName1>Caldas</adminName1>
<adminCode2/>
<adminName2/>
<alternateName lang="en">Manizales</alternateName>
<alternateName lang="pl">Manizales</alternateName>
<alternateName lang="lt">Manisalesas</alternateName>
<alternateName lang="bg">Манисалес</alternateName>
<alternateName lang="cs">Manizales</alternateName>
<alternateName lang="link">http://en.wikipedia.org/wiki/Manizales</alternateName>
<alternateName lang="de">Manizales</alternateName>
<alternateName lang="sv">Manizales</alternateName>
<alternateName lang="es">Manizales</alternateName>
<alternateName lang="no">Manizales</alternateName>
<alternateName lang="pt">Manizales</alternateName>
<timezone dstOffset="-5.0" gmtOffset="-5.0">America/Bogota</timezone>
<score>1.0</score>
</geoname>
<geoname>
<toponymName>Manizales</toponymName>
<name>Manizales</name>
<lat>5.08333</lat>
<lng>-75.5</lng>
<geonameId>3675444</geonameId>
<countryCode>CO</countryCode>
<countryName>Colombia</countryName>
<fcl>A</fcl>
<fcode>ADM2</fcode>
<fclName>country, state, region,...</fclName>
<fcodeName>second-order administrative division</fcodeName>
<population/>
<alternateNames/>
<elevation/>
<continentCode>SA</continentCode>
<adminCode1>37</adminCode1>
<adminName1>Caldas</adminName1>
<adminCode2>3675444</adminCode2>
<adminName2>Manizales</adminName2>
<timezone dstOffset="-5.0" gmtOffset="-5.0">America/Bogota</timezone>
<score>0.3448537290096283</score>
</geoname>
</geonames>Finalmente la tarea de la aplicación que consuma el servicio será procesar el documento XML y obtener la información que necesite.
Cómo es la implementación ?
Las librerías (namespaces) utilizados son los siguientes.
using System; using System.Net; using System.Text; using System.Xml; using System.Collections.Generic;
Se prepara el URL para consumir el servicio con la ubicación a geocodificar. En este caso, especifico una por defecto si no suministra una.
string location = (args.Length == 0) ? "Manizales, Caldas, Colombia" : args[0]; string url = "http://ws.geonames.org/search?lang=es&type=xml&style=FULL&q=" + location;
Se consume el servicio web y se obtiene la cadena de texto con la respuesta en formato XML.
WebClient client = new WebClient(); string xml = client.DownloadString(url);
Se crea un objeto para manipular el documento XML recién recibido, se obtienen los nodos relacionados con la respuesta de la georreferenciación (geoname) y se verifica que haya registros, de lo contrario no habrá nada que hacer.
XmlDocument doc = new XmlDocument();
doc.LoadXml(xml);
XmlNodeList geonames = doc.GetElementsByTagName("geoname");
if(geonames.Count == 0)
throw new Exception("There is no geonames in the result!");
else
Console.WriteLine("I found " + geonames.Count + " places!\n");
Se recorren los resultados obtenidos extrayéndoles la información georreferenciada que se requiera.
foreach(XmlElement place in geonames)
{
Console.WriteLine("* LUGAR: " + place["name"].InnerText + "\n");
Console.WriteLine("\tNombre: " + place["name"].InnerText);
Console.WriteLine("\tDepartamento: " + place["adminName1"].InnerText);
Console.WriteLine("\tLatitud: " + place["lat"].InnerText);
Console.WriteLine("\tLongitud: " + place["lng"].InnerText);
Console.WriteLine("\tPaís: " + place["countryName"].InnerText +
" (" + place["countryCode"].InnerText + ")");
Console.WriteLine("\tPoblación: " + place["population"].InnerText + " habitantes");
Console.WriteLine("\tPaís: " + place["countryName"].InnerText +
" (" + place["countryCode"].InnerText + ")");
Console.WriteLine("\tCaracterísticas: " + place["fcl"].InnerText + "/" + place["fcode"].InnerText +
"> " + place["fclName"].InnerText + " (" + place["fcodeName"].InnerText + ")");
Console.WriteLine();
}
Cómo construyo el programa ?
Si se utiliza VisualStudio/MonoDevelop sólo es necesario abrir la solución (incluída en el paquete de demostración) y ejecutar el comando de Build o Run del menú.
Si se desea realizar manualmente deberá ejecutarse un comando como el siguiente.
$ gmcs "/out:GeoCoderSimple.exe" "/r:/usr/lib/mono/2.0/System.dll" "/r:/usr/lib/mono/2.0/System.Xml.dll" /t:exe "geonames_search_raw/Main.cs"
Donde geonames_search_raw/Main.cs es el código fuente de la aplicación y GeoCoderSimple.exe será el archivo binario resultante.
Cómo ejecuto el ejemplo ?
Ya sea invocándolo desde el IDE o desde línea de comando, el programa recibe un argumento. En caso de obviarse este argumento se utilizará el valor por defecto.
$ ./GeoCoderSimple.exe
I found 2 places! * LUGAR: Manizales Nombre: Manizales Departamento: Caldas Latitud: 5.07 Longitud: -75.52056 País: Colombia (CO) Población: 357814 habitantes País: Colombia (CO) Características: P/PPLA> city, village,... (seat of a first-order administrative division) * LUGAR: Manizales Nombre: Manizales Departamento: Caldas Latitud: 5.08333 Longitud: -75.5 País: Colombia (CO) Población: habitantes País: Colombia (CO) Características: A/ADM2> country, state, region,... (second-order administrative division)
Enlaces.
- Geonames.
http://www.geonames.org/- Search Web Service.
http://www.geonames.org/export/geonames-search.html
- Search Web Service.
- Código fuente de la aplicación de ejemplo (C#/Mono/MonoDevelop).
http://demo.jorgeivanmeza.com/NET/GeonamesSearchRaw/
