DE:OpenLinkMap

From OpenStreetMap Wiki
Jump to: navigation, search
Help
Verfügbare Sprachen
Deutsch English 日本語
Informationen zu einer Stadt anzeigen
In der Umgebung suchen

OpenLinkMap ist eine Webanwendung, die auf einer OpenStreetMap-Karte viele verschiedene Zusatzinformationen anzeigt.

OpenLinkMap ist eine Webanwendung, die im Januar 2010 vorgestellt wurde. Anfangs wurden (Wikipedia-)Links auf einer Slippymap angezeigt, mittlerweile werden auch viele andere Details zu POIs angezeigt, zum Beispiel ein passendes Bild, der Anfang des passenden Wikipediaartikels, nächste Bushaltestellen, Parkplätze und Bahnhöfe, bei Restaurants Informationen über das Rauchen, Küche oder Internetanbindung und vieles mehr. Das Projekt versteht sich als eine Erweiterung der normalen Karte, die (auf der Kachelkarte) nicht sichtbare Informationen ergänzt und passende Informationen aus anderen Webdiensten einbindet.

Contents

Funktionen

Verwendete Software

URL-Parameter

lang=<Sprache nach ISO 639-1>

Dient dazu, eine bestimmte Sprache für Benutzeroberfläche und z.B. die Auswahl mehrsprachiger Namen zu erzwingen. Ansonsten wird die Sprache nach HTTP_ACCEPT_LANGUAGE des Benutzers ausgewählt.

id=<OSM-ID eines Objektes>

Zusammen mit dem Parameter "type" kann man direkt an zu diesem Objekt springen und das dazugehörige Popup öffnen.

type=node|way|relation

Zusammen mit dem Parameter "id" kann man direkt an zu diesem Objekt springen und das dazugehörige Popup öffnen.

q=<Suchausdruck>

Übergibt man mit diesem Parameter einen Suchausdruck, so wird direkt beim Laden der Seite eine Suche mit diesem Begriff durchgeführt.

bounded=1|0

Mit diesem Parameter kann man bei einer Suche über den URL-Parameter "q" angeben, dass nur im sichtbaren Kartenausschnitt gesucht werden soll. Diese Option ist nur sinnvoll, wenn gleichzeitig mit den Parametern "lat", "lon" und "zoom" ein Kartenausschnitt gewählt wird.

lat=<Lat-Koordinate>

Mit diesem Parameter lässt sich zusammen mit den Parametern "lon" und "zoom" die Position der Karte beim Aufruf der Webseite regeln.

lon=<Lon-Koordinate>

Mit diesem Parameter lässt sich zusammen mit den Parametern "lat" und "zoom" die Position der Karte beim Aufruf der Webseite regeln.

zoom=<Zoomstufe>

Mit diesem Parameter lässt sich zusammen mit den Parametern "lat" und "lon" die Position der Karte beim Aufruf der Webseite regeln. "zoom" bestimmt dabei die Zoomstufe.

offset=<Unterschied der eigenen Zeitzone zu UTC in Stunden>

Mit diesem Parameter legt man fest, wie viele Stunden die eigene Zeitzone von der Universalzeit UTC abweicht. Dieser Wert ist notwendig um korrekt zu berechnen, ob ein Geschäft zur Zeit offen hat oder wann die Datenbank zuletzt aktualisiert wurde.

API

Jeder ist ausdrücklich willkommen, die API für eigene kleinere Projekte mitzubenutzen. Am besten ist es, vorher mitzuteilen, wenn regelmäßige Abfragen durchgeführt werden, damit die Last nicht zu groß wird.

Alle API-Funktionen erlauben JSONP. Um dieses Format zu verwenden, müssen die Parameter

format=json
callback=<Callback-Funktion>

übergeben werden.

POIs in einem bestimmten Bereich

http://openlinkmap.org/api/list.php

Parameter:

bbox: Boundingbox, Werte durch Komma getrennt
format: csv, json; Standardwert: csv

Antwort:

CSV-Datei: <lon>|<lat>|<osmid>|<type>

