RelatedTerms: Unterschied zwischen den Versionen

Aus Geoinformation HSR
Wechseln zu: Navigation, Suche
(→‎Verwandte Begriffe für Anwender und Wiki-Autoren)
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]'''.
+
   >> '''[http://wiki.openstreetmap.org/RelatedTerms documentation on OSM Wiki]'''.
  
−
== Overview ==
+
== The Problem ==
  
−
=== 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.
  
−
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).  
+
Here are some examples of terms currently not found in OSM Wiki nor in Taginfo:
 +
* chapel (en) => amenity=place_of_worship  
 +
* Fussgängerstreifen (de_CH) => ?
 +
* Litfaßsäule (de_DE) => ?
 +
* (please add yours...)
  
−
Here are some collected examples:
+
== The Solution ==
−
* en: amenity=place_of_worship => church
 
−
* de_CH: Fussgängerstreifen => ?
 
−
* de_DE: Litfaßsäule => ?
 
−
* (please add yours)
 
  
−
=== 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).
  
−
In order to achieve this a controlled word list (a thesaurus) becomes necessary. This is
+
Mappers and Wiki authors can use the '[http://wiki.openstreetmap.org/wiki/Template:RelatedTerm Template:RelatedTerm]' (local: [[Template:RelatedTerm]]). See there for further instructions. Look for example at '[http://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship Tag:amenity=place_of_worship]' to see how this template is being used.  
−
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
+
Here you see an experimental view of with a modified local template:
−
to date by the community (while I would like to set a good example).
+
  Related Terms: {{RelatedTerm|castle}} {{RelatedTerm|villa}} {{RelatedTerm|ruin}}
 +
  {{RelatedTerm|DE_ch|Schloss}} {{RelatedTerm|word1 word2}}
  
−
Of course it would be more precise to introduce also synonyms and broader/narrower terms.
+
== Discussion ==
−
But that seems too complicated for many users. (Hintergrund (aus: [
 
−
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.
+
Of course it would be more precise to introduce synonyms and broader/narrower terms instead of the multipurpose 'related term'
−
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.
+
(see [http://en.wikipedia.org/wiki/Thesaurus Thesaurus] and [http://en.wikipedia.org/wiki/Thesaurus] on Wikipedia (en)).
 +
But that seems too complicated for many users.  
  
−
The related terms are parsed from the Wiki pages by Taginfo during the update process and
+
Or you could hope there exists some "Google magic" which would collect and combine sources in order to find out the usage of tag.
−
stored in Taginfo database (as it's already doing for the "tag" template). The terms
+
But that not going to happen - at least not so precise and effectiveness like the information the related terms provide.
−
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
+
How does it work? The related terms are parsed from the Wiki pages by [[TagFinder]] and
−
API is already used now by our TagFinder).
+
stored in a SQLite database. TagFinder uses Taginfo API when looking at statistics.  
  
−
=== Projekt RelatedTerms in OSM 2011 ===
+
== Project Management ==
  
−
Dies ist die Realisierung des Lösungsansatzes. Koordination [[Benutzer:Stefan|Stefan]]
+
See [[Diskussion:RelatedTerms]] (german).
  
−
Das Projektvorhaben lässt sich in folgende Teilprojekte gliedern:
+
== Related Terms for programmers ==
−
# Teilprojekt RelatedTerm-Ersterfassung .
 
−
# Teilprojekt Taginfo API 'relatedterms'.
 
−
# 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.
+
Programmers can access related terms with RESTful webservices (HTTP GET with JSON response) to be defined and implemented yet.
  
−
== Verwandte Begriffe für Programmierer ==
+
* Taginfo API specification 'relatedterms'
−
 
+
* Taginfo API specification 'relatedterms'
−
Taginfo API neu mit Set von RelatedTerms aus beliebigen OSM-Wiki-Seiten (deutschen und englischen).
 
  
 
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.
 
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.
−
 
−
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.
 
−
 
−
Programmers can access Taginfo instances with RESTful webservices (HTTP GET with JSON response) to be defined and implemented yet.
 
−
 
−
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]]

Version vom 27. September 2011, 23:29 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). 
 >> documentation on OSM Wiki.

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:

  • chapel (en) => amenity=place_of_worship
  • Fussgängerstreifen (de_CH) => ?
  • Litfaßsäule (de_DE) => ?
  • (please add yours...)

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).

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 you see an experimental view of with a modified local template: 

 Related Terms: {{ #if:  | {{{2}}} (castle) | castle}}.  {{ #if:  | {{{2}}} (villa) | villa}}.  {{ #if:  | {{{2}}} (ruin) | ruin}}. 
 {{ #if: Schloss | Schloss (DE_ch) | DE_ch}}.  {{ #if:  | {{{2}}} (word1 word2) | 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 uses Taginfo API when looking at statistics.

Project Management

See Diskussion:RelatedTerms (german).

Related Terms for programmers

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

  • Taginfo API specification 'relatedterms'
  • Taginfo API specification 'relatedterms'

Taginfo API-Dokumentation siehe Taginfo, Taginfo/API auf dem OSM Wiki und die API doc auf Taginfo.

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