CINXE.COM

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" > <title>GeoNames User Manual</title> <link rel="search" type="application/opensearchdescription+xml" title="geonames" href="http://www.geonames.org/opensearch-description.xml"> <link href="/geonames.ico" rel="shortcut icon"> <link rel="StyleSheet" href="/geonames.css" type="text/css"> </head> <body> <table id="topmenutable"><tbody><tr> <td class="topmenu"> <a href="http://www.geonames.org/">GeoNames Home</a> | <a href="http://www.geonames.org/postal-codes/">Postal Codes</a> | <a href="http://www.geonames.org/export/">Download / Webservice</a> | <a href="http://www.geonames.org/about.html">About</a> |</td> <td class="topsearch"> <form class="topsearch" name="searchForm" method="post" action="/servlet/geonames" onsubmit="javascript:fulltextsearch();return false;"> search <input class="topmenu" name="q" size="20" value="" type="text"> <input name="srv" value="1" type="hidden"> </form> </td></tr> </tbody></table> <h3>GeoNames User Manual</h3> <h4>Overview</h4> <div style="margin-left:100px; text-align:left; "> GeoNames has a simple edit interface that allow users to edit GeoNames information, move a point and add new place names to the GeoNames database. You find the edit interface on top of the google maps display. Click on a marker to open the information window with detail information about the place. In the information window you find a couple of menu links to view detail information like alternate names or the modification history of a place. The <a href="http://www.geonames.org/recent-changes.html">most recent updates</a> are available as html page and as rss feed. <br/> In the information window you find also a couple of links to modifiy the information. You can add the basic information like name, population or elevation. You can move a point on the map/satellite display. You can edit the alternate names for a place, this means you can edit other names like 'Big Apple' for 'New York', or 'Nueva York' the Spanish name for 'New York'. <br/> <br/> In the following we will look at screenshots and cover the following topics : <ul> <li><a href="#account">the user account</a> <li><a href="#info">the information window</a> <li><a href="#edit">edit GeoNames basic information</a> <li><a href="#move">move point</a> <li><a href="#alternateNames">edit alternate names</a> <li><a href="#create">Add a new placename to the GeoNames database</a> </ul> <br/> <br/> <a name="account"></a><h4>The GeoNames Account</h4> In order to modify features and insert new features you will need a GeoNames user account. You can create one here: <a href="http://www.geonames.org/login">http://www.geonames.org/login</a> <br/> <a name="info"></a><h4>The GeoNames Information Window</h4> Click on a marker on the maps/satellite display to open the information window. The information window shows detail information about a place like population, elevation, administrative hierarchy, link to wikipedia and more.<br/> At the bottom of the information window you find menu links for further information like alterate names and you find menu links to modify the information. <br/> <br/> <img src="/img/manual-info.jpg" alt alt="information window"> <br/> <br/> <br/> <br/> <a name="edit"></a><h4>Edit GeoNames Basic Information</h4> Clicking on the 'edit' link in the information window opens a form to edit the information. In the screenshot below we add the elevation to the mountain 'Säntis'. <br/> <br/> <img src="/img/manual-edit.jpg" alt alt="edit"> <br/> <br/> <br/> <br/> <a name="move"></a><h4>Move a point</h4> In order to correct the coordinates of a place click the 'move' link. You can now either enter gps latitude and longitude or click on the correct location on the map. <br/> <br/> <img src="/img/manual-move.jpg" alt alt="screenshot move"> <br/> <br/> <br/> <br/> <a name="alternateNames"></a><h4>Edit Alternate Names</h4> Alternate names are used to store and display name variants. In the screenshot below we add the Italian name 'San Gallo' to the first order division 'Sankt Gallen'. We set the 'is short name' flag to indicate that this is a short name for the long name 'Cantone di San Gallo'. <p> Guidelines: <p> <ul> <li> the main name for the toponym should be a widely accepted international or English name. Local languages are entered as alternate names. <li> The language code for the alternate names are normally the 2-character <a href="http://www.loc.gov/standards/iso639-2/php/English_list.php">ISO 639 language codes</a>, for more exotic languages that do not have a 2-character ISO code the 3-character code is used instead. Some pseudo language codes are used to mark other entries like postal codes, abbreviations or links (see below). <li> the flag 'isPreferred' helps distinguish between several alternate names in the same language. It marks the most commonly used name. <li> proper casing should be used. Upper case only for the first character of a term or for abbreviations. <li> avoid redundancy. Do not add the same name with 'minus' and blanks between terms, only add the more often use spelling variant in this case. (Ex: "La Colle sur Loup" for "La Colle-sur-Loup", it is sufficient to add "La Colle-sur-Loup" as the geonames search engine can handle searches with or without minus.) <li> use full spelling for 'Sankt' (German), 'Saint' and 'Sainte' (French). The respective abbreviations St. and Ste. are automatically handled by the search engine. </ul> <br/> The language code is referring to the ISO-639-2 and ISO-639-3 codes. Some Examples: <ul> <li> empty language code: a default name generally understood or with unknown language. <li> en (English) <li> fr (French) <li> he (Hebrew) <li> uk (Ukrainian) <br/> ... <li> zh (Chinese) <li> wuu (Simplified Chinese) <li> yue (Traditional Chinese) <li> pny (Pinyin Chinese) </ul> <br/> Pseudo codes: <p> <ul> <li>‘<strong>post</strong>‘ for postal codes</li> <li>‘<strong>link</strong>‘ for a link to a website, in particular links to the English wikipedia article, but also links to other languages in wikipedia or to other websites about the toponym.</li> <li> ‘<strong>iata</strong>‘, ‘<strong>icao</strong>‘ ,‘<strong>faac</strong>‘ ,‘<strong>tcid</strong>‘ and ‘<strong>unlc</strong>‘ for the respective airport codes</li> <li>‘<strong>abbr</strong>‘ for an abbreviation</li> <li>‘<strong>wkdt</strong>‘ wikidata id</li> <li>‘<strong>phon</strong>‘ phonetics</li> <li>‘<strong>piny</strong>‘ pinyin</li> <li>‘<strong>fr_1793</strong>‘ for names used during the French Revolution</li> </ul> <br/> <br/> <img src="/img/manual-altname.jpg" alt alt="screenshot edit alternate names"> <br/> <br/> <br/> <br/> <a name="create"></a><h4>Add a new placename to the GeoNames database</h4> <br/> In the control panel left to the map you find a couple of buttons. <br/> <br/> For the creation of new place names go to the location of the new place name and press the 'new' button. If you have the gps coordinates of your place you can enter latitude 'comma' longitude in the search box and press 'showOnMap'. In any case you have to go to the map location of the place to be added to make sure the place does not already exist. <br/> You don't have to enter country and administrative division in the entry form. These information will automatically be 'reverse geocoded' from the location of the place during the save process. <br/> You have to be logged in to add a place name. This restriction helps to prevent vandalism. <p> Guidelines : <p> <ul> <li>make sure the place does not already exist <li> don't add irrelevant places like your own house. There are other projects such as <a href="http://www.tagzania.com">tagzania</a> for places of only personal interest. <li> find the best feature class and feature code for the new place name <li> the default name of the place name should be the single widely accepted international or English name. Add names in local languages as alternate names. </ul> </div> <br/> <br/> <img src="/img/manual-add-name-1.jpg" alt="screen shot 1"> <br/> <br/> <br/> <div style="margin-left:100px; text-align:left; "> After pressing the add button you point with the mouse to the location of the new place name on the map. As soon as you have clicking on the map an edit form will open and you enter the place name, the feature class and the feature code of the new place name. Optionally you may also add elevation and population. </div> <br/> <img src="/img/manual-add-name-2.jpg" alt="screen shot 2"> <br/> <br/> <br/> <div style="margin-left:100px; text-align:left; "> Country (Switzerland) and administrative division (Ticino) are automatically derived. <br/> <img src="/img/manual-add-name-3.jpg" alt="screen shot 3"> </div> <p> <p> <p> <p>  <div id="pageFooter"> info@geonames.org <img src="/img/smallant.gif" alt="ant" align="middle" hspace="40" border="0"> <p> <a href="/">GeoNames Home</a> <span class="separator">•</span> <a href="/postal-codes/">Postal Codes</a> <span class="separator">•</span> <a href="/export/">Download / Webservice</a> <span class="separator">•</span> <a href="http://forum.geonames.org">Forum</a> <span class="separator">•</span> <a href="http://geonames.wordpress.com">Blog</a> <span class="separator">•</span> <a href="/sitemap.html">Sitemap</a> </p> </div> </body> </html>