Difference between revisions of "Addon:GetGOV"

From Gramps
Jump to: navigation, search
m
(32 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{languages|Addon:GetGOV}}
 
{{Third-party plugin}}
 
{{Third-party plugin}}
 
+
[[File:GetGOV-Gramplet-addon-detached-51.png|300px|right|thumb|GetGOV gramplet]]
{{languages|Addon:GetGOV}}
+
The {{man label|GetGOV Gramplet}} is designed to download place information from the [http://gov.genealogy.net/search/index GOV gazetteer]. This information can include  
 
 
[[File:GetGOV.png|300px|right]]
 
 
 
The GetGOV gramplet is designed to download place information from the [http://gov.genealogy.net/search/index GOV gazetteer]. It is installed as a gramplet on the Places view. This information can include  
 
  
 
* Geographical location (lat-lon coordinates)
 
* Geographical location (lat-lon coordinates)
Line 11: Line 8:
 
* Past affiliation or hierarchy of enclosed-by places.  
 
* Past affiliation or hierarchy of enclosed-by places.  
  
Instead of the default ID numbering (Pxxxx) for the imported places, the GOV-id will be used as the ID. If additional imports are performed, duplicate places (even part of the Enclosed By) will be automatically merged.  
+
Instead of the default [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#ID_Format|Place ID Format numbering (Pxxxx)]] for the imported places, the GOV-id will be used as the Place ID. If additional imports are performed, duplicate places (even part of the Enclosed By) will be automatically merged.  
  
If the {{man menu|Preferences -> Places}} tabs {{man label|Language:}} is set, then this is used as the preferred language for place names which are imported, otherwise, the preference is German.
+
=Usage=
 +
It is designed to be installed as a gramplet on the [[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Places_Category|Places Category (List/Tree) view]].
 +
===== Version 5.x =====
 +
The language is set in the {{man menu|Edit -> Preferences..}} tabs {{man label|Display}} and is described in the [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]. This is used as the preferred language for place names and types which are imported. The default language is German.
  
 +
===== Version 4.2 =====
 +
If the {{man menu|Preferences -> Places}} tabs {{man label|Language}} is set, then this is used as the preferred language for place names and types which are imported, otherwise, the preference is German. 
  
== Example of use ==
+
{{-}}
 +
== Example ==
  
 
This example shows how the gramplet would be used with the GOV gazetteer website to import the place Frommenhausen.
 
This example shows how the gramplet would be used with the GOV gazetteer website to import the place Frommenhausen.
Line 37: Line 40:
  
 
[[File:GetGOVimport.png|600px|right]]
 
[[File:GetGOVimport.png|600px|right]]
The resulting places with Lat and Lon are loaded. Note that the Place Type is in the same language as the Place. Note that the ID is the GOV-id and not the default Pxxxx numbering.
+
The resulting places with Lat and Lon are loaded. Note that the Place Type is in the same language as the Place. Note that the ID is the GOV-id and not the default Pxxxx numbering. If you use the Reorder Gramps IDs tool, it will change the ID to the default Pxxx numbering. Later use of this gramplet may import duplicate items (with different ID) since the Gramps ID is no longer the GOV-id and duplicates will not be identified. For instance, if you import FROSENJN48KK and then use the Reorder Gramps ID tool to reset the Gramps ID, if you reimport FROSENJN48KK or any other GOV place that is already imported, you will have duplicate places for every item imported.
 
{{-}}
 
{{-}}
  
Line 45: Line 48:
  
 
[[File:GetGOVresultsenclosed.png|600px|right]]
 
[[File:GetGOVresultsenclosed.png|600px|right]]
The Place hierarchy is also loaded as defined in the GOV database. This includes the Enclosed By information which may be time-dependent as illustrated/  
+
The Place hierarchy is also loaded as defined in the GOV database. This includes the Enclosed By information which may be time-dependent as illustrated.  
 
{{-}}
 
{{-}}
  
 +
= Issues =
 +
* If you use the Reorder Gramps IDs tool, it will change the ID to the default Pxxx numbering. Later use of this gramplet will import duplicate items (with different ID) since the Gramps ID is no longer the GOV-id and duplicates will not be identified.
 +
* {{bug|11596}} GetGOV Language
 +
* {{bug|10980}} Some places are shown as "?" if imported via getGOV third party addon
 +
* {{bug|10773}} Places view shows all alternate names - even those with different languages
 +
* {{bug|11680}} GetGOV crashes Gramps when GOV gazetteer website ( http://gov.genealogy.net ) is not available
  
== ISSUES ==
+
= See also =
* If the GOV-id does not exist in the GOV database, a single place will still be created with that ID but blank name and Unknown type.
+
* [[Addon:GeoName]] - downloads place information from the GeoNames gazetteer.
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 +
[[Category:Addons]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]

Revision as of 22:48, 1 November 2020

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

GetGOV gramplet

The GetGOV Gramplet is designed to download place information from the GOV gazetteer. This information can include

  • Geographical location (lat-lon coordinates)
  • Foreign and former names
  • Past affiliation or hierarchy of enclosed-by places.

Instead of the default Place ID Format numbering (Pxxxx) for the imported places, the GOV-id will be used as the Place ID. If additional imports are performed, duplicate places (even part of the Enclosed By) will be automatically merged.

Usage

It is designed to be installed as a gramplet on the Places Category (List/Tree) view.

Version 5.x

The language is set in the Edit -> Preferences.. tabs Display and is described in the Place Format Editor. This is used as the preferred language for place names and types which are imported. The default language is German.

Version 4.2

If the Preferences -> Places tabs Language is set, then this is used as the preferred language for place names and types which are imported, otherwise, the preference is German.


Example

This example shows how the gramplet would be used with the GOV gazetteer website to import the place Frommenhausen.

GOVscreenshot.png

Log into the GOV gazetteer website.

GOVresults.png

Find the appropriate GOV-id for the place of interest. In the illustration, the search for the city Frommenhausen was used. The result identifies the appropriate GOV-id as FROSENJN48KK.

FrommenhausenDetails.png

To see what data will be imported, you can drill down in to the GOV-id.

GetGOVgramplet.png

Enter the GOV-id into the GetGOV gramplet on the Places view.

GetGOVimport.png

The resulting places with Lat and Lon are loaded. Note that the Place Type is in the same language as the Place. Note that the ID is the GOV-id and not the default Pxxxx numbering. If you use the Reorder Gramps IDs tool, it will change the ID to the default Pxxx numbering. Later use of this gramplet may import duplicate items (with different ID) since the Gramps ID is no longer the GOV-id and duplicates will not be identified. For instance, if you import FROSENJN48KK and then use the Reorder Gramps ID tool to reset the Gramps ID, if you reimport FROSENJN48KK or any other GOV place that is already imported, you will have duplicate places for every item imported.

GetGOVresultsaltname.png

This illustrates that multiple alternate names will be loaded if they are in the GOV database. Deutschland is the Primary name and there are multiple alternate names in different languages in this illustration.

GetGOVresultsenclosed.png

The Place hierarchy is also loaded as defined in the GOV database. This includes the Enclosed By information which may be time-dependent as illustrated.

Issues

  • If you use the Reorder Gramps IDs tool, it will change the ID to the default Pxxx numbering. Later use of this gramplet will import duplicate items (with different ID) since the Gramps ID is no longer the GOV-id and duplicates will not be identified.
  • 11596 GetGOV Language
  • 10980 Some places are shown as "?" if imported via getGOV third party addon
  • 10773 Places view shows all alternate names - even those with different languages
  • 11680 GetGOV crashes Gramps when GOV gazetteer website ( http://gov.genealogy.net ) is not available

See also

  • Addon:GeoName - downloads place information from the GeoNames gazetteer.