Gedcom Map Program – "PrepMaps"

Preparing tsv-files for interactive Online Maps from ged-files

Table of Content 1 Main Screen ...... 3 1.1 Functionality ...... 3 1.2 Prerequisites ...... 4 1.3 Description...... 4 1.3.1 Program sequence ...... 4 1.3.2 Definition file (mmsd-file) ...... 5 1.3.3 Program start by command line ...... 5 1.3.4 Search criteria ...... 6 1.3.5 Options ...... 6 1.3.6 Selection of the Databases ...... 7 1.3.7 Buttons ...... 8 1.3.8 Tab "Options / Header line tsv-file" ...... 8 1.4 Method for compression ...... 9 1.5 Extract from a log file ...... 10 2 Appendix ...... 11 2.1 Copyrights, License agreements, Program error and others ...... 11 2.2 Setup of the tsv-file ...... 11 2.2.1 File name ...... 11 2.2.2 Description of the columns ...... 11 2.2.3 Examples of tsv-files ...... 13 2.3 Processable MAP + _GOV Structures of ged-files ...... 14 2.3.1 Standard Structure ...... 14 2.3.2 "_LOC – Records" ...... 14 2.3.3 "0 _PLAC" ...... 14 2.3.4 "0 _PLAC_DEFN" ...... 14 2.3.5 Programs without MAP, LATI, LONG and _GOV ...... 14 2.4 Characteristics of the databases ...... 15 2.4.1 CompGen DB ...... 15 2.4.2 TNG DB...... 15 2.4.3 Webtrees DB ...... 15 2.4.4 Geneanet DB ...... 15 2.4.5 OFB Type 3 ...... 15

Diedrich Hesmer 31.12.2020 Seite 1 von 15 Gedcom Map Program – "PrepMaps"

Changes to the last issue highlighted in yellow.

Diedrich Hesmer 31.12.2020 Seite 2 von 15 Gedcom Map Program – "PrepMaps"

1 Main Screen

1.1 Functionality This program helps to show genealogists graphically on a world map • Where do our ancestors come from? • Where are their descendants? It creates up to 8 tsv files from a ged file, which must be UTF-8 encoded, to create interactive maps with OpenStreetMap background or Google Maps to be integrated into the own website. There, markers are placed in each location found and the frequency of the respective surnames can be displayed. The ged files must therefore include the coordinates specified by the tags MAP with LATI and LONG. If these data are missing, they can be supplemented with the Map program ModPlac. A linking of the persons to the following databases is possible: • CompGen DB: OFB data of "ofb.genealogy.net"1 or • TNG2 DB: private databases on external or internal server or • Webtrees DB: private databases on external or internal server or • Geneanet DB: private databases on external server or • OFB Type 3: directory of the html files of OFB type 3 report on external server or • No DB: processes the data without link to a person DB In all cases, a link to the CompGen GOV data of "gov.genealogy.net"3 is possible.

1 OFB: Online Heritage Books, a project of the "Society for Computergenealogy, e.V." (CompGen) 2 TNG: The Next Generation of Genealogy Sitebuilding, a running as a web application 3 GOV: Historic Gazetteer, a project of the "Society for Computergenealogy, e.V." (CompGen) Diedrich Hesmer 31.12.2020 Seite 3 von 15 Gedcom Map Program – "PrepMaps"

The ancestors and/or descendants of an individual or a group of persons born in a specified place within a defined period are selected and transmitted in compressed form. All INDI and FAM records are evaluated for this purpose. The surnames with a key date are listed for each location found. For the ancestors, the most distant date is displayed. The most recent date is shown for the descendants. The main difference between the maps that can be created with the tsv files and a local family book is the assignment of where the persons came from and where they moved to. This results in a completely different point of view. You can sees which surnames are found from or up to a date at this place. This in extension with the surrounding places forms an unusual perception of the own data.

Example maps with OpenStreetMap: Example maps with Google Maps: German http://krasna-o-de.otto-riehl.de German http://krasna-g-de.otto-riehl.de English http://krasna-o-en.otto-riehl.de English http://krasna-g-en.otto-riehl.de

