Kurs Python richtig lernen/Webservices: Unterschied zwischen den Versionen

Aus Geoinformation HSR
Wechseln zu: Navigation, Suche
K (Aufgabe 2 Webservice Ansprechen mit Python)
K
Zeile 1: Zeile 1:
 
== Ü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 Webservice, bzw. Webserver zur Geokodierung von OSM-Daten (Open Streetmap).  
  
 
Geschätzter Zeitaufwand für diese Übung: ca. '''1h'''.
 
Geschätzter Zeitaufwand für diese Übung: ca. '''1h'''.
Zeile 7: Zeile 7:
 
=== Webservice kennenlernen mit cURL ===
 
=== Webservice kennenlernen mit cURL ===
  
In dieser Übung lernen wir Webservices kennen, d.h. der Aufruf einer entfernten Prozedur oder Funktion. Wir machen ein sog. "Reverse Geocoding", d.h. gegeben eine Koordinate wird die nächstgelegene Adresse oder der nächstgelegene Name gesucht.  
+
In dieser Übung lernen wir einen konsumierenden Webservices kennen, d.h. der Aufruf einer entfernten Prozedur oder Funktion. Wir machen ein sog. "Reverse Geocoding", d.h. gegeben eine Koordinate wird die nächstgelegene Adresse oder der nächstgelegene Name gesucht.  
  
 
cURL ('cörl') ist ein Kommandozeilen-Werkzeug, mit dem Daten über eine Internetadresse herunter- und hochgeladen werden können. Es unterstützt zahlreiche Internetprotokolle wie HTTP, FTP, LDAP etc. 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].  
 
cURL ('cörl') ist ein Kommandozeilen-Werkzeug, mit dem Daten über eine Internetadresse herunter- und hochgeladen werden können. Es unterstützt zahlreiche Internetprotokolle wie HTTP, FTP, LDAP etc. 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].  

Version vom 14. September 2012, 14:21 Uhr

Ü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 Webservice, bzw. Webserver zur Geokodierung von OSM-Daten (Open Streetmap).

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

Webservice kennenlernen mit cURL

In dieser Übung lernen wir einen konsumierenden Webservices kennen, d.h. der Aufruf einer entfernten Prozedur oder Funktion. Wir machen ein sog. "Reverse Geocoding", d.h. gegeben eine Koordinate wird die nächstgelegene Adresse oder der nächstgelegene Name gesucht.

cURL ('cörl') ist ein Kommandozeilen-Werkzeug, mit dem Daten über eine Internetadresse herunter- und hochgeladen werden können. Es unterstützt zahlreiche Internetprotokolle wie HTTP, FTP, LDAP etc. 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 das verbreitete HTTP-Protokoll ansprechen ("HTTP GET Request"). 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=v a l u e" http://hsr.ch/pythonrichtiglernen

cURL macht daraus dann einen korrekten Aufruf ("GET Request") an http://hsr.ch/pythonrichtiglernen/?key=v%20a%20l%20u%20e.

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 um einen Request an den Webservice zu machen.
  • Nehmen Sie die Python-Bibliothek json für das Interpretieren des JSON-Formats ("JSON Parsing").