Jump to: navigation, search


2,377 bytes added, 16:13, 25 September 2018
no edit summary
{{man note|NOTE|Changing the Title field should be done with some caution. The places found will depend on the contents of this field. If you change in inappropriate ways, you could end up with incorrect place data. For Example, if the original place is "Paris, France", and you change the field to "Berlin, Germany", when you find and accept the Berlin place, your original place will get changed to Berlin.}}
* {{man label|Matches}} status. This small status block is located on the left side of the Gramplet, just below the 'Title' label. It indicates the number of matching places found when searching the local Places list or the GeoNames database. The status also indicates where the matches were found, either 'Local', or 'GeoNames'.
* {{man label|ChoicesSearch result places}} list. This area lists the found matches. The user should select the correct match for the place under investigation, and either press the {{man button|Select}} or double-click, press 'Enter' or 'Space' to move to the result/edit screen.:: 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 shows the Gramps Type, when showing places from the local database, and shows GeoNames types when showing results from the GeoNames search.{{man note|NOTE|If you search for a place in GeoNames that you already have in your database, the search results may return some entries 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 are not always obvious; the type starts with one of 'A', 'P', or 'S' for 'Administrative place', 'Populated place', or 'Spot' respectively. 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 [|], if desired.* {{man 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.* {{man label|Admin}} checkbox. If you check this setting, 'Administrative Places' (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.* {{man 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|Help}} button. This brings up this web page.
* {{man button|Find}} button. This performs a search for the place 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 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 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 GeoNames search only returns ten results at a time, if the place you want is not in the first set of results, press the {{man button|Find}} button again to see the next ten.
{{man note|NOTE|The 'Find' button changes to 'Find GeoNames' after a local database search where something was found, as a reminder that you can search that database if the local search did not return what you wanted.}}
* {{man button|Select}} button. After the user selects one of the matches in the 'Choices' list, this causes the result/edit screen to be shown.
* {{man button|Edit}} button. If no suitable places are found, the user can use this to advance directly to the result/edit screen. This can occur if the place you are searching for is too detailed, for example 'My Estate, Paris, TX' or '123 Mains St., Paris, TX'. Since such detailed information is not going to be found in the GeoNames search, you have to edit it manually.
{{man note|NOTE|The GeoNames database does NOT provide Gramps Place Type data. This Gramplet uses the available data to make a 'best guess' at the correct Place Type. You should always check and make sure that the value is correct, and fix it if necessary.}}
* {{man label|Latitude and Longitude}} fields. These fields displays the Latitude and Longitude. They can be edited. There is a small {{man button|Orig}} checkbox just above these fields, if checked, the Original Latitude and Longitude from the place is used instead of the found Latitude and Longitude. Note that this checkbox is disabled if there is no original Latitude and Longitude.
* {{man label|ID}} field. This field displays the Gramps ID. It can cannot be edited. There is a small {{man button|Orig}} checkbox just above this field, if checked, the Original ID from the place is used instead of the found ID. Note that this checkbox is disabled if there is no original ID.
* {{man label|The Names list.}} This list contains the names associated with the found place. Each name has an associated Language and Date. There is also an 'Inc' column which displays the include status of the name in that row. If there is a 'P' in the 'Inc' column, that name is used as the Primary name. If the column has a checkmark 'βœ”' the name will be included in the final Place alternative names list. If you double-click, press 'Enter' or 'Space' on a selected row, that will toggle the include status.
* {{man button|Keep}} button. If one or more of the places in the names list is selected, pressing this button will cause the associated names to be marked for inclusion in the final Place alternative names list.
* Not Found: While the GeoNames database contains some historical names, it mostly tries to be up to date with the current times. Many places in a typical family tree are described as of the time the event occurred. So it is entirely possible that the described place no longer exists. It may now belong to a different country, or other administrative subdivision. Or it may have subsumed with another larger place. Initially you should try removing the intermediate place data, leaving only the initial segment and the country. You may get a lot of matches, but that may give you a better clue as to the current situation. Or you may have to do some research outside the Gramplet to figure out what it might be called now.
* Place Types: Since GeoNames does not have place 'type' data, the same way that Gramps does, this addon uses an algorithm to attempt to pick an appropriate place type. If a country is known to have a rigid administrative place type structure, such as the United States with its City/County/State/Country, then the various parts of the place hierarchy are typed accordingly.
: If the structure is not always known or used, then the algorithm attempts to assign place types by looking at the place name. For example if the place name includes a word that matches a place type, such as "Harris County" or "Smith Township", then the place type is set accordingly. To do this , all the various place alternate names are scanned, in case the primary name does not include a suitable word.
: If you know that a particular country has a rigid (or even mostly rigid) hierarchical structure, and this addon seems to be getting it wrong a lot, please let the author know at paulr2787 at I can modify the code to make it work better if I understand the correct country structure.
== Notes ==

Navigation menu