OSM-API. API = Application Programming Interface Fenster der OSM-DB zur Welt. Zentrale OSM-DB. API planet.osm daily.osc

Transkript

1 OSM-API API = Application Programming Interface Fenster der OSM-DB zur Welt Zentrale OSM-DB API planet.osm daily.osc OSM-Editor Download/Anwendung

2 OSM-API Zugriff auf die OSM-DB geschieht über eine HTTP-basierte REST-Architektur REST = Representational State Transfer Prinzipien von REST: Jede Ressource ist ein spezifischer URI zugeordnet Wohldefinierte Menge von Operatoren Verwendet HTTP (GET, PUT, DELETE, etc.) Ressourcen können untereinander Verlinkt sein REST-Services sind Zustandslos, d.h. Jede Anfrage ist in sich geschloßen

3 HTTP HTTP = Hyper Text Transfer Protocol HTTP ist ein Kommunikationsschema, um Daten (z.b. Webseiten) zu übertragen HTTP unterstützt verschiedene Methoden, wie z.b. GET, POST, HEAD, DELETE Beispiel: Anfrage vom Browser: GET /infotext.html HTTP/1.1 Host: Antwort vom Server: HTTP/ OK Server: Apache/ (Unix) PHP/4.3.4 Content-Length: (Größe von infotext.html in Byte) Content-Language: de (nach ISO 639 und ISO 3166) Content-Type: text/html Connection: close (Inhalt von infotext.html)

4 HTTP-Methoden GET: Fordere Inhalt vom Server an POST: Wie GET, nur übermittelt zusätzlichen Datenblock für Parameter HEAD: Wie GET, liefert jedoch nur den HTTP- Header PUT: Dateien auf einen Server laden DELETE: Löschen von Dateien

5 Argument-Übertragung Will der Nutzer spezielle Informationen mit einer Anfrage senden, gibt es zwei Möglichkeiten: GET: Die Daten sind Teil der URL (...search.html? name=<name>) POST: Daten werden unsichtbar in dem HTTP- Body mitübertragen

6 HTTP-Statuscodes Jede HTTP-Anfrage wird vom Server mit einem Statuscode im Header beantwortet: 200 OK: Die Anfrage wurde erfolgreich beantwortet 401 Unauthorized: Keine gültig Authentifizierung 404 Not Found: Die Ressource wurde nicht gefunden...

7 OSM-API Anfragen an die API geschehen über die URL Die URL ist eine Web-Adresse und beginnt stehts mit Die Daten werden im OSM-XML-Format übertragen Aktuelle API- Version Authentifizierung geschieht über HTTP Basic Auth

8 Erzeugen und Bearbeiten von Objekten Folgende Operationen unterstützt die API für die Grund-Objekttypen: Zweck HTTP-Methode Anfrage Antwort Neuanlage PUT /api/0.5/<typ>create XML id Lesen GET /api/0.5/<typ>/>id> - XML Ändern PUT /api/0.5/<typ>/<id> XML - Löschen DELETE /api/0.5/<typ>/<id> - - Diese Methoden geben HTTP-Statuscodes (200 OK, 401 Unauthorized, etc... ) zurück, je nach Erfolg der Anfrage Beispiel für einen GET-Request:

9 Objekte in einem Bereich abrufen Abfrage über Bounding Box: GET /api/0.5/map?bbox=<left>,<bottom>,<right>,<top> Man erhält OSM-XML, mit: Nodes, die in der BBox liegen Ways, die min. einen der Nodes benutzen Nodes, die außerhalb der BBox liegen, aber von den Ways benutzt werden Alle betroffenen Relationen (Member der Relationen werden nicht zwingend übertragen)

10 Einschränkung BBox Maximale Größe: 0,25 Quadrat-Grad Maximal Nodes im Ergebniss Sonst: Fehlercode 400 Bad Request