Beispiel: http://www.openlinkmap.org/api/list.php?bbox=6.67336,51.203552,6.679132,51.206406

Details

http://openlinkmap.org/api/details.php

Parameter:

format: text (für vorformatiertes HTML), xml, json; Standardwert: xml
id:     OSM-ID des abzufragenden Objektes
type:   Objekttyp des abzufragenden Objektes, node/way/relation
offset: Unterschied in Stunden der Zeitzone des Users zu UTC (benötigt für die korrekte Anzeige der Öffnungszeiten); Standardwert: 0
lang:   Bevorzugte Sprache nach ISO 639-1, z.B. für die Auswahl des Namens oder des Wikipedialinks, aber auch für die Auswahl der Beschriftungen; Standardwert: priorisierte HTTP_ACCEPT_LANGUAGE

Antwort:

XML, JSON oder formatiertes HTML

Beispiel: http://www.openlinkmap.org/api/details.php?id=18530948&type=way

Erweiterte Details

http://openlinkmap.org/api/extdetails.php

Parameter:

format: text (für vorformatiertes HTML), xml, json; Standardwert: xml
id:     OSM-ID des abzufragenden Objektes
type:   Objekttyp des abzufragenden Objektes, node/way/relation
offset: Unterschied in Stunden der Zeitzone des Users zu UTC (benötigt für die korrekte Anzeige der Öffnungszeiten); Standardwert: 0
lang:   Bevorzugte Sprache nach ISO 639-1, z.B. für die Auswahl des Namens oder des Wikipedialinks, aber auch für die Auswahl der Beschriftungen; Standardwert: priorisierte HTTP_ACCEPT_LANGUAGE

Antwort:

XML, JSON oder formatiertes HTML

Beispiel: http://www.openlinkmap.org/api/extdetails.php?id=18530948&type=way

Objekte in der Nähe

http://openlinkmap.org/api/nextobject.php

Parameter:

lat:    lat-Koordinate des abzufragenden Standortes (zusammen mit lon erforderlich, wenn kein bestimmtes Objekt bekannt ist; sonst nicht notwendig)
lon:    lon-Koordinate des abzufragenden Standortes (zusammen mit lat erforderlich, wenn kein bestimmtes Objekt bekannt ist; sonst nicht notwendig)
type:   Objekttyp des abzufragenden Objektes, node/way/relation (zusammen mit id erforderlich, wenn keine Koordinate bekannt ist; sonst nicht notwendig)
id:     OSM-ID des abzufragenden Objektes (zusammen mit type erforderlich, wenn keine Koordinate bekannt ist; sonst nicht notwendig)
format: text (für vorformatiertes HTML), xml, json; Standardwert: text

Antwort:

XML, JSON oder formatiertes HTML

Die Entfernung ist lediglich die Luftlinie!

Beispiel: http://www.openlinkmap.org/api/nextobject.php?id=80148145&type=way&format=xml

Letztes Datenbank-Update

http://openlinkmap.org/api/timestamp.php

Parameter:

lang:   Bevorzugte Sprache nach ISO 639-1, z.B. für die richtige Auswahl von Texten im Datum; Standardwert: priorisierte HTTP_ACCEPT_LANGUAGE
format: text (für einfachen Plaintext String), xml, json; Standardwert: xml
offset: Unterschied in Stunden der Zeitzone des Users zu UTC (benötigt für die korrekte Berechnung des Zeitunterschiedes zwischen Update und aktueller Zeit); Standardwert: 0

Antwort:

XML, JSON oder Text

Mit dieser Abfrage lässt sich abfragen, wann die Datenbank zuletzt aktualisiert wurde und wie alt die Daten sind.

Beispiel: http://www.openlinkmap.org/api/timestamp.php?format=xml

Name

http://openlinkmap.org/api/name.php

Parameter:

lang:   Bevorzugte Sprache nach ISO 639-1, z.B. für die Auswahl des Namens oder des Wikipedialinks, aber auch für die Auswahl der Beschriftungen; Standartwert: priorisierte HTTP_ACCEPT_LANGUAGE
format: text (für einfachen Plaintext String), xml, json; Standardwert: text
id:     OSM-ID des abzufragenden Objektes
type:   Objekttyp des abzufragenden Objektes, node/way/relation

