Kurs Python richtig lernen/Webservices: Unterschied zwischen den Versionen

Aus Geoinformation HSR
Wechseln zu: Navigation, Suche
K
 
(14 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
Zurück zum [[Kurs Python richtig lernen#Uebungen]].
 +
 
== Übung "Web Services mit Python" ==
 
== Übung "Web Services mit Python" ==
  
−
In dieser Übung lernen Sie die Verwendung von Web Services mit Python kennen. Wir verwenden dazu [http://wiki.openstreetmap.org/wiki/Nominatim Nominatim], einen Web service zur Geokodierung von OSM-Daten (Open Streetmap).  
+
In dieser Übung lernen Sie die Verwendung von Webservices (Web Services) mit Python kennen. Wir konzentrieren uns hier auf Clients und verwenden dazu den Webserver 'Nominatim' zur Geokodierung (bzw. "Reverse Geocodierung") von OpenStreetmap-Daten (OSM = Abk. für OpenStreetmap).
  
 
Geschätzter Zeitaufwand für diese Übung: ca. '''1h'''.
 
Geschätzter Zeitaufwand für diese Übung: ca. '''1h'''.
  
−
=== Web-Service Kennenlernen mit cURL ===
+
== Webservice kennenlernen mit cURL ==
 +
 
 +
In dieser Übung machen ein sog. "Reverse Geocoding", d.h. gegeben eine Koordinate wird die räumlich nächstgelegene Adresse oder der nächstgelegene Name gesucht.
 +
 
 +
Zunächst probieren wir ein Software-Client aus namens cURL ('cörl'), das ganz ohne Python auskommt. cURL ist ein Kommandozeilen-Werkzeug, mit dem Daten über eine Internetadresse herunter- und hochgeladen werden können. Es unterstützt zahlreiche Internetprotokolle u.a. auch das HTTP-Protokoll ("HTTP GET Request"). Es ist bei den meisten Linux dabei; für Windows muss es separat installiert werden. Wir verwenden es hier um uns ohne Programmieraufwand mit der Funktionsweise von Webservices bekannt zu machen. Als Dokumentation dient die [http://curl.haxx.se/docs/manpage.html Manualseite (manpage) von cURL].
 +
 
 +
Als Webservice verwenden wir 'Nominatim', der auch in der Suche auf der OpenStreetMap Homepage verwendet wird. Nominatim (lateinisch für "namentlich") ist ein Werkzeug, um in OpenStreetMap (OSM) über den Namen und Adresse nach OSM-Objekten zu suchen. Die freie Webapplikation kann mit dem Browser auch direkt verwendet werden: http://nominatim.openstreetmap.org .
 +
 
 +
Der Webservice Nominatim lässt sich über HTTP ansprechen. Als Antwort-Datenformat (response) kennt Nominatim JSON, HTML und XML. Wir verwenden JSON und damit dieses auf der Konsole ansprechend formatiert wird, verwenden wir als pretty printer das JSON Python Modul [http://docs.python.org/library/json.html json]. Hier ein Beispiel wie dieses verwendet werden kann:
 +
 
 +
curl [options] [URL...] | python -mjson.tool
 +
 
 +
''Tipp 1'': Verwenden Sie die Option ''-v'' (verbose), um genau zu sehen, wie der Request an den Webservice aussieht. Das hielft beim Debugging enorm.
  
−
==== Einführung ====
+
''Tipp 2'': Da das manuelle Erzeugen eines korrekten Weblinks (sog. "URL encoded query strings") an den Webservice etwas mühsam ist, können Sie cURL anweisen, mit Hilfe des Parameters ''--data-urlencode'' dies zu übernehmen. Beispiel (Verwendung von ''-G'' für einen HTTP GET Request):
−
cURL ist ein Werkzeug, mit dem Daten über eine Internetadresse herunter-/ und hochgeladen werden können. Es unterstützt zahlreiche Internetprotokolle wie HTTP, FTP, LDAP etc. Wir verwenden es hier, um uns ohne Programmieraufwand mit der Funktionsweise des Web Services bekannt zu machen. Als Dokumentation dient die [http://curl.haxx.se/docs/manpage.html Manpage von cURL].
 
  
−
Da wir in dieser Übung den Web Service mit JSON als Datenformat verwenden (Nomatim unterstützt auch HTML und XML) und dieses auf der Konsole ansprechend formatiert haben möchten, verwenden wir als pretty printer das JSON Python Modul. Hier ein Beispiel wie dieses verwendet werden kann:
+
curl -G --data-urlencode "key=some value" http://hsr.ch/pythonrichtiglernen
  
−
<code>
+
cURL macht daraus dann einen korrekten Aufruf ("GET Request") an http://hsr.ch/pythonrichtiglernen/?key=some%20value (man beachte "20%").
−
curl [options] [URL...] | python -mjson.tool
 
−
</code>
 
  
−
Tip 1: Verwenden Sie die Option ''-v'' (verbose), um genau zu sehen, wie der Request an den Web Service aussieht. Das hielt beim Debugging enorm.
+
Die Dokumentation der Webservice API von Nominatim finden Sie [http://wiki.openstreetmap.org/wiki/Nominatim#Parameters hier].
−
Tip 2: Da das manuelle Erzeugen des URL encoded query strings an den Web Service URL etwas mühsam ist, können Sie cURL anweisen dies zu übernehmen mit Hilfe des Parameters "--data-urlencode". Beispiel (-G für einen HTTP GET Request):
 
  
−
<code>
+
=== Aufgabe 1 "Reverse Geocoding" ===
−
curl -G --data-urlencode "key=v a l u e" http://hsr.ch/pythonrichtiglernen
 
−
# cURL macht daraus dann einen GET Request an http://hsr.ch/pythonrichtiglernen/?key=v%20a%20l%20u%20e
 
−
</code>
 
  
−
Die Dokumentation der Web Service API von Nomatim finden Sie [http://wiki.openstreetmap.org/wiki/Nominatim#Parameters hier].
+
1a. Finden Sie mit cURL und Nominatim den Längen- und Breitengrad der HSR (Oberseestrasse 10, 8640 Rapperswil).
  
−
==== Aufgabe ====
+
1b. Nehmen Sie den gefundenen Längen- und Breitengrad und überprüfen Sie mit cURL, ob Nominatim Ihnen die richtige Adresse der HSR liefert.
−
# Finden Sie mit cURL und Nomatim den Längen- und Breitengrad der HSR (Oberseestrasse 10, 8640 Rapperswil).
 
−
# Nehmen Sie den Längen- und Breitengrad und überprüfen Sie, ob Nomatim Ihnen die richtige Adresse der HSR liefert (reverse geocoding).
 
  
 +
=== Aufgabe 2 Webservice ansprechen mit Python ===
 +
Führen Sie die gleichen beiden Anfragen (Geocoding und Reverse Geocoding) wie in der vorherigen Aufgabe durch, nun aber mit Python.
  
−
=== Web-Service Ansprechen mit Python  ===
+
Tipps:
−
# Führen Sie die gleichen beiden Anfragen (Geocoding und Reverse Geocoding) wie in der vorherigen Aufgabe durch, nun aber mit Python. Verwenden Sie das Python Modul [[urllib]] um einen Request an den Web Service zu machen und [http://docs.python.org/library/json.html json] für das JSON Parsing [http://docs.python.org/library/json.html json].
+
* Verwenden Sie das Python-Modul [[urllib]] (vgl. Kap. 20.5 in der Python Doku.) um einen Request an den Webservice zu machen.
 +
* Nehmen Sie die Python-Bibliothek [http://docs.python.org/library/json.html JSON] für das Interpretieren des JSON-Formats ("JSON Parsing").

Aktuelle Version vom 17. Januar 2013, 16:08 Uhr

Zurück zum Kurs Python richtig lernen#Uebungen.

Übung "Web Services mit Python"

In dieser Übung lernen Sie die Verwendung von Webservices (Web Services) mit Python kennen. Wir konzentrieren uns hier auf Clients und verwenden dazu den Webserver 'Nominatim' zur Geokodierung (bzw. "Reverse Geocodierung") von OpenStreetmap-Daten (OSM = Abk. für OpenStreetmap).

Geschätzter Zeitaufwand für diese Übung: ca. 1h.

Webservice kennenlernen mit cURL

In dieser Übung machen ein sog. "Reverse Geocoding", d.h. gegeben eine Koordinate wird die räumlich nächstgelegene Adresse oder der nächstgelegene Name gesucht.

Zunächst probieren wir ein Software-Client aus namens cURL ('cörl'), das ganz ohne Python auskommt. cURL ist ein Kommandozeilen-Werkzeug, mit dem Daten über eine Internetadresse herunter- und hochgeladen werden können. Es unterstützt zahlreiche Internetprotokolle u.a. auch das HTTP-Protokoll ("HTTP GET Request"). Es ist bei den meisten Linux dabei; für Windows muss es separat installiert werden. Wir verwenden es hier um uns ohne Programmieraufwand mit der Funktionsweise von Webservices bekannt zu machen. Als Dokumentation dient die Manualseite (manpage) von cURL.

Als Webservice verwenden wir 'Nominatim', der auch in der Suche auf der OpenStreetMap Homepage verwendet wird. Nominatim (lateinisch für "namentlich") ist ein Werkzeug, um in OpenStreetMap (OSM) über den Namen und Adresse nach OSM-Objekten zu suchen. Die freie Webapplikation kann mit dem Browser auch direkt verwendet werden: http://nominatim.openstreetmap.org .

Der Webservice Nominatim lässt sich über HTTP ansprechen. Als Antwort-Datenformat (response) kennt Nominatim JSON, HTML und XML. Wir verwenden JSON und damit dieses auf der Konsole ansprechend formatiert wird, verwenden wir als pretty printer das JSON Python Modul json. Hier ein Beispiel wie dieses verwendet werden kann: 

curl [options] [URL...] | python -mjson.tool

Tipp 1: Verwenden Sie die Option -v (verbose), um genau zu sehen, wie der Request an den Webservice aussieht. Das hielft beim Debugging enorm.

Tipp 2: Da das manuelle Erzeugen eines korrekten Weblinks (sog. "URL encoded query strings") an den Webservice etwas mühsam ist, können Sie cURL anweisen, mit Hilfe des Parameters --data-urlencode dies zu übernehmen. Beispiel (Verwendung von -G für einen HTTP GET Request): 

curl -G --data-urlencode "key=some value" http://hsr.ch/pythonrichtiglernen

cURL macht daraus dann einen korrekten Aufruf ("GET Request") an http://hsr.ch/pythonrichtiglernen/?key=some%20value (man beachte "20%").

Die Dokumentation der Webservice API von Nominatim finden Sie hier.

Aufgabe 1 "Reverse Geocoding"

1a. Finden Sie mit cURL und Nominatim den Längen- und Breitengrad der HSR (Oberseestrasse 10, 8640 Rapperswil).

1b. Nehmen Sie den gefundenen Längen- und Breitengrad und überprüfen Sie mit cURL, ob Nominatim Ihnen die richtige Adresse der HSR liefert.

Aufgabe 2 Webservice ansprechen mit Python

Führen Sie die gleichen beiden Anfragen (Geocoding und Reverse Geocoding) wie in der vorherigen Aufgabe durch, nun aber mit Python.

Tipps:

  • Verwenden Sie das Python-Modul urllib (vgl. Kap. 20.5 in der Python Doku.) um einen Request an den Webservice zu machen.
  • Nehmen Sie die Python-Bibliothek JSON für das Interpretieren des JSON-Formats ("JSON Parsing").
Von «https://giswiki.hsr.ch/index.php?title=Kurs_Python_richtig_lernen/Webservices&oldid=45177»