15,091
edits
Changes
From Gramps
m
A The {{man label|PlaceCompletion}} tool to bring the addon can import places in into your Gramps database in accordance with the Gramps requirements: batch add country, county; look-up latitude-longitude; set description (title); ...
stop redirect
{{Third-party pluginaddon}}{{man warn|This tool is of limited use for Gramps 5.x series.|Please read the [[Place_completion_tool#Issues|Issues]] section. You should consider using the [[Addon:PlaceCleanupGramplet|Place Cleanup Gramplet]] instead.}}
[[File:File:Place completion tool example1PlaceCompletion-Tool-Addon-50.png|right|300px450px|Place completion tool PlaceCompletion - Tool - Addon - Example Resultsdefault dialog]]
This tool helps you fill in the place attributes like county, country, ..., by allowing you to select the places you work on, and do changes on all these places with one button click.
*Construction of a uniform title/description field, from the data in the place object.
Follow the installation details in the [[Addon:Place_completion_tool#Download|Download]] section for your version of Gramp.
== Usage Instructions ==
=== Download resources ===
{{out of date|stub}}<!--page needs to be reworked and maybe split}}-->
The place completion tool can look up for you latitude/longitude, add county information (USA), ... . For some of this functionality, you must download data files of the countries you are interested in. Right now you have three options:
{{man note|Note:|The geonames data of popular places is in English, so e.g. municipalities in Italy will be found, but Roma not, as this is Rome in English. To find data with these you need to search in the localised variants of the name (see below)}}
{{man warn|Warning:|DO NOT BETA TEST WITH USE ON YOUR RESEARCH DATA. EXPORT DATA FIRST TO HAVE A BACKUP. Before use [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees.}}
=== Starting the tool ===
We have downloaded the GeoNames datafiles for the USA states, and will now use that to complete the latitude and longitude of the data. At the same time, this will fill up the county field.
[[Image:place_completion_tool_example2.png|500px|left|Look up lat/lon for Alaska]] In the above screenshot, you see we have selected All Places with State=AK. In the second part of the window we give that we want to search in the AK_DECI.txt file downloaded from GeoNames, using the parsing method: ''GeoNames USA state file, city search''. Note that if you want to change AK into Alaska, this would be possble. Just set state=Alaska in the set attributes section of the window.
In the screenshot, you see we have selected All Places with State=AK. In the second part of the window we give that we want to search in the AK_DECI.txt file downloaded from GeoNames, using the parsing method: ''GeoNames USA state file, city search''.
{{-}}
Note that if you want to change AK into Alaska, this would be possible. Just set state=Alaska in the set attributes section of the window.
Do this now for all the states. Always check for doubles. Eg, for state ''AL'', going over the changes, we encounter:
==See also==
*[[Addon:GetGOV]] - download place information from the [http://gov.genealogy.net/search/index GOV gazetteer].
*[[Addon:GeoName]] - downloads place information from the [http://www.geonames.org/ GeoNames gazetteer].
*[[GeoCodes]]
== Download ==
* If you use Gramps 5.0 , then use the [[5.0_Addons|automatic installation]].* If you use Gramps 4.2 , then use the [[4.2_Addons|automatic installation]].* If you use Gramps 4.1 , then use the [[4.1_Addons|automatic installation]]. * If you use Gramps 3.4 , then use the [[3.4_Addons|automatic installation]]. * If you use Gramps 3.3 , then use the [[3.3_Addons|automatic installation]]. * If you use Gramps 3.2 , then use the [[3.2_Addons|automatic installation]].
=== Manual install ===
If you still use Gramps 2.2.5+, then you will need version 1.0 of the Place Completion Tool. You find it at [http://cage.ugent.be/~bm/varia/placecompletion_1_0.tar.gz placecompletion_1_0.tar.gz].
== Issues ==* None of the Actions in the tool work for Apple Mac {{bug|10004}} in 4.2 release. This is fixed in 5.x release.* For Gramps 5.x series please see notes [https://github.com/gramps-project/addons-source/pull/107 here] ** The most concerning is that this tool is quite outdated in our current place structure (for Gramps 5.x). While it works, the title change capability is of little utility for those users who use the automatic place title function. The new place hierarchy largely eliminates the need for this tool. Information is no longer duplicated, so we no longer get inconsistencies which need fixing. Also changes to all titles lower in the hierarchy can now be made by changing the name of a single place.** The whole tool is useless unless the user has already manually enclosed his places.(for Gramps 5.x)** The user can still use it for Lat/Long creation and update.(for Gramps 5.x) * Maybe replace GoogleMaps button (eg, http://open.mapquestapi.com/nominatim/) [[Category:Proposed Tool SpecificationsAddons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Tools]]
