GeoNames extractors
| Line 5: | Line 5: | ||
[[Image:Geonames_search.gif|center]] | [[Image:Geonames_search.gif|center]] | ||
| + | |||
Available extractors are | Available extractors are | ||
| Line 33: | Line 34: | ||
|- | |- | ||
| Children | | 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. |
| + | |||
| + | 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'''. | ||
| + | |||
| + | 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 | | Heirarchy | ||
Revision as of 15:28, 11 December 2008
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 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.
Available extractors are
| Tab | Description |
| Search | Performs free text search to GeoNames database. User may filter result set with optional continent, country, and feature class filters. All filters are selected using drop down selection. User can also require the search term is part of the place name. |
| Near by | Performs coordinate search to GeoNames database. User gives extractor latitude and longitude coordinate, radius in kilometers, and optional feature class. Result set contains geographical location in specified area. If user has already performed GeoNames extractions and has selected one geo-topic with latitude and longitude coordinates, user can get coordinates from the context topic. |
| Country info | Reads country information from GeoNames database. Country name is selected from drop down menu. Optionally user can write country name or multiple country names to the field. Special keyword ALL reads information for all known countries. If user has already performed GeoNames extractions or has country name available in topic for some other reason, user can pick up the country name from context topics. |
| Cities | Reads cities in given bounding box from GeoNames database. Bounding box has four different geographical coordinates:
If user has already performed GeoNames extractions and has suitable topic selected, Get context button reads available coordinates from the topic. For example, Country info extraction sets bounding box for each country topic, and user could use this bounding box to continue extracting cities of the country. |
| 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.
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. 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 | |
| Neighbours | |
| Siblings | |
| Weather | |
| Wikipedia search | |
| Wikipedia b-box |
Country Info
Cities
Children
