RelatedTerms: Unterschied zwischen den Versionen

Aus Geoinformation HSR
Wechseln zu: Navigation, Suche
(→‎Verwandte Begriffe für Anwender und Wiki-Autoren)
(→‎The Problem)
 
(13 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
−
Related Term (de: Verwandter Begriff) Assoziationsbeziehung zwischen Begriffen.  
+
Related Term (de: Verwandter Begriff)  
 +
* association relationship between terms, like synonym. A term can consist of one ore more words, like ''Lord's House''.
 +
* de: Assoziationsbeziehung zwischen Begriffen wie z.B. Synonym (ein Term kann aus mehreren Worten bestehen, wie z.B. ''Lord's house'').  
  
−
  >> Zur (bekannteren) englischen Dokumentation '''[http://wiki.openstreetmap.org/RelatedTerms auf dem OSM Wiki]'''.
+
Quicklinks:
 +
* [http://wiki.openstreetmap.org/RelatedTerms Related terms on OSM Wiki] <<<
 +
* [[Diskussion:RelatedTerms]] (german) especially for project management.
  
−
== Overview ==
 
  
−
=== The Problem ===
+
== The Problem ==
  
−
We want to improve searching for OSM tags. Currently, when looking for the correct tag of a "church", it's not straighforward that the correct tag is "amenity=place_of_worship". A crucial point there is that synonyms and related terms are found (term being one ore more words).  
+
We want to improve the searching for OSM tags.  
 +
Currently, when looking in OSM wiki or [[Taginfo]] for the tag of a "chapel" (where the correct tag is "amenity=place_of_worship"), it's not found!
 +
A crucial point there is that synonyms and related terms have to be there.  
  
−
Here are some collected examples:  
+
Here are some examples of terms currently not found in OSM Wiki nor in Taginfo:  
−
* en: amenity=place_of_worship => church
+
* Fussgängerstreifen (de_CH) => ?
−
* de_CH: Fussgängerstreifen => ?
+
* Litfaßsäule (de_DE) => ?
−
* de_DE: Litfaßsäule => ?
+
* Schloss (de) => ?  
−
* (please add yours)
+
* Geldinstitut
 +
* (please add yours...)
  
−
=== The Solution ===
+
Here are some examples of terms only found because of redirect pages or other tricks:
 +
* chapel (en), Parkplatz (de) => amenity=place_of_worship (redirect)
 +
* Badeanstalt (de) DE:=> Howto_Map_A
  
−
In order to achieve this a controlled word list (a thesaurus) becomes necessary. This is
+
== The Solution ==
−
a list of terms where some are OpenStreetMap specific. This can not be found in a general
 
−
purpose thesaurus.
 
  
−
So, we propose to capture in the OSM wiki so-called "related terms". They can be kept up
+
In order to achieve an enhanced search, a controlled word list (a term list, a thesaurus) becomes necessary.
−
to date by the community (while I would like to set a good example).
+
This is a list of synonyms where most are OpenStreetMap specific.
 +
This information can not be found in a general purpose thesaurus.
 +
So, we propose that mappers capture so-called "related terms" (synonyms) in the OSM wiki.  
 +
These related terms are fully part of the OSM wiki page and can be kept up to date by the community (where I would like to set a good example).
 +
Tools like TagFinder can parse these info - among others - out of the wiki page and thus helps making the OSM database more accessible.  
  
−
Of course it would be more precise to introduce also synonyms and broader/narrower terms.
+
  We encourage all to add also related terms when documenting OSM tags (key/values)!
−
But that seems too complicated for many users. (Hintergrund (aus: [
+
  This will help enhance the search experience of all mappers!
−
http://en.wikipedia.org/wiki/Thesaurus], bzw. [http://de.wikipedia.org/wiki/Thesaurus]):
 
−
Als Thesaurus (auch kontrolliertes Vokabular, Taxonomie, Ontologie) bezeichnet man ein
 
−
Wortnetz, mit dem ein Themengebiet genauer beschrieben und repräsentiert wird. Es ist
 
−
eine Sammlung von Begriffen, die in thematischer Beziehung (Relation, Assoziation)
 
−
zueinander stehen. Es werden folgende Arten von Beziehungen unterschieden: 1. Synonyme,
 
−
2. Ober- und Unterbegriffe und 3. verwandte Begriffe.)
 
  
−
In order to store related terms are proposes to use wiki templates.
+
== The Template ==
−
Look at the wiki page '[http://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship Tag:amenity=place_of_worship]' to see how this template used. Here is the [http://wiki.openstreetmap.org/wiki/Template:RelatedTerm Template:RelatedTerm] with some explanations.
 
  
−
The related terms are parsed from the Wiki pages by Taginfo during the update process and
+
Mappers and Wiki authors can use the '[http://wiki.openstreetmap.org/wiki/Template:RelatedTerm Template:RelatedTerm]' (local: [[Template:RelatedTerm]]). See there for further instructions.  
−
stored in Taginfo database (as it's already doing for the "tag" template). The terms
 
−
lists are then passed over to the Taginfo API. BTW: The "preferred term" ("Preferred
 
−
tag") can be estimated by the tag statistics API of Taginfo.
 
  
−
Theoretically parts of this code could be ported over to the search Taginfo (the Taginfo
+
Look for example at '[http://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship Tag:amenity=place_of_worship]'
−
API is already used now by our TagFinder).
+
to see how this template is being used.  
  
−
=== Projekt RelatedTerms in OSM 2011 ===
+
Here are some examples: <code><nowiki>{{RelatedTerm|castle}} {{RelatedTerm|villa}} {{RelatedTerm|ruin}}
 +
{{RelatedTerm|DE_ch|Schloss}} {{RelatedTerm|word1 word2}}</nowiki></code>
  
−
Dies ist die Realisierung des Lösungsansatzes. Koordination [[Benutzer:Stefan|Stefan]]
+
== Discussion ==
  
−
Das Projektvorhaben lässt sich in folgende Teilprojekte gliedern:
+
Of course it would be more precise to introduce synonyms and broader/narrower terms instead of the multipurpose 'related term'
−
# Teilprojekt RelatedTerm-Ersterfassung .
+
(see [http://en.wikipedia.org/wiki/Thesaurus Thesaurus] and [http://en.wikipedia.org/wiki/Thesaurus] on Wikipedia (en)).
−
# Teilprojekt Taginfo API 'relatedterms'.
+
But that seems too complicated for many users.  
−
# Teilprojekt Verbesserte Tag-Suche im [[POI-Service]].
 
−
# Teilprojekt RelatedTerm-Aktualisierung laufend durch OSM-Community.
 
  
−
Auf diesen Arbeiten aufbauend - insbesondere dem Taginfo API 'relatedterms' - kann dann z.B. auch in [[Taginfo]] und in [[JOSM]] eine verbesserte Tags- bzw. Presets-Suche realisiert werden.
+
Or you could hope there exists some "Google magic" which would collect and combine sources in order to find out the usage of tag.
 +
But that not going to happen - at least not so precise and effectiveness like the information the related terms provide.
  
−
== Verwandte Begriffe für Programmierer ==
+
How does it work? The related terms are parsed from the Wiki pages by [[TagFinder]] and
 +
stored in a SQLite database. TagFinder combines this information with othe sources like Taginfo.
 +
TagFinder in turn, offers an API which can be used by editors like JOSM.
  
−
Taginfo API neu mit Set von RelatedTerms aus beliebigen OSM-Wiki-Seiten (deutschen und englischen).
+
== Related Terms for Programmers ==
  
−
Taginfo API-Dokumentation siehe [[Taginfo]], [http://wiki.openstreetmap.org/wiki/Taginfo/API Taginfo/API] auf dem OSM Wiki und die [http://taginfo.openstreetmap.org/apidoc API doc] auf Taginfo.
+
Programmers can access related terms with RESTful webservices (HTTP GET with JSON response) to be defined and implemented yet.
  
−
The related terms are maintained by users in Template:RelatedTerm templates ([[Template:RelatedTerm|local]], auf [http://wiki.openstreetmap.org/wiki/Template:RelatedTerm OSM wiki]); [http://meta.wikimedia.org/wiki/Help:Template Help:Template] on MediaWiki.
+
* [[Taginfo]] API 'wiki/kvrp'
 +
* [[Taginfo]] API 'wiki/relatedterms'
 +
* [[TagFinder]] API 'findtag'
  
−
Programmers can access Taginfo instances with RESTful webservices (HTTP GET with JSON response) to be defined and implemented yet.
+
See the current work in progress at the discussion page.
−
 
 
−
Example result (mock up):
 
−
{"rp":0,
 
−
  "page":0,
 
−
  "data":[
 
−
    {"value":"castle", "count_all":3,"key":"historic "},
 
−
    ...
 
−
    ],
 
−
  "total":6
 
−
}
 
−
 
 
−
==== Taginfo API specification 'relatedterms' (Entwurf) ====
 
−
 
 
−
* Path: /api/2/wiki/relatedterms
 
−
* Description: Gegeben Term, gib RelatedTermList mit Statistik zurück.
 
−
* Parameters: q
 
−
* Paging: no
 
−
* Filter: english — Check for key wiki pages in any language (0, default) or in the English language (1).
 
−
* Sort: code, ranked?
 
−
* Result: ''(tbd.)''
 
−
* Example: http://taginfo.openstreetmap.ch/api/2/wiki/relatedterms?q=castle
 
−
* UI Example: none (see TagFinder in [[POI-Service]]).
 
−
 
 
−
==== Taginfo API specification 'relatedterms' (V.2) ====
 
−
 
 
−
* Path: /api/2/wiki/relatedterms
 
−
* Description: Gegeben Term, gib RelatedTermList mit Statistik zurück.
 
−
* Parameters: q
 
−
* Paging: no
 
−
* Filter: english — Check for key wiki pages in any language (0, default) or in the English language (1).
 
−
* Sort: code, ranked?
 
−
* Result: ''(tbd.)''
 
−
* Example: http://taginfo.openstreetmap.ch/api/2/wiki/relatedterms?q=castle
 
−
* UI Example: none (see TagFinder in [[POI-Service]]).
 
  
 
[[Kategorie:OpenStreetMap]]
 
[[Kategorie:OpenStreetMap]]

Aktuelle Version vom 9. November 2011, 17:43 Uhr

Related Term (de: Verwandter Begriff)

  • association relationship between terms, like synonym. A term can consist of one ore more words, like Lord's House.
  • de: Assoziationsbeziehung zwischen Begriffen wie z.B. Synonym (ein Term kann aus mehreren Worten bestehen, wie z.B. Lord's house).

Quicklinks:


The Problem

We want to improve the searching for OSM tags. Currently, when looking in OSM wiki or Taginfo for the tag of a "chapel" (where the correct tag is "amenity=place_of_worship"), it's not found! A crucial point there is that synonyms and related terms have to be there.

Here are some examples of terms currently not found in OSM Wiki nor in Taginfo:

  • Fussgängerstreifen (de_CH) => ?
  • Litfaßsäule (de_DE) => ?
  • Schloss (de) => ?
  • Geldinstitut
  • (please add yours...)

Here are some examples of terms only found because of redirect pages or other tricks:

  • chapel (en), Parkplatz (de) => amenity=place_of_worship (redirect)
  • Badeanstalt (de) DE:=> Howto_Map_A

The Solution

In order to achieve an enhanced search, a controlled word list (a term list, a thesaurus) becomes necessary. This is a list of synonyms where most are OpenStreetMap specific. This information can not be found in a general purpose thesaurus. So, we propose that mappers capture so-called "related terms" (synonyms) in the OSM wiki. These related terms are fully part of the OSM wiki page and can be kept up to date by the community (where I would like to set a good example). Tools like TagFinder can parse these info - among others - out of the wiki page and thus helps making the OSM database more accessible. 

 We encourage all to add also related terms when documenting OSM tags (key/values)!
 This will help enhance the search experience of all mappers!

The Template

Mappers and Wiki authors can use the 'Template:RelatedTerm' (local: Template:RelatedTerm). See there for further instructions.

Look for example at 'Tag:amenity=place_of_worship' to see how this template is being used.

Here are some examples: {{RelatedTerm|castle}} {{RelatedTerm|villa}} {{RelatedTerm|ruin}} {{RelatedTerm|DE_ch|Schloss}} {{RelatedTerm|word1 word2}}

Discussion

Of course it would be more precise to introduce synonyms and broader/narrower terms instead of the multipurpose 'related term' (see Thesaurus and [1] on Wikipedia (en)). But that seems too complicated for many users.

Or you could hope there exists some "Google magic" which would collect and combine sources in order to find out the usage of tag. But that not going to happen - at least not so precise and effectiveness like the information the related terms provide.

How does it work? The related terms are parsed from the Wiki pages by TagFinder and stored in a SQLite database. TagFinder combines this information with othe sources like Taginfo. TagFinder in turn, offers an API which can be used by editors like JOSM.

Related Terms for Programmers

Programmers can access related terms with RESTful webservices (HTTP GET with JSON response) to be defined and implemented yet.

See the current work in progress at the discussion page.

Von «https://giswiki.hsr.ch/index.php?title=RelatedTerms&oldid=35824»