Skip to content

alulsh/family-tree-map

Repository files navigation

Family Tree Map

https://www.alexandraulsh.com/family-tree-map/

Map the birthplaces of people in your family tree.

Family Tree Map

About

Ancestry, the most popular genealogy platform in the United States, lacks a feature that maps your entire family tree. To map your family tree, you could upload your tree to another service or geocode ancestor locations by hand. For privacy or data duplication reasons, you may not want to upload your family tree to another service, though. While both Gramps and MacFamilyTree offer family tree maps, they require you to manually geocode and confirm each location before you can map it, a tedious and time-consuming process.

This project maps your family tree with only a GEDCOM file, the de facto standard file format for family trees supported by most genealogy platforms and software. This saves you time (no more geocoding by hand) and frees you from needing to upload your family tree to an online genealogy platform.

Getting started

  1. Export your family tree as a GEDCOM file or use this sample GEDCOM for John F. Kennedy. Most genealogy software and online platforms, including Ancestry and MyHeritage, support exporting your family tree as a GEDCOM file. Your GEDCOM file must have the file extension .ged to work with Family Tree Map.
  2. Visit https://www.alexandraulsh.com/family-tree-map/.
  3. Click on Choose File and find your exported GEDCOM file.
  4. Find your exported GEDCOM file and click on Open.
  5. Review your results.
    • The birthplaces of people in your family tree will be geocoded on the map on the left.
    • Click on any marker on the map to see the name, birth date, birthplace, geocoded birthplace, and geocoding relevance of a family tree member.
    • Use the table on the right to search for a specific person in your family tree. You can search by last name or country.
    • Any family tree members that can't be geocoded (e.g., missing birthplace) will show up in the table.
  6. Optionally adjust the geocoding relevance to choose which results to show on the map. A higher score (0.75 and higher) is stricter and will show fewer results, while a lower score will show more results.

Limitations

  • This project does not save or store your GEDCOM file. If you refresh the page or close your tab, you will need to re-select your GEDCOM file.
  • You can only map birth locations. You cannot map other events yet, like death location, marriage location, or residence.
  • This project maps all people in your GEDCOM file, not just direct ancestors.
  • Most geocoding APIs are optimized for current place names, not historical place names. Results for older family tree members using historical place names will likely be less relevant.
  • This project uses English as the default geocoding language, which reduces the relevance for other languages. For example, you may have less relevant results if your family tree uses French place names.
  • The GEDCOM standard is paradoxically tolerant of ambiguity (e.g., place names and dates) but is strict about heteronormative relationships and gender identity. Tom Macwright, who wrote the GEDCOM parser this project uses, published a great write up on this paradox.

Privacy

GEDCOM files contain sensitive information like full names, birth dates, and birthplaces of living family members. You should be cautious and mindful of where you upload your GEDCOM files. Ideally, these genealogy services should protect the privacy of living people in your family tree.

Fortunately, this project does not require you to upload your GEDCOM file to an external server or service. Instead, your GEDCOM file is processed client-side in your browser using the gedcom parser. Your GEDCOM file is not stored in a database, and your family tree data does not persist across sessions. If you refresh the page, you will lose your map, and you will need to select your GEDCOM file again.

This project does send birthplaces in your GEDCOM file to the Mapbox Geocoding API for forward geocoding and placement on a Mapbox GL JS map. This project does not send full names or birth years to the Mapbox Geocoding API, only birthplaces.

Alternatives

If you're interested in creating an accurate family tree map that you can save, I recommend either Gramps or purchasing MacFamilyTree. While both programs force you to manually geocode and confirm places before you can generate a map, this does improve your family tree map's accuracy. Both programs map multiple location event types and filter by year and other properties.

There are also a few free online services with mapping capabilities:

  • MyHeritage PedigreeMap™ - This map is slow to load and slow to use, but displays points and heatmaps for multiple location events in your family tree. Instead of showing all points at once, you have to manually click on states, counties, or cities one at a time to add them.
  • Geni - Geni lets you map current locations or birth locations from your family tree. The map plots a marker with no additional information, so you can't identify which marker is which person in your tree. Geni also requires your profile to be public and doesn't let you set the privacy of deceased relatives (either "Make this profile public" or "Let Geni decide"). Geni also has restrictions on GEDCOM imports to ensure compatibility with their World Family Tree.
  • Ancestry - While you can't map your entire tree at once, Ancestry.com does have a couple of useful mapping features. Clicking on a person's profile will map all of the event locations for that person. If your AncestryDNA test has additional communities, then you can view ancestor birth locations within the regional outline for that community along a timeline.
  • FamilySearch - FamilySearch has a Where Am I From? feature that maps family tree birth locations and lets you filter by generation, year, family lines, and country. Similar to Geni, FamilySearch is a collaborative genealogy site, and anybody can edit your tree. Also, any information you upload is owned or licensed by the Church of Latter-day Saints per their terms of service.