Antwort:

XML, JSON oder Text

Mit dieser Funktion kann man den Namen eines gegebenen OSM-Objektes (in einer beliebigen Sprache) abfragen.

Beispiel: http://www.openlinkmap.org/api/name.php?format=xml&id=18530948&type=way&format=xml

Benutzersprache

http://openlinkmap.org/api/userlang.php

Parameter:

keine

Antwort:

String, der die Sprache des Benutzers nach ISO 639-1 zurückgibt.

Gibt die Sprache zurück, die beim Nutzer die höchste Priorität hat. Grundlage dafür ist HTTP_ACCEPT_LANGUAGE des Benutzers.

IP-Lokalisierung

http://openlinkmap.org/api/ippos.php

Parameter:

 format: text (für einfachen Plaintext String), xml, json; Standardwert: text

Gibt den per IP-Adresse ermittelten Standort des Benutzers zurück.

Tag-Übersetzungen

http://openlinkmap.org/api/translation.php

Parameter:

 lang: Sprache nach ISO 639-1, in welcher die Übersetzungen gewünscht sind
 string: Ein oder mehrere zu übersetzende Tags, getrennt durch ",". Key und Value werden durch "." getrennt (siehe Beispiel unten).
 format: text (einfacher Plaintext), xml, json; Standardwert: text

Gibt die Übersetzung für ein oder mehrere Tags zurück.

Beispiel: http://www.openlinkmap.org/api/translation.php?lang=de&string=amenity.fuel,shop.bakery

Übersetzungen

Um auf die Übersetzungen zuzugreifen, integriert man folgenden Code in seine eigene Anwendung:

<script type="text/javascript" src="http://www.openlinkmap.org/locales/<SPRACHE>.js"></script>
<script type="text/javascript" src="http://www.openlinkmap.org/api/langfile.php?lang=<SPRACHE>"></script>

Eine Sprachdatei im JSON-Format bekommt man mit folgender Abfrage:

 http://www.openlinkmap.org/api/langfile.php?format=json&lang=<SPRACHE>

Karte in andere Webseiten einbinden

Es besteht die Möglichkeit, eine kleine Karte mit einem Marker und dem dazugehörigen Popup in eine andere Webseite einzubinden:

<iframe width="420" height="350" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="http://www.openlinkmap.org/embed.php?id=<OSM-ID>&type=<node|way|relation>" style="border: 1px solid black"></iframe>

Außerdem gibt es einen Modus, in dem man eine kleine Slippymap mit allen POIs aus OpenLinkMap einbinden kann:

<iframe width="420" height="350" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="http://www.openlinkmap.org/small.php?lat=<LAT>&lon=<LON>" style="border: 1px solid black"></iframe>

Tagging

Zur Anzeige notwendige Tags

Damit Objekte auf der Karte als Punkte angezeigt werden, muss mindestens eines der folgenden Tags vorhanden sein. Für weitere Informationen über die Tags und mögliche Werte bitte unter den jeweiligen Keys nachsehen.

Ausgewertete Informationen

Zusätzlich zu den notwendigen Tags gibt es weitere Tags, die ausgewertet werden. Für weitere Informationen über die Tags und mögliche Werte bitte unter den jeweiligen Keys nachsehen.

Erlaubte Werte

Für einige Tags gibt es verschiedene zulässige Werte, die korrekt ausgewertet werden:

Funktion Akzeptierte Schlüssel Beispiel-Wert
Wikipediaartikel in bestimmter Sprache http://de.wikipedia.org/wiki/Köln
de:Köln
Wikipediaartikel in bestimmter Sprache http://de.wikipedia.org/wiki/Köln
de:Köln
Köln
Wikipediaartikel in Englisch Cologne
Hinweis: Zur Verlinkung des passenden Wikipediaartikels ist nur ein Tag notwendig! Sofern es sich um den gleichen Artikel handelt, kann der Link zu einem anderssprachigen Artikel mithilfe der Wikipedia-API gefunden werden.
Mobiltelefon +49-1234-56789
+49 1234 56789
Fax +49-1234-56789
+49 1234 56789
Homepage www....
http://www...
http://...
https://www...
https://...
Bild vollständige URL zum Bild oder zur Bildseite; wegen rechtlichen Problemen werden nur Bilder von Wikimedia Commons angezeigt

