Open main menu

Gramps β

Difference between revisions of "Addon:GetGOV"

(Update process for setting Language for version 5.0)
(→‎See also)
 
(60 intermediate revisions by 10 users not shown)
Line 1: Line 1:
−
{{Third-party plugin}}
 
−
 
 
{{languages|Addon:GetGOV}}
 
{{languages|Addon:GetGOV}}
−
 
+
{{Third-party addon}}
−
[[File:GetGOV-Gramplet-addon-detached-50.png|300px|right|thumb]]
+
[[File:GetGOV-Gramplet-addon-detached-60.png|450px|right|thumb|GetGOV gramplet]]
−
 
+
The {{man label|GetGOV Gramplet}} is designed to download place information from the [http://gov.genealogy.net/search/index GOV gazetteer] database. GOV stands for Geschichtliches Ortsverzeichnis or Historical Gazetteer. This database contains Web Ontology Language (OWL) information such as:
−
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_{{man version}}_Wiki_Manual_-_Settings#ID_Formats|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.  
−
===== Version 4.2 =====
+
 
 +
==Usage==
 +
It is designed to be installed as a gramplet on the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Places_Category|Places Category (List/Tree) view]].
 +
 
 +
First use the [https://gov.genealogy.net/search/extended?lang=en GOV online search form] to find the '''GOV-id'''.
 +
 
 +
Enter the found '''GOV-id''' into the {{man label|Place ID to import from GOV (Historical Gazetteer):}} entry field and select the {{man button|Get Place}} button.
 +
 
 +
=== Setting preferred language for place imports===
 +
==== Version 5.x or greater ====
 +
The language is set in the  {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Display_Options|Display Options]] section and is described in the [[Gramps_{{man version}}_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.   
 
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.   
  
−
===== Version 5.0 =====
+
{{-}}
−
The language is set in the {{man menu|Edit -> Preferences..}} tabs {{man label|General}} and is described in the [[Gramps_5.0_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.
+
=== Example ===
  
−
{{-}}
+
This example shows how the gramplet would be used with the GOV gazetteer website to import the place '''[https://wikipedia.org/wiki/Frommenhausen Frommenhausen]''' a suburban district of Germany.
−
== Example of use ==
 
  
−
This example shows how the gramplet would be used with the GOV gazetteer website to import the place Frommenhausen.
+
# [[Addon:GetGOV#Finding_the_GOV-id_on_the_GOV_gazetteer_website|Finding the GOV-id on the GOV gazetteer website]]
 +
# [[Addon:GetGOV#Enter_the_GOV-id_into_the_GetGOV_gramplet|Enter the GOV-id into the GetGOV gramplet]]
  
 +
====Finding the GOV-id on the GOV gazetteer website====
 
[[File:GOVscreenshot.png|600px|right]]
 
[[File:GOVscreenshot.png|600px|right]]
−
Log into the [http://gov.genealogy.net/search/index GOV gazetteer] website.  
+
Log into the [http://gov.genealogy.net/search/index GOV gazetteer] website (Optional).  
 
{{-}}
 
{{-}}
  
 
[[File:GOVresults.png|600px|right]]
 
[[File:GOVresults.png|600px|right]]
−
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.   
+
Find the appropriate GOV-id for the place of interest. In the illustration, the search for the city <code>Frommenhausen</code> was used. The result identifies the appropriate GOV-id as <code>FROSENJN48KK</code>.   
 
{{-}}
 
{{-}}
  
Line 35: Line 45:
 
{{-}}
 
{{-}}
  
 +
====Enter the GOV-id into the GetGOV gramplet====
 
[[File:GetGOVgramplet.png|600px|right]]
 
[[File:GetGOVgramplet.png|600px|right]]
−
Enter the GOV-id into the GetGOV gramplet on the Places view.   
+
Enter the GOV-id into the {{man label|GetGOV}} gramplet on the Places (List) view.   
 
{{-}}
 
{{-}}
  
 
[[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. 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.  
+
The resulting places with Latitude and Longitude 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 <code>Pxxxx</code> numbering. If you use the Reorder Gramps IDs tool, it will change the ID to the default <code>Pxxxx</code> 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 <code>FROSENJN48KK</code> 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 46: Line 57:
 
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.   
 
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.   
 
{{-}}
 
{{-}}
−
 
 
[[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 {{man label|Enclosed By}} information which may be time-dependent as illustrated.   
 
{{-}}
 
{{-}}
  
−
== ISSUES ==
+
== 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.
+
* Issues [https://gramps-project.org/bugs/search.php?project_id=8&sticky=on&sort=last_updated&dir=DESC&hide_status=90&tag_string=GetGOV&match_type=0 tagged GetGOV] on the Gramps Bug Tracker.
−
* Detached gramplet has issue with resizing (see screenshot)
+
** {{bug|10773}} Places view shows all alternate names - even those with different languages
 +
 
 +
{{man warn|If you use the [[Gramps_{{man version}}_Wiki_Manual_-_Tools#Reorder_Gramps_ID|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.}}
 +
 
 +
== See also ==
 +
* [[Addon:GeoName]] - downloads place information from the GeoNames gazetteer. (This gramplet has been deprecated/replaced by [[Addon:PlaceCleanupGramplet]])
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 +
[[Category:Addons]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]

Latest revision as of 23:28, 2 April 2026

Gramps-config-language.png Languages: 

English  • Deutsch

Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any 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.

GetGOV gramplet

The GetGOV Gramplet is designed to download place information from the GOV gazetteer database. GOV stands for Geschichtliches Ortsverzeichnis or Historical Gazetteer. This database contains Web Ontology Language (OWL) information such as:

  • 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.

Contents

Usage

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

First use the GOV online search form to find the GOV-id.

Enter the found GOV-id into the Place ID to import from GOV (Historical Gazetteer): entry field and select the Get Place button.

Setting preferred language for place imports

Version 5.x or greater

The language is set in the Edit > Preferences... - "Data" tab in the Display Options section 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 a suburban district of Germany.

  1. Finding the GOV-id on the GOV gazetteer website
  2. Enter the GOV-id into the GetGOV gramplet

Finding the GOV-id on the GOV gazetteer website

 

Log into the GOV gazetteer website (Optional).

 

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.

 

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

Enter the GOV-id into the GetGOV gramplet

 

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

 

The resulting places with Latitude and Longitude 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 Pxxxx 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.

 

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.

 

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

  • Issues tagged GetGOV on the Gramps Bug Tracker.
    • 10773 Places view shows all alternate names - even those with different languages
 
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.

See also

Retrieved from "https://gramps-project.org/wiki/index.php?title=Addon:GetGOV&oldid=130260"