For details, see the report "Serving Online Maps with PrepMaps" from Otto Riehl. An exemplary application may be found here for Krasna, a colony with German inhabitants in Bessarabia. Both are accessible by the Homepage. All examples are based on links to CompGen databases. During the process, a log file is created that can be opened with any text editor. The log file has the name of the ged file, extended by "_pm" and the file extension ".log" and is stored in the directory of the ged file. 1.2 Prerequisites For the output, only persons will be taken into account, who are containing in the ged-file: • information of date of birth, christening, death or burial and additionally • location data (PLAC) with their coordinates (MAP.LATI/LONG) Persons with the entry "DEAT Y" and a PLAC text are also included, even without a date. See paragraph "Processible MAP + _GOV structures of ged files" on page 12 for details of the programs concerned. It is also necessary that the INDI ID in the linked DB is the same as in the ged file, as these are used as the key field for linking. Without this, no link from the map to the person is possible. Without this, no link to the person is possible from the map. See also the notes in the appendix at 2.4 "Characteristics of the databases" on page15. This means for the respective ged file: • CompGen DB: It must be the same as the one loaded to " ofb.genealogy.net". • TNG DB: It must be exported from TNG. • Webtrees DB: It must be exported from Webtrees. • Geneanet DB: A ged file exported from Geneanet cannot be used because it contains neither MAP nor _GOV. More details in the appendix. • OFB Type 3: It must be the same as the one used by the OFB.

1.3 Description The following describes the program sequence, the mmsd definition files, the search criteria, the options, the effect of the buttons, the logic and the log file.

1.3.1 Program sequence After starting the program, the above main screen appears. Fields with missing or incorrect entries are highlighted in red. This means that an analysis is not yet possible. Only INDI and FAM data records are analyzed. • At the first call all fields are empty or set to their system value. • Load the ged file, select the search criteria for the selection of persons and the options. • After defining all definitions, these should be saved in a mmsd control file (see next section) for later reuse.

Diedrich Hesmer 31.12.2020 Seite 4 von 15 Gedcom Map Program – "PrepMaps"

• "Start" starts the import of the ged file. All INDI and FAM data are read. Missing or incorrect PLAC texts, GOV texts, LATI or LONG texts are listed in a log file and are not used internally. o LATI/LONG texts with "," are replaced by ".". o Long LATI/LONG texts are truncated after 6 digits after the ".". o Missing surnames are replaced by "_". o Optionally defined PLAC entries, e.g. "unknown", are omitted. • During the import, the system checks whether MAP data are found. If nothing is found, the process terminates with a corresponding message. • After importing, the search criteria are compared with the data in the ged file. If a year of birth is missing, the year of christening is used as a substitute. If there is a match, the person is considered a finding. The persons found by this search are the "base group". • From the persons of the base group their ancestors or descendants are searched now, independently of the place and year of their birth, christening, death and burial. • From the total quantity of all found persons, in the following called "findings", a compression takes place according to the procedure described below on page 7. • The tsv files has 9 fixed columns, 1 row for each location found. The "LATI;LONG" combination, which is unique, is formed as a key field from the coordinates, even with different spellings of the respective location. • Up to 8 tsv files are created according to the selected options (Add, Create for, Output texts). • By "Close" an ini file with the names of the mmsd control files is created, which are made available again with the new start and the program ends. • When restarting the program, it searches for the ini file. If found, the fields are filled according to the settings of the mmsd file from the last "Close". These can be changed before the next "Start".