Projektmitarbeiter

Gelegentliche Mitarbeiter:

Verfügbare Sprachen

Fehlt dir eine Sprache in dieser Liste? Übersetze die Anwendung und diese Wikiseite in eine andere Sprache!

Bugs / Zukünftige Entwicklungen / Ideen / TODOs

Mitarbeiten

Mitarbeiter sind jederzeit willkommen, sei es als Programmierer, Übersetzer oder Designer. Schreibe mir einfach eine kurze E-Mail, wenn du auf irgendeine Weise helfen willst.

Daten erfassen: Die Nützlichkeit dieser Karte hängt von den erfassten Daten ab. Trage also mit deinem Wissen dazu bei, dass die Karte noch umfangreicher, aktueller und genauer wird!

Programmieren: Du hast eine neue Funktion programmiert oder einen Fehler im Programmcode behoben? Schicke mir gerne deinen Code und nach einer Prüfung werde ich ihn einbauen.

Übersetzungen: OLM soll möglichst vielen Nutzern in ihrer Sprache verfügbar sein. Übersetze die Anwendung und diese Wikiseite in eine andere Sprache!

Design: Das jetzige Design ist stark verbesserungswürdig. Hier sind also Leute gefragt, die die Seite etwas auffrischen oder auch die Unterstützung in verschiedenen Browsern verbessern, damit OLM überall gleich aussieht.

Ressourcen: OLM ist ein Hobbyprojekt, dementsprechend sind die benötigten Ressourcen wie Hardware, Domains, etc. sehr knapp. Wenn du also mit einem der genannten Dinge helfen kannst, bist du herzlich willkommen.

Bugreports, Browsertests, Featurevorschläge oder Kritik sind ebenfalls hilfreich und gewünscht. Einfach Kontakt zu mir aufnehmen, wie, das steht unter Kontakt.

Download

Es wird empfohlen, keine Version unterhalb der Version 7.0 zu verwenden! Frühere Versionen setzen eine andere Datenbank voraus, deren Installation weder in den Paketen noch hier auf der Wikiseite dokumentiert ist.

Eine Übersicht über die Änderungen in jeder Version gibt es in der beigelegten Datei "CHANGELOG".

Über das [Git-Repository] kann man ebenfalls die Änderungshistorie einsehen.

Eigene Anwendungen

Jeder darf OLM als Grundlage für eigene Anwendungen benutzen, soweit dies mit den Lizenzbedingungen der [GNU General Public License Version 3] vereinbar ist. In Ausnahmefällen erlaube ich aber auch andere Nutzungsbedingungen!

Es wird empfohlen, keine Version unterhalb der Version 7.0 zu verwenden! Frühere Versionen setzen eine andere Datenbank voraus, deren Installation weder in den Paketen noch hier auf der Wikiseite dokumentiert ist.

Da meine Freizeit begrenzt ist und ich schon mit der Entwicklung von OLM mehr als genug beschäftigt bin, programmiere ich nicht auf Anfrage! Meine Unterstützung beschränkt sich lediglich auf das Beantworten von Fragen zur Installation oder dem Codeverständnis.

Updates

In der Regel wird die Datenbank jeden Tag um etwa 01:00 aktualisiert. Das angegebene Datum kann manchmal leicht vom Zeitstempel der Daten abweichen. Sollten Änderungen also nicht beim nächsten Update auftauchen, sollten sie auf jeden Fall beim nächsten Update erscheinen.

Kontakt

Um mich zu kontaktieren, stehen verschiedene Wege zur Verfügung:

Danksagungen

Links

Personal tools
Namespaces
Variants
Actions
site
Toolbox