Taginfo/RelatedTerm - Versionsgeschichte

Stefan: Der Seiteninhalt wurde durch einen anderen Text ersetzt: „See RelatedTerms“

2011-09-27T18:43:09Z

Der Seiteninhalt wurde durch einen anderen Text ersetzt: „See RelatedTerms“

← Nächstältere Version		Version vom 27. September 2011, 18:43 Uhr
Zeile 1:		Zeile 1:
	~~< [[Taginfo]]~~		See [[RelatedTerms]]

	~~Related Term (de: Verwandter Begriff) Assoziationsbeziehung zwischen Begriffen.~~

	~~>> Zur (bekannteren) englischen Dokumentation '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm auf dem OSM Wiki]'''.~~

	~~== Overview ==~~

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

	~~Here are some collected examples:~~
	* en: amenity=place_of_worship => church
	* de_CH: Fussgängerstreifen => ?
	* de_DE: Litfaßsäule => ?
	* (please add yours)

	~~=== The Solution ===~~

	~~In order to achieve this a controlled word list (a thesaurus) becomes necessary. This is~~
	~~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~~
	~~to date by the community (while I would like to set a good example).~~

	~~Of course it would be more precise to introduce also synonyms and broader/narrower terms.~~
	~~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.~~
	~~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~~
	~~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~~
	~~API is already used now by our TagFinder).~~

	~~=== Projekt~~ RelatedTerms ~~in OSM 2011 ===~~

	~~Dies ist die Realisierung des Lösungsansatzes. Koordination [[Benutzer:Stefan\|Stefan]]~~

	~~Das Projektvorhaben lässt sich in folgende Teilprojekte gliedern:~~
	~~# 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.~~

	~~== Verwandte Begriffe für Anwender und Wiki-Autoren ==~~

	~~Man verwende die Vorlage '[http://wiki.openstreetmap.org/wiki/Template:RelatedTerm Template:RelatedTerm]' (lokaler [[Template:RelatedTerm]]).~~

	~~=== Related Terms Test ===~~

	~~Funktioniert hier nicht ganz weil das Template Funktionen des neusten MediaWiki-Releases verwendet, die hier noch nicht vorhanden sind.~~

	~~Related Terms: {{RelatedTerm\|castle}} {{RelatedTerm\|villa}} {{RelatedTerm\|ruin}}~~
	~~{{RelatedTerm\|DE_ch\|Schloss}} {{RelatedTerm\|word1 word2}}~~

	~~== Verwandte Begriffe für Programmierer ==~~

	~~Taginfo API neu mit Set von RelatedTerms aus beliebigen OSM-Wiki-Seiten (deutschen und englischen). Taginfo API-Dokumentation siehe [[Taginfo]].~~

	~~The related terms are maintained by users in [[Template:RelatedTerm]] templates. See [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~~]]

Stefan: /* Overview */

2011-09-21T00:08:44Z

Overview

← Nächstältere Version		Version vom 21. September 2011, 00:08 Uhr
Zeile 12:		Zeile 12:

	Here are some collected examples:		Here are some collected examples:
	* EN: amenity=place_of_worship => church		* en: amenity=place_of_worship => church
	* ~~DE_ch~~: Fussgängerstreifen => ?		* de_CH: Fussgängerstreifen => ?
	* ~~DE_de~~: Litfaßsäule => ?		* de_DE: Litfaßsäule => ?
	* (please add yours)		* (please add yours)

Stefan am 7. September 2011 um 16:19 Uhr

2011-09-07T16:19:38Z

← Nächstältere Version		Version vom 7. September 2011, 16:19 Uhr
Zeile 5:		Zeile 5:
	>> Zur (bekannteren) englischen Dokumentation '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm auf dem OSM Wiki]'''.		>> Zur (bekannteren) englischen Dokumentation '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm auf dem OSM Wiki]'''.

	== ~~Überblick~~ ==		== Overview ==

	=== The Problem ===		=== The Problem ===
Zeile 17:		Zeile 17:
	* (please add yours)		* (please add yours)

	=== ~~Lösungsansatz~~ ===		=== The Solution ===

	In order to achieve this a controlled word list (a thesaurus) becomes necessary. This is		In order to achieve this a controlled word list (a thesaurus) becomes necessary. This is

Stefan: /* The Problem */

2011-09-07T16:19:04Z

The Problem