1.3.2 Definition file (mmsd-file) These files are used to save all selected options. They are created and managed with this program and should be saved under a name that is as meaningful as possible. It is recommended to save all mmsd files together in a common directory (e.g. "C:\Data\Map\Files\").

In the "DropDown" bar of the mmsd definition files in the lower part of the window, click on the arrow to open a list with the last mmsd files used up to the number defined under "Settings" in the start center. The file selected here is loaded.

You can also start the PrepMaps program by double-clicking on an mmsd file in the explorer.

1.3.3 Program start by command line The program is designed that it can be started with command line parameters. Therefor it can also be processed with the GSP Utility BatchRun, where it belongs to the "Form 1" parameters (see program description "BatchRun.pdf", available on the homepage). The following call is required: "mmsd-file with full path"[,/q]. • The file specification must be enclosed in ". • The ",/q" command is optional and causes processing in the background so that a window is only opened if errors or questions occur. Otherwise, the program ends automatically. Without this command, the program starts normally with the specified mmsd file. • Example command line: "C:\0\group-gov-test2.mmsd",/q

Diedrich Hesmer 31.12.2020 Seite 5 von 15 Gedcom Map Program – "PrepMaps"

1.3.4 Search criteria The search criteria determine the search for the persons concerned. To do this, select : • The Starting point for the analysis: o Individual The field "INDI Id" must contain the complete ID number of the person in the form "@Inn@". o Group of persons This allows the selection of a group of people from a location within a period. To do this, the exact text as it appears in the ged file must be specified for each of the following ▪ PLAC or the _GOV indicator. These are best transferred via "Copy&Paste" from the ged file. In addition, the following must always be specified ▪ Years in the form "YYYY-YYYY" (from-to). The year is determined from the DATE texts. If two 4-digit numbers are found there, as in FROM YYYY TO YYYY, BET YYYY AND YYYYY, the first value is used for ancestors and the last value for descendants. If only one 4-digit number is found, this will be used for both. Beside the Gedcom formats also the German format "17.8.2012" or "before Easter 1820", "1870/1875", "1914-1925", "1860-12-24" are accepted. Persons with missing entries are not included in the base group. • The Add to this ... group of persons: o Ancestors for all persons of the base group and/or o Descendants for all persons of the base group The groups are calculated with HUSB, WIFE and CHIL from the FAM data records. Therefor FAMC and FAMS do not have to be evaluated. For this calculation, all persons are used, independent whether place and date data are available. However, only persons with place and date specifications are taken into account in the later compression.

1.3.5 Options Options for processing and output of the data are • Create tsv for ... the output of the map o OpenStreetMap and/or o Google Maps. • Output texts controls the language (German and/or English) of the output texts in the tsv file. Affected are the variable texts of the header lines given below and the fixed coded base texts for the links. These are: ▪ " |● Link zum Geschichtlichen Ortsverzeichnis (GOV)" " |● Geburten an diesem Ort · OFB" " |● Sterbefälle an diesem Ort · OFB" " |● Personen mit Ereignissen an diesem Ort" " |● Ortsverzeichnis im OFB Personenbericht" " weitere Nachnamen, ", "ab " und "bis " resp. ▪ " |● Link to the Historic Gazetteer · GOV" " |● Births at this Place · Local heritage book · OFB" " |● Deaths t this Place · Local heritage book · OFB" " |● Persons with Events at this place" " |● List of Locations in the OFB Person Report" " further surnames, ", "from " und "to "

Diedrich Hesmer 31.12.2020 Seite 6 von 15 Gedcom Map Program – "PrepMaps"

• Max Persons in List allows you to narrow down the surnames displayed for each location in the list. If "0" is specified, up to 1,000 persons are listed. The system value is "10".

1.3.6 Selection of the Databases Here you have to define the desired database with which persons are to be linked and the corresponding options. • Link to … o CompGen DB links to the OFB data base stored on the CompGen server "ofb.genealogy.net". o TNG DB links to the data of a private TNG database stored on a Web server or a local server. o Webtrees DB links to the data of a private Webtrees database stored on a Web server or a local server. o Geneanet DB links to the data of a private database stored on a Geneanet Web server. o OFB Type 3 links to the html files stored on an external server. o No DB does not link to any database. Only the data of the ged file with places, surnames and their frequency are displayed on the world map. All following options are disabled. o Options for the selected DB ▪ Names linked to the names listed in the list. ▪ Places (not for Geneanet DB) linked to the respective places. ▪ With which OFB (for CompGen DB) The corresponding name of the "Online OFB" of ofb.genealogy.net must be entered here. The original spelling (upper/lower) must be used. ▪ With which URL (for TNG DB, Webtrees DB, Geneanet DB) Enter the corresponding URL here. For the servers this starts with http:// or https://. The URL must end with a "/". For Webtrees, this is the text marked green in the image below. ▪ Path to _ofb3index.html (for OFB Type 3) Enter the corresponding URL here. For the servers this starts with http:// or https://. The URL must end with a "/". ▪ Test calls the specified OFB at genealogy.net resp. the specified URL by the browser. If this is not found, an error message appears in the browser and the spelling has to be corrected. Since the program cannot perform a direct test, a dialog box opens in which you must specify whether the test was successful. This is stored in the mmsd control file. ▪ Tree Id (for TNG DB) Enter the corresponding TNG tree identifier here. Please note that it may be protected by appropriate passwords. ▪ Fam Tree ../ged= (for Webtrees DB) Enter the corresponding text of the URL of the Webtrees family tree here. This is the text marked pink in the picture. Please note that it may be protected by appropriate passwords. ▪ Tree Id (for Geneanet DB) Enter the corresponding Geneanet tree name here. Please note that it may be protected by appropriate passwords. ▪ Directory /for OFB Type 3) Enter the name of the subdirectory in which the _ofb3index.html file is located. Note: the full name for the directory of this file consists of "Path to _ofb3index.html", "de/" or "en/" (depending on the language of the output file) and this entry -> "https://personreport.krasna-photo- collection.de/de/3/" ▪ OFB Output Dir (for OFB Type 3) Specifies the local OFB output folder to the _ofb3index.html file. This is needed to prepare an internal reference file for the links to the Location index list.

Diedrich Hesmer 31.12.2020 Seite 7 von 15 Gedcom Map Program – "PrepMaps"

1.3.7 Buttons Following buttons are available: • [ Symbols with an open folder ] Loads a ged-file. • [ Edit ] Pushing by the left mouse button opens the ged-file by the text editor for viewing. Pushing the right mouse button starts "GedShow" with the ged-file. • [ Edit tsv ] opens a dialog for selecting a tsv file by a text editor. • [ x ] Deletes all entries of the search criteria. • [ Paper Symbol ] Clears all definitions and sets the defaults. • [ Symbols with an open folder ] Loads a mmsd file. • [ Symbol with floppy disk ] Saves a mmsd file. • [ ? ] Opens the description. • [ Info ] Shows the folder where the ini-file is stored (contains all settings at the last "Close"). • [ Start ] Starts the processing. • [ Edit Log ] Opens the log-file by the text editor. • [ Close ] Writes the ini-file with all mms files of the drop down list and closes the program. (Won't be done by the upper right x-button)

1.3.8 Tab "Options / Header line tsv-file"

1.3.8.1 Options for the log-file • MAP errors lists missing MAP and therefor no LATI and LONG data exists. • Place errors (only for OFB Type 3) lists Places PLAC of the ged file, not found in the Index list for locations. • LATI/LONG errors lists LATI and LONG errors. • Suppress "Base group" suppresses the output of "Starting point of search ". 1.3.8.2 Further Options • BAPM as christening – add to CHR uses the BAPM data for the christening if no CHR is found. Due to settings, some genealogy programs store the christening data under the BAPM tag instead of CHR. If both are present, the data of CHR is used.

Diedrich Hesmer 31.12.2020 Seite 8 von 15 Gedcom Map Program – "PrepMaps"

• Integrate RESI.PLAC (only for OFB Type 3) causes the place names of RESI (place of residence) to be included additionally. • Suppress PLAC texts ... suppresses all PLAC texts specified in the text field, e.g. "unkown;unbekannt", when reading the ged file. The texts can be specified in lower case, semicolons must separate several. 1.3.8.3 Definition of the Header lines The screen above shows the fields of OpenStreetMap and Google Maps for the headers of the tsv file, here "- en" for English and "CompGen DB". Nine lines are fixed. For the "TNG DB" and "Webtrees DB" only eight columns are needed, as shown on the right. Only the text of the eighth column differs. This is also valid for "OFB Type 3", also shown on the right. For "Geneanet DB" only seven columns are processed. With OpenStreetMap, the lines are only used for internal processing. With Google Maps, the text of the columns is transferred directly into the display of the popup in the map. 1.3.8.4 Special Option • Loc Columns for OSM is only visible for special licensees and active for them only for "OFB type 3". With this option 2 additional columns 7 + 8 are appended for the 4 OSM tsv files with changed link targets for the OFB index list for places. The column titles are "LocKey" and "LocFile".

1.4 Method for compression Compression takes place in several steps: 1. From the "findings" determined above, only persons are used who contain a text for PLAC, MAP.LATI and MAP.LONG for at least one of the events BIRT, CHR, DEAT and BURI in the ged file and who contain a determinable year in DATE for at least 1 of the 4 events. Entries in the form "DEAT Y" without date, but with PLAC are considered as a determinable year. 2. From the remaining persons, "LATI;LONG" combinations from all events are used as key fields and for each combination the listed persons are assigned with their surname, the earliest (ancestors) / latest (descendants) year and the event. 3. Within each combination, the surnames are sorted in descending order according to their frequency and within the frequency an ascending (ancestors) / descending (descendants) order according to the year is carried out. 4. The defined number (default = 10) of the most frequent surnames at each location is then listed according to the column description of the tsv file in the attachment. If "0" is entered, all names, max. 1000, are listed.

Diedrich Hesmer 31.12.2020 Seite 9 von 15 Gedcom Map Program – "PrepMaps"

1.5 Extract from a log file Listing during reading: • Time stamp and file name. • Persons not found due to incorrect references in the ged file. • Non-interpretable date specifications with details of the person concerned and their ID number, so that a correction is possible. • Missing or incorrect LATI/LONG data. • Incorrect GOV information. Additional information is listed: • The base quantity of persons (without ancestors/descendants). • Number of nodes of the earth quarters.

Created on: 09.01.2019 16:04:09 - PrepMaps-Version: 1.0.0 Base: "d:\ofb\1\paf\riehl\map\krasna gedcom_u_mpl.ged" from: 02.12.2018 17:08:33 Modified file: "d:\ofb\1\paf\riehl\map\krasna gedcom_u_mpl_pm*.tsv" Records - INDI: 21.289, FAM: 5.065

Line-nbr: @Record-Id@ -> Tag/attribute faulty => Select replacement value ------

*** Date error *** 198745: @I9184@ -> 1 BIRT -> 2 DATE 16 DEC => Select: 0000 ## [Emilia /Ternes/] … 3 Entries in list *** LATI/Long error *** 265307: @I12783@ -> 3 MAP => 4 LATI 450.5501 -> LATI/LONG error -> not useable 1 Entries in list *** MAP missing, no LATI/Long *** 373: @I11@ -> 2 PLAC => 2 PLAC ,Baden,DE-BW 443: @I13@ -> 2 PLAC => 2 PLAC Hausstädt,Bremervörde,DE-NI … 2.305 Entries in list *** Starting point of search *** @I4510@: Andreas, Schuck - BC: 1884 … @I21260@: Christina, Lauber - BC: 1881 8 Entries in list Ancestors: 20 Persons taken into account Number of nodes: NE: 8 NW: 3 SE: 0 SW: 0 Total: 11

Descendants: 29 Persons taken into account Number of nodes: NE: 18 NW: 7 SE: 0 SW: 0 Total: 25 09.01.2019 16:04:13 Creation completed

Diedrich Hesmer 31.12.2020 Seite 10 von 15 Gedcom Map Program – "PrepMaps"

2 Appendix

2.1 Copyrights, License agreements, Program error and others This and other relevant information can be found in the appendix of the "Map-Start" description. They apply here without restriction.

2.2 Setup of the tsv-file The file contains a header line with the column headers and for each location found a data line. As tsv-file the tab (Tabulator) is used as separator. Comma, semicolon, space or others could not be used, because the data itself contains them.

2.2.1 File name The file name consists of the file name of the ged file and, depending on the selected options, the following letter additions, so that "my_file.ged" becomes "my_file_pmyz-xx.tsv", where the following applies: • "pm" = PrepMaps • "y" = "o" for "OpenStreetMap" or "g" for "Google Maps" • "z" = "v" for ancestors (Vorfahren) or "n" for descendants (Nachkommen) • "xx" = "de" for Deutsch or "en" for English There is no marking which DB was used. The files are saved in the folder of the ged file.

2.2.2 Description of the columns 2.2.2.1 CompGen DB Column 1/A Contains the earth quarter data for column 3/C + 4/D and is determined from the entries MAP.LATI/LONG of the ged file. Allowed are: °Nord and °East, °South and °East, °Nord and °West, °South and °West Example: Layer formation in quarters for group formation in Google Maps. °North and °East Latitude +°N and Longitude +°E °North and °West Latitude +°N and Longitude -°W °South and °East Latitude -°S and Longitude +°E °South and °West Latitude -°S and Longitude -°W There are no groups in OSM. Here this information is evaluated differently. Column 2/B Contains the exact text from PLAC of the ged file, 1 line per location, with different spelling at the same LATI;LONG coordinate, the first found. Example: Emmental,Bender,Bessarabia,| Pervomaisc,Căușeni District,MDA Column 3/C Contains the specification for the latitude in the form xx.xxxxxx without leading letters and will be determined from the entries MAP.LATI of the ged file. Example: 46.7011 Card reference system WGS84 (decimal degree with dot and - sign) Column 4/D Contains the specification for the longitude in the form xx.xxxxxx without leading letters and will be determined from the entries MAP.LONG of the ged file. Example: 29.0892 Column 5/E Contains, if _GOV exists, the link of the GOV identifier to the GOV system by concatenating "http://gov.genealogy.net/item/show/" and GOV. Example: http://gov.genealogy.net/item/show/EMMTALKN46NQ Column 6/F Contains a summary of surnames that had an event in this place. The output is sorted by the frequency of occurrence of the respective surname.

Diedrich Hesmer 31.12.2020 Seite 11 von 15 Gedcom Map Program – "PrepMaps"

Example: "Andres, from 1715, 35x ♦️ Bachmeyer, from 1812, 23x ♦️ Müller, from 1745, 19x ♦️ [[https://ofb.genealogy.net/famreport.php?ofb=krasna&ID=I13301|Deichert]], from 1884, 9x ♦️ Gross, from 1745, 9x ♦️ Neuner, from 1745, 9x ♦️ Perscheid, from 1745, 9x ♦️ Paulus, from 1795, 4x ♦️ Ottersbach, from 1756, 2x ♦️ Einbeck, from 1745, 1x ♦️ 9 other names, 78x " Column 7/G Contains the number of persons found with their ancestors or descendants in this location, not the number of entries. Column 8/H Contains link to birth/christening, if applicable. If option "Link places with OFB" is active, and BIRT or CHR occur in the place > 1x, then create link. Example: https://ofb.genealogy.net/namelist.php?ofb=krasna&ort=Emmental%2CBender%2CBessarabien%2C%7C+Pervom aisc%2CC%C4%83u%C8%99eni+District%2CMDA&e=geburt&sort_by=zuname Column 9 Contains link to death/burial, if applicable. If option "Link places with OFB" is active, and DEAT or BURI occur in the place > 1x, then create link. Example: https://ofb.genealogy.net/namelist.php?ofb=krasna&ort=Emmental%2CBender%2CBessarabien%2C%7C+Pervom aisc%2CC%C4%83u%C8%99eni+District%2CMDA&e=tod&sort_by=zuname 2.2.2.2 TNG DB. Columns 1-7 correspond to CompGen DB. Column 8/H Contains link to birth/christening/death/burial, if applicable If option "Link places with TNG" is active, and BIRT, CHR, DEAT or BURI occur in the place > 1x, then create link. Example: https://www.tng.riehl-partner- web.de/placesearch.php?tree=1&psearch=Emmental%2CBender%2CBessarabien%2C%7C+Pervomaisc%2C+Moldawien Column 9 remains empty for OpenStreetMap and is eliminated for Google Maps. 2.2.2.3 Webtrees DB Columns 1-8 correspond to TNG DB. The links are adjusted. 2.2.2.4 Geneanet DB Columns 1-7 correspond to TNG DB. Column 8+9 remain empty for OpenStreetMap and are eliminated for Google Maps. 2.2.2.5 OFB Type 3 Columns 1-8 correspond to TNG DB. The links are adjusted. Example: https://personreport.krasna-photo-collection.de/en/3/vo3_locng.html#i982 2.2.2.6 No DB Columns 1-7 correspond to CompGen DB, while in column 6 no links exists. Column 8+9 remain empty for OpenStreetMap and are eliminated for Google Maps.

Diedrich Hesmer 31.12.2020 Seite 12 von 15 Gedcom Map Program – "PrepMaps"

2.2.3 Examples of tsv-files 2.2.3.1 Structure of a tsv file created by PrepMaps for OSM

2.2.3.2 Structure of a tsv file created by PrepMaps for Google Maps

Diedrich Hesmer 31.12.2020 Seite 13 von 15 Gedcom Map Program – "PrepMaps"

2.3 Processable MAP + _GOV Structures of ged-files MAP with LATI and LONG (Coordinates) and _GOV (Identifier) are exported differently by genealogy programs, if processed at all. To my knowledge, there are four types of export. Each of these types can be processed with PrepMaps, but not in all combinations within a ged file. • MAP, LATI and LONG are standard tags that are processed by a larger number of programs. • _GOV is a user-defined tag that can only be processed by a smaller number of programs. PrepMaps first searches for the default structure. If this is not found, the other structures are searched. The structures listed are exemplary and contain only the tags concerned and their references, if any.

2.3.1 Standard Structure 1 BIRT 2 PLAC Brosowo, Kulm, Bromberg, Danzig-Westpreussen, Deutsches Reich 3 MAP 4 LATI N53.320000 4 LONG E18.420000 3 _GOV BROOWOJO93FH (only sporadically) Used among others by Program Ahnenblatt, Ages!, Brother's Keeper, FinFamily, FTM, Gen_Plus, GEN_DO!, , WebTrees

2.3.2 "_LOC – Records" 1 BIRT 2 PLAC Brosowo, Kulm, Bromberg, Danzig-Westpreussen, Deutsches Reich 3 LOC @P_BROOWOJO93FH@ (Reference to a _LOC record) Und dann im _LOC Datensatz 0 @P_BROOWOJO93FH@ _LOC 1 NAME Brosowo 1 MAP 2 LATI N53.320000 2 LONG E18.420000 1 _GOV BROOWOJO93FH Used among others by Program Ahnenblatt, Ages!, Familienbande, GEN_DO!, GES2xxx; PC-Ahnen (only _GOV)

2.3.3 "0 _PLAC" 1 BIRT 2 PLAC Baden bei Wien, Niederösterreich, Österreich Und dann unter "0 _PLAC" 0 _PLAC Baden bei Wien, Niederösterreich, Österreich 1 MAP 2 LATI 48.00214 2 LONG 16.230909999999994 1 _GOV BADDENJN88CA (only TNG) Used by Program Mac Stammbaum, Mobile Family Tree, Reunion, TNG

2.3.4 "0 _PLAC_DEFN" 1 DEAT 2 PLAC Kirchheim unter Teck Und dann unter "0 _PLAC_DEFN" 0 _PLAC_DEFN 1 PLAC Kirchheim unter Teck 2 MAP 3 LATI N48.64605 3 LONG E9.45199972222222 Used by Program Legacy – no _GOV

2.3.5 Programs without MAP, LATI, LONG and _GOV PrepMaps requires at least the data of the tags LATI and LONG in the ged file. If these are missing, as for example with PAF, then these and optionally also _GOV can be added in the standard form with the GedMap program ModPlac for every PLAC in INDI and FAM records. In addition to the program, a corresponding reference file must be created manually with a spreadsheet as a tsv file (tabulator as separation character). Details can be found in the description "ModPlac_e.pdf". Diedrich Hesmer 31.12.2020 Seite 14 von 15 Gedcom Map Program – "PrepMaps"

2.4 Characteristics of the databases The following rules should be considered when selecting and using databases.

2.4.1 CompGen DB Use the same ged file for PrepMaps that was uploaded to the CompGen OFB DB to ensure identical person IDs.

2.4.2 TNG DB None known. The ged files exported from TNG are used.

2.4.3 Webtrees DB None known. The ged files exported from Webtrees are used.

2.4.4 Geneanet DB Geneanet cannot provide any usable ged-file for PrepMaps because neither MAP nor _GOV data are included. These would have to be inserted into the ged file with the program ModPlac. Geneanet can, however, be used as an online display for linking surnames. Any ged file from any software can be used, but it should contain the tag MAP with Latitude and Longitude and optionally _GOV. For a correct link to persons, the key fields INDI Id in the ged file and Persons Id in Geneanet must match. Due to the internal processing in Geneanet, the persons in the ged file must be numbered in ascending order starting from @I0@ by +1 increments. If the ged-file is not structured in this way, please use the "GSP Renumber". The correctly numbered ged file is imported into Geneanet (MAP and _GOV are not evaluated here) and processed with PrepMaps (use of MAP and _GOV). Linking to event lists at locations is not possible because Geneanet does not provide sufficient links.

2.4.5 OFB Type 3 This is not a database, but a collection of html-files in a directory, possibly divided into various subdirectories, created by the program "Our Family Book (OFB)". Use the same ged-file for PrepMaps that was used for the OFB to ensure identical person IDs and the links to the index list for places.

Diedrich Hesmer 31.12.2020 Seite 15 von 15