Changes

The '''{{man label|Place Cleanup Gramplet'''is an add-on that }} addon uses the WebServices feature from the [https://www.geonames.org/about.html GeoNames.org geographical database] to lookup as many as 2,000 placenames per day. ''See '''[[GeoCodes#Filters|GeoCodes]]'''.)'' Selected parts of the validated information can then be pushed into Gramps to correct and improve incomplete [[Gramps_Glossary#place|Place]] records.

[[File:PlaceCleanupPref.png|thumb|left|44px|alt="Preferences icon"]][[File:PlaceCleanupPrefDialog.png|thumb|right|350px|Place Cleanup Gramplet - Preferences]]

* ☑{{checkbox|0man label|Keep Web Links}} checkbox. The GeoNames database contains various URL links to other web data, associated with each place. For example, many places have a Wikipedia link. If you check this setting, the Gramplet will save these web links with the place data. They will appear in the 'Internet' tab of the Place Edit dialog.* ☑{{checkbox|0man label|Add citation and source to Place}} checkbox. If you check this setting, a Citation will be added to each place, citing the 'GeoNames' Source and Repository, with the Citation having a 'Volume/Page:' value with the GeoNames ID number. There will be a Citation for each Place, but only a single Source and Repository.

* {{man label|Alternative Names Languages to keep}} field. This contains a space separated list of the [https://wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639 -1] 2-letter language code; (: <code><abbr title="English">en,</abbr> <abbr title="Deutsch">de,</abbr> <abbr title="français">fr,</abbr> <abbr title="Italiano">it,</abbr> <abbr title="Español">es</abbr></code>,...)et cetera. As you work with the Gramplet, you will see a list of alternate names available for most places, with the language code for the names. If you want these names automatically checked off for inclusion in your Gramps place, add the code to this field.

** &#x1F53E; {{man label|[[File:RadioButton_Selected.png|21px]]Keep current Enclosure}} [https://wikipedia.org/wiki/Radio_button radio button selector.] If you select this setting, and your place is already 'Enclosed by' another place, then no changes to the 'Enclosed by' place value will be made, even if your current enclosing place differs from that provided by the GeoNames data.

** &#x25C9; {{man label|[[File:RadioButton_Deselected.png|21px]]Replace with GeoNames Enclosure}} [https://wikipedia.org/wiki/Radio_button radio button selector.] If you select this setting, and your place is already 'Enclosed by' another place, then the current enclosure is replaced by the enclosing place from the GeoNames data. If it did not exist before this, it will then be created, and selected for approval.

{{man warn|Use some extra caution when changing the Title field|The place data found and pushed to update the Place view will depend on the contents of this field. If you change it in inappropriate ways, you could end up with mismatched place data. <br />For example, if the originally active record in the Place view is "Berlín, Usulután", and you manually type in a Place title of "Berlin, Germany" to search, when you find ''and accept'' the Berlin place, your originally selected Place view record for the municipality in El Salvador will be changed to Europe!}}

:: There are two columns in this list, the names, and the 'Types' columns. The names are comma separated places in the hierarchy, as found in the local database, or in GeoNames. The 'Type' column in the Places view shows the Gramps Type, when showing places from the local database, and shows [https://www.geonames.org/export/codes.html GeoNames types Feature Codes] that includes a Feature class letter followed by a colon, then a type) when showing results from the GeoNames search.{{man notetip|NOTEAvoiding rework|If you search GeoNames for a place in GeoNames that you is already have in your database, the search results may return some entries annotated with a red strikethrough. This indicates that those places are already enclosed by the current place and cannot be selected. }}:: The Type column is provide for informational use only, to help the user determine a bit more about the found place. The GeoNames types Feature Codes are not always obvious; the type [https://poldham.github.io/places/reference/featurecodes.html#format type format] starts with a 'class'; one of 'A'(Administrative place), 'P'(Populated place), or 'S' for 'Administrative place'(Spot). (Of the 9 GeoNames classes, searching <abbr title="Hydrographic Features">H</abbr>, <abbr title="Area Features">L</abbr>, <abbr title="Road / Railroad Features">R</abbr>, <abbr title="Hypsographic Features">T</abbr>, 'Populated place'<abbr title="Undersea Features">U</abbr>, or 'Spot' respectively<abbr title="Vegetation Features">V</abbr> is not supported. ) You can restrict the returned search matches to desired categories with the matching Checkboxes (see below). The remaining part of the type field for GeoNames can be decoded from [http://www.geonames.org/export/codes.html| http://www.geonames.org/export/codes.html], if desired.* &#x2611;{{checkbox|0man label|Populated}} checkbox. If you check this setting, 'Populated Places' (typically cities, towns, villages etc.) will be returned for a GeoNames search. This setting does not affect a local database search. This is initially enabled, as it allows the search to return what most people expect for a city type search.* &#x2611;{{checkbox|0man label|Admin}} checkbox. If you check this setting, '[[Gramps_Glossary#administrative_division|Administrative PlacesDivisions]]' (countries, states, regions etc.) will be returned for a GeoNames search. This setting does not affect a local database search. . This is initially enabled, as it allows the search to return what most people expect for a county, state, country type search.* &#x274f;{{checkbox|0man label|Spot}} checkbox. If you check this setting, 'Spots' (typically farms, buildings, graveyards, churches etc.) will be returned for a GeoNames search. This setting does not affect a local database search. This is initially disabled, as most place searches don't go to this level of detail.

* {{man button|Find}} button. This performs a search for the place placename indicated in the {{man label|Title}} field. The search is performed in two stages.:** Initially , the local Gramps place list is examined for a match. The local match is only searched among 'Complete' places, those with Latitude/Longitude coordinates and Place Type data filled in. Only the initial segment of the place is used for searching. For example, if you search for 'Paris, FR', and your local Gramps Place Tree data has both 'Paris, Lamar, Texas, United States' and 'Paris, Paris, Île-de-France, France', both will be shown. Alternative names in the local Gramps places are also searched.** The second stage is the GeoNames search. It is performed automatically if the first stage doesn't find any matches. If the first stage did find one or more matches, but none of them were correct, the user can press the {{man button|Find}} button again to do the GeoNames search. Note that the Web Service of the GeoNames search can return only returns ten results at a time, if . If the place you want is not in the first set subset of results, press the {{man button|Find}} button again to see the next ten.{{man note|NOTEFind shops locally before resorting to the net|The 'Find' button changes to 'Find GeoNames' after a local database search where something was found, as . This is a reminder that you can search that online database if the local search did not return what you wanted.}}