2,037
edits
Changes
From Gramps
no edit summary
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); ...
[[Category:Proposed Tool Specifications]]
== Place Completion tool ==
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.
The general aims are:
*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. This should be parsed to insert the values in the correct attribute fields.
*Latitude and longitude are important to show data on a map. However, doing a look-up of this data on the internet is slow and time consuming. The tool allows to search in the free resources on the net.
*Setting of an attribute of a set of places in one go. Eg you give a
*Conversion of latitude and longitude to a fixed data format. On import one might obtain latitude and longitude in several different formats. A conversion tool to store them all in the same format is usefull.
*Construction of a uniform title/description field, from the data in the place object
== Troubleshooting ==
=== Non UTF-8 latitude/longitude file ===
The place completion tool expects the input files for location lookup to be in unicode (utf-8). In the occation this is not the case, you will get the error:
<code><nowiki>File "/home/benny/programms/gramps/gramps2/src/plugins/PlaceCompletion.py", line 851, in load_latlon_file
self.latlonfile_datastr = infile.read()
File "/usr/lib/python2.4/codecs.py", line 481, in read
return self.reader.read(size)
File "/usr/lib/python2.4/codecs.py", line 293, in read
newchars, decodedbytes = self.decode(data, self.errors)
UnicodeDecodeError: 'utf8' codec can't decode bytes in position 1610092-1610094: invalid data</nowiki></code>
In the above example it is clear the problem is in two bytes, so you can correct this manually: open the file with eg <code>KHexEdit Binary Editor</code>, go to the specified position (offset 1610092), and change the two bytes with a space.
In the case the file is completely non-unicode, you will have to convert it to unicode with a tool, before using it in the placecompletion tool.
= Old Tool =
== Place Completion Tool==