11 Weitere Zugriffsmethoden Änderungshistorie: GET /api/0.5/<typ>/<id>/history Alle frühere Versionen mit Zeitstempel /auch gelöschte) Beispiel: Verketteter Abruf: GET /api/0.5/<typ>s?<typ>s=<id>[,<id>...] Beispiel: GET /api/0.5/ways?ways=1123,4452,3428

12 Referenzen finden Rückwärtsreferenzen finden: GET /api/0.5/node/<id>/ways Liefert die Ways, die den Knoten <id> enthalten GET /api/0.5/<typ>/<id>/relations Liefert Relationen, welche auf <id> vom Typ <typ> verweise Vorwärtsreferenzen Nur auflösen: Ways und GET /api/0.5/<typ>/<id>/full Relations Liefert <id> selbst und alle Objekte, auf welche in <id> verwiesen wird Beispiel:

13 Objekte nach Tags Objekte nach Tags suchen: GET /api/0.5/<typ>/search?type=<key>&value=<value> Liefert Objekte vom Typ <typ> die die entsprechenden Tags beinhalten GET /api/0.5/search?type=<key>&value=<value> Liefert Objekte beliebiegen Typs, welche die entsprechenden Tags beinhalten <key> oder <value> dürfen weggelassen werden Suchbegriffe sind nicht Case-Sensitive und UTF-8 codiert Maximal werden 2000 Nodes, 100 Ways und 100 Relations zurück gegeben Problem: Suchbereich kann nicht eingschränkt werden

14 API und GPS-Track-Upload POST /api/0.5/gpx/create Innerhalb der Nachricht müßen folgende Parameter angegeben werden: file: Der GPX-Track description: Eine kurze Beschreibung des Tracks tags: Tags, die den Track beschreiben public: Öffentlich? 0 oder 1

15 Sonstige API-Methoden GET /api/0.5/gpx/<id>/details Trackdetails GET /api/0.5/gpx/<id>/data Track GET /api/0.5/user/details Userdetails (über sich selbst) GET /api/0.5/user/gpx_files Selbst hochgeladene GPX-Tracks GET /api/0.5/capabilities API-Version, max. BBox

16 OsmXAPI OSM Extended API Basiert auf eigenen Kopie der OSM-DB Nicht immer (hoch)-aktuelle Daten Vorteile: Keine Begrenzung der Rückgabemenge Mächtigere Suchabfragen Nachteil: Nur Lesezugriffe Unterstützt (noch) keine Relation

