AstronomyLib Part 2
Um die Bibliothek zielführend einsetzen zu können, benötigen wir des weiteren einen Webservice mithilfe dessen wir die Koordinaten ( Latitude und Longitude ) ermitteln. Diese Daten holen wir uns vom Webservice Yahoo GeoCode.
Bevor wir nun aber zur Tat schreiten können um Daten von dem Dienst Yahoo GeoCode zu erhalten, müssen wir einen Developer Account bei Yahoo einrichten. Dies ist relativ unkompliziert und kostet auch nichts, ist dieser Account nun erstellt, müssen wir einen APP ID Code für unsere Abfragen beantragen. Mit diesem Code ist es möglich 50.000 Abfragen pro Tag auf obgenannten Service zu machen.
Die Abfrage für einen bestimmten Ort des GeoCode Service ist ein Uri in dem die Parameter der Abfrage integriert sind.
z.B.: für Graz : http://local.yahooapis.com/MapsService/V1/geocode?appid=XYZ…….&city=Graz .
Für diesen Zweck erstellen wir uns eine statische Klasse die die Abfragen mittels einem System.Net.WebClient löst. Der zurückgegeben Wert einer solchen Abfrage ist ein XML Fragment mit den entsprechenden Elementen und Attributen also Werten.
Auch für die Rückgabewerte erstellen wir uns eine Klasse die diese Eigenschaften kapselt um sie nachher komfortabel in der Anwendung nutzen zu können.
ACHTUNG !
Der Code enthält keinerlei Fehlerbehandlungsroutinen und blockiert die Oberfläche der Anwendung (wegen dem direkten Aufruf des WebClients aus dem UIThread !) , es soll lediglich die Vorgehensweise verdeutlicht werden. Diese Vorgehensweise entspricht keinesfalls irgendwelchen Design Richtlinien.
Die statische Klasse YahooGeoCodeAPIWrapper :
- public static class YahooGeoCodeAPIWrapper
- {
- /// <summary>
- /// Gets the geo data for the given city name.
- /// </summary>
- /// <param name="API_CODE">The API CODE.</param>
- /// <param name="CityName">Name of the city.</param>
- /// <returns></returns>
- public static YahooGeoCodeResult GetGeoDataForCityName(string API_CODE, string CityName)
- {
- using (WebClient client = new WebClient())
- {
- // Abfrage Uri erstellen ...
- string uri = "http://local.yahooapis.com/MapsService/V1/geocode?appid=" + API_CODE + "&city=" + CityName;
- byte[] bytes = client.DownloadData(uri);
- return new YahooGeoCodeResult(Encoding.ASCII.GetString(bytes));
- }
- }
- }
-
Die Klasse die die Ergebnisse der Abfrage kapselt :
- /// <summary>
- /// Stellt eine Antwort auf eine Abfrage des Yahoo GeoCode Webservices dar.
- /// </summary>
- public sealed class YahooGeoCodeResult
- {
- #region ctor
- public YahooGeoCodeResult(string xmlfragment)
- {
- XmlDocument doc = new XmlDocument();
- doc.LoadXml(xmlfragment);
- Latitude = Double.Parse(doc.DocumentElement.ChildNodes[0].ChildNodes[0].InnerText );
- Longitude = Double.Parse(doc.DocumentElement.ChildNodes[0].ChildNodes[1].InnerText );
- City = doc.DocumentElement.ChildNodes[0].ChildNodes[3].InnerText;
- State = doc.DocumentElement.ChildNodes[0].ChildNodes[4].InnerText ;
- }
- #endregion
- #region props
- public double Latitude { get; set; }
- public double Longitude { get; set; }
- public string State { get; set; }
- public string City { get; set; }
- #endregion
- }