← Nächstältere Version		Version vom 7. September 2011, 16:19 Uhr
Zeile 9:		Zeile 9:
	=== 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". ~~One of the~~ crucial point there is that synonyms and related terms are found (term being one ore more words).		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 collected examples:		Here are some collected examples:

Stefan: /* Lösungsansatz */

2011-09-07T16:11:49Z

Lösungsansatz

← Nächstältere Version		Version vom 7. September 2011, 16:11 Uhr
Zeile 35:		Zeile 35:
	2. Ober- und Unterbegriffe und 3. verwandte Begriffe.)		2. Ober- und Unterbegriffe und 3. verwandte Begriffe.)

	=> In order to store related terms ~~I propose~~ to use wiki templates.		In order to store related terms are proposes to use wiki templates.
	~~That would look like this on a OSM~~ wiki page ~~(eg.~~		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.
	http://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship ):

	~~<nowiki>~~
	{{RelatedTerm~~\|place of worship}}~~
	{{RelatedTerm~~\|church}}~~
	~~{{RelatedTerm\|mosque}}~~
	~~{{RelatedTerm\|synagogue}}~~
	~~{{RelatedTerm\|en_GB\|devotion building}}~~
	~~{{RelatedTerm\|en_US\|prayer house}}~~
	~~</nowiki>~~

	The related terms are parsed from the Wiki pages by Taginfo during the update process and		The related terms are parsed from the Wiki pages by Taginfo during the update process and

Stefan: /* Lösungsansatz */

2011-09-07T16:07:16Z

Lösungsansatz

← Nächstältere Version		Version vom 7. September 2011, 16:07 Uhr
Zeile 39:		Zeile 39:
	http://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship ):		http://wiki.openstreetmap.org/wiki/Tag:amenity%3Dplace_of_worship ):

			<nowiki>
	{{RelatedTerm\|place of worship}}		{{RelatedTerm\|place of worship}}
	{{RelatedTerm\|church}}		{{RelatedTerm\|church}}
Zeile 45:		Zeile 46:
	{{RelatedTerm\|en_GB\|devotion building}}		{{RelatedTerm\|en_GB\|devotion building}}
	{{RelatedTerm\|en_US\|prayer house}}		{{RelatedTerm\|en_US\|prayer house}}
			</nowiki>

	The related terms are parsed from the Wiki pages by Taginfo during the update process and		The related terms are parsed from the Wiki pages by Taginfo during the update process and

Stefan am 7. September 2011 um 16:06 Uhr

2011-09-07T16:06:50Z

@@ Zeile 7: / Zeile 7: @@
 == Überblick ==
-=== Das Problem ===
+=== The Problem ===
 === Lösungsansatz ===
-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 achieve this a controlled word list (a thesaurus) becomes necessary. This is
 === Projekt RelatedTerms in OSM 2011 ===
-Die ist die Realisierung des Lösungsansatzes. Koordination [[Benutzer:Stefan|Stefan]]
+Dies ist die Realisierung des Lösungsansatzes. Koordination [[Benutzer:Stefan|Stefan]]
 Das Projektvorhaben lässt sich in folgende Teilprojekte gliedern:

Stefan am 7. September 2011 um 15:54 Uhr

2011-09-07T15:54:20Z

← Nächstältere Version		Version vom 7. September 2011, 15:54 Uhr
Zeile 3:		Zeile 3:
	Related Term (de: Verwandter Begriff) Assoziationsbeziehung zwischen Begriffen.		Related Term (de: Verwandter Begriff) Assoziationsbeziehung zwischen Begriffen.

	>> ~~Die Original-~~Dokumentation ~~ist~~ '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm ~~hier~~ auf dem OSM Wiki]'''.		>> Zur (bekannteren) englischen Dokumentation '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm auf dem OSM Wiki]'''.

	== Überblick ==		== Überblick ==

Stefan am 7. September 2011 um 15:53 Uhr

2011-09-07T15:53:40Z

← Nächstältere Version		Version vom 7. September 2011, 15:53 Uhr
Zeile 5:		Zeile 5:
	>> Die Original-Dokumentation ist '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm hier auf dem OSM Wiki]'''.		>> Die Original-Dokumentation ist '''[http://wiki.openstreetmap.org/Taginfo/RelatedTerm hier auf dem OSM Wiki]'''.

	=== ~~Überblick~~ ===		== Überblick ==

			=== Das Problem ===


			=== Lösungsansatz ===

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

	=== Verwandte Begriffe für Anwender und Wiki-Autoren ===		=== Projekt RelatedTerms in OSM 2011 ===

			Die ist die Realisierung des Lösungsansatzes. Koordination [[Benutzer:Stefan\|Stefan]]

			Das Projektvorhaben lässt sich in folgende Teilprojekte gliedern:
			# 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.

			== Verwandte Begriffe für Anwender und Wiki-Autoren ==

	Man verwende die Vorlage '[http://wiki.openstreetmap.org/wiki/Template:RelatedTerm Template:RelatedTerm]' (lokaler [[Template:RelatedTerm]]).		Man verwende die Vorlage '[http://wiki.openstreetmap.org/wiki/Template:RelatedTerm Template:RelatedTerm]' (lokaler [[Template:RelatedTerm]]).
Zeile 18:		Zeile 35:

	Related Terms: {{RelatedTerm\|castle}} {{RelatedTerm\|villa}} {{RelatedTerm\|ruin}}		Related Terms: {{RelatedTerm\|castle}} {{RelatedTerm\|villa}} {{RelatedTerm\|ruin}}
	{{RelatedTerm\|DE_ch\|Schloss}}		{{RelatedTerm\|DE_ch\|Schloss}} {{RelatedTerm\|word1 word2}}

	==~~= Related terms for programmers =~~==		== Verwandte Begriffe für Programmierer ==

	Taginfo API neu mit Set von RelatedTerms aus beliebigen OSM-Wiki-Seiten (deutschen und englischen). Taginfo API-Dokumentation siehe [[Taginfo]].		Taginfo API neu mit Set von RelatedTerms aus beliebigen OSM-Wiki-Seiten (deutschen und englischen). Taginfo API-Dokumentation siehe [[Taginfo]].
Zeile 61:		Zeile 78:
	* Example: http://taginfo.openstreetmap.ch/api/2/wiki/relatedterms?q=castle		* Example: http://taginfo.openstreetmap.ch/api/2/wiki/relatedterms?q=castle
	* UI Example: none (see TagFinder in [[POI-Service]]).		* UI Example: none (see TagFinder in [[POI-Service]]).


	[[Kategorie:OpenStreetMap]]		[[Kategorie:OpenStreetMap]]

Stefan am 7. September 2011 um 15:13 Uhr

2011-09-07T15:13:51Z

← Nächstältere Version		Version vom 7. September 2011, 15:13 Uhr
Zeile 26:		Zeile 26:
	The related terms are maintained by users in [[Template:RelatedTerm]] templates. See [http://meta.wikimedia.org/wiki/Help:Template Help:Template] on MediaWiki.		The related terms are maintained by users in [[Template:RelatedTerm]] templates. See [http://meta.wikimedia.org/wiki/Help:Template Help:Template] on MediaWiki.

	~~===~~ Taginfo ~~API specification 'relatedterms' ===~~		Programmers can access Taginfo instances with RESTful webservices (HTTP GET with JSON response) to be defined and implemented yet.

	~~HTTP GET parameter and a 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
			}

	* Path: /api/2/wiki/relatedterms		==== Taginfo API specification 'relatedterms' (Entwurf) ====
	* Description: Gegeben Term, gib RelatedTermList mit Statistik zurück.
	* Parameters: q		* Path: /api/2/wiki/relatedterms
	* Paging: no		* Description: Gegeben Term, gib RelatedTermList mit Statistik zurück.
	* Filter: english — Check for key wiki pages in any language (0, default) or in the English language (1).		* Parameters: q
	* Sort: code, ranked?		* Paging: no
	* Result: ''(tbd.)''		* Filter: english — Check for key wiki pages in any language (0, default) or in the English language (1).
	* Example: http://taginfo.openstreetmap.ch/api/2/wiki/relatedterms?q=castle		* Sort: code, ranked?
	* UI Example: none (see TagFinder in [[POI-Service]]).		* 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]]).

	~~Example result:~~
	~~{"rp":0,~~
	~~"page":0,~~
	~~"data":[~~
	~~{"value":"castle", "count_all":3,"key":"historic "},~~
	~~...~~
	],
	~~"total":6~~
	}

	[[Kategorie:OpenStreetMap]]		[[Kategorie:OpenStreetMap]]