GeoNames extractors - Revision history

Akivela: Geonames extractors moved to GeoNames extractors

2011-09-19T09:11:11Z

Geonames extractors moved to GeoNames extractors

Akivela at 12:40, 9 January 2010

2010-01-09T12:40:10Z

Akivela at 10:24, 28 March 2009

2009-03-28T10:24:50Z

Akivela at 13:19, 14 December 2008

2008-12-14T13:19:03Z

Akivela: /* Known issues */

2008-12-14T13:17:44Z

‎Known issues

Akivela: /* Example */

2008-12-11T13:21:31Z

‎Example

Akivela at 13:21, 11 December 2008

2008-12-11T13:21:16Z

Akivela at 13:18, 11 December 2008

2008-12-11T13:18:16Z

Akivela at 13:01, 11 December 2008

2008-12-11T13:01:30Z

Akivela at 12:52, 11 December 2008

2008-12-11T12:52:54Z

@@ Line 36: / Line 36: @@
 | Reads direct geo locations within given geo location known by GeoNames database. For example, if user gets children of Europe, the result set contains all countries in Europe. For example, if user gets children of France, the result set contains all first level administrative areas of France (but *not* cities as you might assume). Children extractor assumes you specify the parent geo location using special GeoNames identifier.
-GeoNames identifier is a 7-digit number sequence. Whenever available, Wandora adds GeoNames originating topics subject identifier constructed with GeoNames identifier. For example country Algeria has GeoNames identifier 2589581. When Wandora creates a topic for Algeria, topic gets subject identifier '''http://www.geonames.org/geonameid/2589581'''.
+GeoNames identifier is a 7-digit number sequence. Whenever available, Wandora adds GeoNames originating topics subject identifier constructed with GeoNames identifier. For example country Algeria has GeoNames identifier 2589581. When Wandora creates a topic for Algeria, topic gets subject identifier '''http://www.geonames.org/2589581'''. One should note, the subject identifier actually resolves to a HTML page of Algeria hosted by GeoNames.
 Children extractor can read the GeoNames identifier from context topics, if they carry valid GeoNames subject identifier. Thus, Children extractor is usually *not* the first extractor used as it assumes user remembers identifier numbers. However, later on, when there is geo topics available, it is rather easy to use existing identifiers.