17 OsmXAPI Zugriff auf die OsmXAPI über: Anfragen: GET /api/0.5/node[bedingung] GET /api/0.5/way[bedingung] GET /api/0.5/*[bedingung]

18 Bedingungen Haben die Form [schlüssel=wert] * steht für beliebige Zeichen Verknüpfungen sind mittels des Oder-Operators möglich Bereichsbedingungen haben die Form [bbox=bllon,bllat,trlon,trlat] Wiki-Seite zur API:

19 Beispiele OsmXAPI ][natural=coastline] 5][amenity=fuel] trunk]

20 Pseudo-Keys und API-Kompatibilität Statt regulären Keys können auch Pseudkeys benutzt werden Pseudo-Keys sind: osm:user, osm:users und osm:timestamp Beispiel: 3,-13,67][osm:user=woodpeck] OsmXAPI unterstützt auch BBox-Angaben durch GET /api/0.5/map?bbox=... Einfache BBox-Abfragen sind also kompatibel zur Standard-OSM-API

21 Weitere APIs Name Finder: Suche nach Namen von Straßen, Orte und anderer Objekte Versteht auch Abkürzungen (z.b. Str. statt Straße) Wird auch auf der openstreetmap.org-seite für das Suchfeld benutzt

22 Karten zeichnen mit Osmarender

23 Osmarender Erzeugt SVG-Vektorkarten SVG-Dateien können Beispielsweise im Webbrowser oder (besser) mit Inkscape betrachtet werden Wie die Daten kartographisch dargestellt werden, läßt sich selbst bestimmen Osmarender wird auch für eingesetzt

24 SVG SVG = Scalable Vector Graphics XML-basiert, vom W3C im September 2001 spezifiziert Beliebig skalierbar ( im Gegensatz zu Bitmap- Grafiken) Da SVG in XML, besonders für die Verarbeitung durch Computer geeignet

25 Beispiel: SVG <?xml version="1.0" encoding="utf 8"?> <svg xmlns=" xmlns:xlink=" xmlns:ev=" events" version="1.1" baseprofile="full" width="107" height="60" viewbox=" "> <line x1="0" y1="25" x2="100" y2="25" fill="none" stroke="black" stroke width="3px"/> Anschlüsse links und rechts Wiederstandsrecht eck <rect x="10" y="15" width="80" height="20" fill="white" stroke="black" stroke width="3px" /> <polyline points=" " fill="none" stroke="black" Pfeilstrich stroke width="3px"/> <polygon points=" " stroke="black" stroke width="3px" </svg> transform="rotate( )" /> Pfeilspitze

26 XSLT XSLT = Extensible Stylesheet Language Transformation XSLT wird benutzt, um XML-Dateien in andere XML-Dateien zu transformieren Die Umwandlungsregeln befinden sich in Style- Dateien (Endung.xsl) Ein XSLT-Prozessor liest die Style-Datei + Eingabe-XML-Datei und liefert eine transformierte XML-Ausgabedatei Wdh: XML- Dateien sind genau spezifiziert, und dadurch durch Computer verarbeitbar

27 Osmarender und XSLT XSLT zum Rendern von Karten bietet sich an, da sowohl OSM als auch SVG in XML-Format sind Zusätzlich werden jedoch Zeichenvorschriften, wie die Geodaten gezeichnet werden sollen, benötigt: Die sogenannte Rules-Datei (in XML) Osmarender ist komplex und rechenaufwändig! -> Nur für kleine ausschnitte geeignet

28 Rendern mit Osmarender.osm XSLT- Prozessor.svg SVG- Renderer Zeichen- Regeln (Rules).xsl.png Osmarender

29 Aufruf von Osmarender Es existieren verschiedene XSLT-Proz., z.b. Xalan, xmlstarlet und MSXML Auch Webbrowser haben häufig einen SXLT- Prozessor integriert Aufruf von Osmarender variiert je nach OS und XSLT-Prozessor Download von Osmarender über Subversion: Als Zip unter:

30 Aufruf unter Linux Aufruf:./xslt/osmarender -r osm-mapfeatures-z17.xml map.osm Mittels des Scripts xsltrans wird der zu verwendende XSLT-Prozessor automatisch ermittelt Zoomstufe 17: 1 px = 1m Ein Titel kann mit der Option -t angegeben werden

31 Osmarender mit Firefox Firefox hat einen XSLT-Prozessor integriert kann XSLT-Transformationen direkt ausführen osmarender.xls und data.osm müssen dafür im gleichen Verzeichniss liegen Öffnet man die Rules-Datei im Browser, wird die gerenderte Karte angezeigt Der Firefox-Prozessor ist langsam, deshalb ist die Vorgehensweise nur für kleine Karten sinnvoll Parameter müssen direkt in der Rules-Datei ggf. verändert werden

32 Aufruf unter Windows Xalan runterladen unter: Aufruf: java -cp c:\path\to\xalan.jar org.apache.xalan.xslt.process -in osm-mapfeatures-z17.xml -out map.svg In der Rules-Datei steht, welche XSLT-Style- Datei und Daten-Datei verwendet werden soll Problem: buggy

33 Aufruf unter Windows (xmlstarlet) XMLStarlet runter laden von: Aus dem Verzeichniss, in dem Osmarender installiert ist aufrufen: c:\xml\xml tr osmarender.xsl osm-mapfeatures-z17.xml > map.svg

34 Beispiel: Institut mit Osmarender