Jump to: navigation, search


54 bytes added, 04:20, 29 December 2018
no edit summary
{{Third-party plugin}}
{{man menu|Released for Gramps 5.0 versions}}
[[File:PlaceCleanupMain.png|thumb|right|547px450px|Place Cleanup Gramplet]] Place Cleanup Gramplet.  
== Purpose of this Gramplet ==
This was written to assist in cleaning up '''already existing''' places. You can use it for a new place, but the place must be created with the normal Gramps {{man menu|Add ->Place}} and select the new place in the top window prior to using the Gramplet.
Often when starting with Gedcom GEDCOM imported trees, or when adding events from census or other sources, the Places that are created are not fully filled in with Latitude/Longitude and Enclosure information. The place names and/or titles are often left with strings of comma separated names that previously required a lot of manual work to clean it up.
In other cases, Places may have been entered with proper enclosure hierarchy, but without the Latitude/Longitude needed to show up on Gramps Maps.
{{man warn|1=Warning: As always, Back up you current tree BEFORE using this tool.
See [[How to make a backup|make a Gramps XML backup]]|2= While it is possible to Undo changes individually, at least within a session, you may decide that you need to restart from an earlier state.}}
== Installing the Place Cleanup Gramplet ==
The Gramplet can be installed like any other Addon; see {{man label|[[5.0_Addons#Installing_Addons_in_Gramps|Installing Addons in Gramps]]}}
Once installed, you should go to {{man label|Places}} category View and on either the {{man label|Place Tree}} or {{man label|Places}} view (which ever you usually use), and load the Gramplet in the bottom bar by clicking the little down pointer at the far top right of the bottom bar, and then using the {{man button|Add a Gramplet…}} menu item.
=== GeoNames account prerequisite ===
The first time you attempt a search, you will be reminded to obtain and set a GeoNames user ID, which is required for use of their data. You can sign up for the ID at the following link: [].
== Preferences ==
[[File:PlaceCleanupPref.png|thumb|right|44px|Place Cleanup Preferences]]
The Gramplet Preferences is accessed via the Preferences button (located in the top right of the main view of the Gramplet, next to the Title field). The button should appear as shown to the right.
== Main view ==
The Main view has several buttons, a 'Title' field, a small 'xx Matches' status, and a 'Choices' or match results list.
* {{man label|Title}} field. This field shows the Place that is currently under investigation. It provides the search terms that are used for finding a place. It changes automatically to the place title when the Gramps Place view has an active selection. The field can also be modified by the user, just set the cursor in it and edit as normal. This is generally only needed when trying to find a place in GeoNames that might have unexpected abbreviations, or historical hierarchy or other issues which can make finding a match in the GeoNames database difficult.
== Result/Edit view ==
[[File:PlaceCleanupRes.png|thumb|right|550px|Place Cleanup Result View]]
This view presents the found place data for review and potential editing.
== Faq ==
* GeoNames data is primarily intended for present day usage. It contains little historical information. I have heard that it is pretty complete for United States, Canada, and less so for Europe, although it seems to have all the European cities I have tested so far. If you find an error or omission in the GeoNames data, you may want to tell GeoNames about it [|].
* GeoNames finds multiple places: Example, 'Santa Rosa, CA'. GeoNames finds both 'Santa Rosa, Sonoma, California, United States' and 'City of Santa Rosa, Sonoma, California, United States'. The way the GeoNames database is structured, they have a 'Populated Place', which generally has lots of Alternate names and postal codes, and an 'Administrative subdivision' for the same place. The 'City of' version is the Administrative subdivision, which generally doesn't have postal codes and alternate names. I personally prefer the first version, which should appear first in the 'Choices' list.
== Notes ==
This is a new tool and fairly complex. Please report any issues or desired enhancements to paulr2787 at
I have included a French translation of the tool, mostly as a test of the internationalization code. Since I don't speak French (USA Texas version of English only), please excuse my French.

Navigation menu