← Older revision		Revision as of 10:24, 28 March 2009
Line 1:		Line 1:
	[http://www.geonames.org/ GeoNames] is a very large networked database of geographical locations and related data. GeoNames contains over eight million geographical names and 6.5 million unique features. GeoNames database is available for free of charge under a creative commons attribution license. GeoNames has [http://www.geonames.org/export/ws-overview.html a web service api] with various different query types.		[http://www.geonames.org/ GeoNames] is a very large networked database of geographical locations and related data. GeoNames contains over eight million geographical names and 6.5 million unique features. GeoNames database is available for free of charge under a creative commons attribution license. GeoNames has [http://www.geonames.org/export/ws-overview.html a web service api] with various different query types.

−	Wandora's GeoNames extractor performs GeoNames web service api requests and converts results to topic maps formats. Wandora is a graphical front end to GeoNames web service api, if you like. Extractor starts with menu option '''File > Extract > GeoNames extractor...'''. Current extractor has several options as image below views. By default extractor performs free text search to GeoNames geographical database.	+	Wandora's GeoNames extractor performs GeoNames web service api requests and converts results to topic maps formats. Wandora is a graphical front end to GeoNames web service api, if you like. Extractor starts with menu option '''File > Extract > Other > GeoNames extractor...'''. Current extractor has several options as image below views. By default extractor performs free text search to GeoNames geographical database.

@@ Line 34: / Line 34: @@
 |-
 | Children
-| Reads direct geo locations within given geo location known by GeoNames database. For example, if user gets children of Europe, the result set contains all countries in Europe. For example, if user gets children of France, the result set contains all first level administrative areas of France (but *not* cities as you might assume). Children extractor assumes you specify the parent geo location using special GeoNames identifiers.
+| Reads direct geo locations within given geo location known by GeoNames database. For example, if user gets children of Europe, the result set contains all countries in Europe. For example, if user gets children of France, the result set contains all first level administrative areas of France (but *not* cities as you might assume). Children extractor assumes you specify the parent geo location using special GeoNames identifier.
 GeoNames identifier is a 7-digit number sequence. Whenever available, Wandora adds GeoNames originating topics subject identifier constructed with GeoNames identifier. For example country Algeria has GeoNames identifier 2589581. When Wandora creates a topic for Algeria, topic gets subject identifier '''http://www.geonames.org/geonameid/2589581'''.

← Older revision		Revision as of 13:17, 14 December 2008
Line 79:		Line 79:

	* Performing many sequential extractions may cause identity doubling. Identity doubling means topic map contains multiple topics that are essentially identical and should be merged but for some reason topics don't share subject identifier, base name, or subject locator, and topics are never merged. For example, extracting country info and then continuing with neighbour extractions results duplicate topics for all neighbour countries. This issue will be fixed in near future releases!		* Performing many sequential extractions may cause identity doubling. Identity doubling means topic map contains multiple topics that are essentially identical and should be merged but for some reason topics don't share subject identifier, base name, or subject locator, and topics are never merged. For example, extracting country info and then continuing with neighbour extractions results duplicate topics for all neighbour countries. This issue will be fixed in near future releases!
−	* Two Wikipedia related GeoNames extractors generate topic map fragments not compatible with other GeoNames extrators. You have to merge equivalent topics manually to prevent identity duplication.	+	* Two Wikipedia related GeoNames extractors generate topic map fragments are not compatible with other GeoNames extrators. You have to merge equivalent topics manually to prevent identity duplication.

← Older revision		Revision as of 13:21, 11 December 2008
Line 74:		Line 74:
	== Example ==		== Example ==

		+	TODO

	== Known issues ==		== Known issues ==

← Older revision		Revision as of 13:21, 11 December 2008
Line 78:		Line 78:

	* Performing many sequential extractions may cause identity doubling. Identity doubling means topic map contains multiple topics that are essentially identical and should be merged but for some reason topics don't share subject identifier, base name, or subject locator, and topics are never merged. For example, extracting country info and then continuing with neighbour extractions results duplicate topics for all neighbour countries. This issue will be fixed in near future releases!		* Performing many sequential extractions may cause identity doubling. Identity doubling means topic map contains multiple topics that are essentially identical and should be merged but for some reason topics don't share subject identifier, base name, or subject locator, and topics are never merged. For example, extracting country info and then continuing with neighbour extractions results duplicate topics for all neighbour countries. This issue will be fixed in near future releases!
		+	* Two Wikipedia related GeoNames extractors generate topic map fragments not compatible with other GeoNames extrators. You have to merge equivalent topics manually to prevent identity duplication.

@@ Line 66: / Line 66: @@
 |-
 | Wikipedia search
+| GeoNames database contains also geographical locations provided by Wikipedia. Wikipedia search extractor performs free text search to Wikipedia data and returns geographical locations that have search word in their Wikipedia page.
 |-
 | Wikipedia b-box
+| Wikipedia b-box tab reads geographical locations within given bounding box provided by Wikipedia.
 |}

← Older revision		Revision as of 13:01, 11 December 2008
Line 71:		Line 71:
	\|		\|
	\|}		\|}
		+
		+	== Example ==
		+
		+
		+	== Known issues ==
		+
		+	* Performing many sequential extractions may cause identity doubling. Identity doubling means topic map contains multiple topics that are essentially identical and should be merged but for some reason topics don't share subject identifier, base name, or subject locator, and topics are never merged. For example, extracting country info and then continuing with neighbour extractions results duplicate topics for all neighbour countries. This issue will be fixed in near future releases!

@@ Line 40: / Line 40: @@
 Children extractor can read the GeoNames identifier from context topics, if they carry valid GeoNames subject identifier. Thus, Children extractor is usually *not* the first extractor used as it assumes user remembers identifier numbers. However, later on, when there is geo topics available, it is rather easy to use existing identifiers.
 |-
-| Heirarchy
+| Hierarchy
+| Reads upward hierarchy of given geo location. Upward hierarchy is geo location chain from current geo location to the globe. For example, hierarchy of Finland contains geo locations Europe and Globe.
 |-
 | Neighbours
+| Reads geo locations that are geographically neighbours of given geo location. For example, Finland's neighbours are Norway, Russia, and Sweden. Current web service returns neighbours for countries only.
 |-
 | Siblings
+| Reads geo locations that locate in same geo area and are same type than given geo location. For example, siblings of Finland are all other countries in Europe.
 |-
 | Weather
+| Reads latest weather observation of nearest weather station at given geo coordinates. Weather observation contains for example
 |-
 | Wikipedia search
@@ Line 58: / Line 71: @@
+|
 |}