Changes

A tool to bring the places in your GRAMPS database in accordance with the GRAMPS requirements: batch add country, county; look-up latitude-longitude; set description (title); ...

*Construction of a uniform title/description field, from the data in the place object

See [[Place completion tool specification]]

Place/Location is a newer concept in GRAMPS. Many older databases only have a Place title field which is a descriptive text containing city, state, country. To distribute these values into the correct attribute fields, see Parse Title Details below

The Dialog consists of 4 parts:

First you need to choose with which places you want to work. You can use several methods to define your places:

# Use a place filter. You can use two preset filters: ''All places'', which returns all places, and ''No Latitude/Longitude given'', which returns all places of which the latitude or the longitude is not set. You can also created a custom place filter in the place view, test it with the filter sidebar, and then use it in this tool. All custom filters you made will be available

# Use a latitude, longitude rectangle. Eg, suppose you have the latitude and longitude of all places in the UK, and now want to add in the state attribute ''Wales'', for all places in Wales. You can look on a map, note down the centre of Wales in latitude and longitude, as well as roughly the width and height of this rectangle. This will allow you to obtain all places in Wales (and some in England), allowing to much faster set the state information.

#The first possibility is to look up in a datafile the latitude and longitude of your places. For this you must have downloaded the necessary resources, see section above. You can select with a file dialog the file you want to search, and set how this data must be parsed. The following parsing options are available:

##''GeoNames country file, city search'': use the city attribute to look for lat/lon in a GeoNames country file. This is the fastest search.

In case google maps did not allow you to determine which is the correct city, you can double click on the city to open the Place Dialog ('''Warning: this will preenter the data of the Place Completion tool. So hit cancel here if you want to exit without these changes done'''). In this dialog the references tab allows you to navigate to all events coupled to this place. This will give you extra information you might use to decide which of the two found places is the correct place.

While updating all places in step 2, you will have noticed some errors in the state information: Some places have a dubious state: eg OH-AL

It will be clear that many of those can be quickly corrected: abbreviations, eg the city field contains ''St.George'', which should be ''Saint George''; double names, eg Waterloo-Cedar Falls, IA means Waterloo near Cedar Falls, changing the city to Waterloo and redoing the search using Google Maps will allow to quickly find which coordinates for Waterloo are needed.

This is for advanced users only knowing regular expressions.

'''TODO''' : to commit this patch on [http://gramps-addons.svn.sourceforge.net/viewvc/gramps-addons/contrib/PlaceCompletion/PlaceCompletion.py?view=log gramps addons], see [[Addons_Development|Gramps addons]].

For France, some [http://www.geneawiki.com/index.php/Informatique_-_saisie_des_lieux practical rules] could be useful for seizing place. We need :

Note: this patch does not work with locale set to french (e.g. LANGUAGE=fr_FR.UTF-8). Before getting this fixed, users should temporarily move to english locale to use it.

To allow PlaceCompletion 1.2 to work with trunk, you'll need to make a couple of changes:

progress.set_pass('',self.db.get_number_of_places())

</pre>