From TNG_Wiki
Jump to navigation Jump to search
Restricted Downloads of OpenStreetMap are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account Restricted
Caution If you have trouble downloading with Google Chrome, Vivaldi, Brave or other Chromium based browser, try using a right-click and select Open in new Window, then F5, or use another browser such as Firefox


Ambox notice.png The latest version of this mod uses the guidelines for TNG v12+ cust_text.php files. If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]

TNG 14.0
TNG 13.0
TNG 12.0

Summary Replaces Google maps with OpenStreetMaps
Validation The mod is XHTML compliant.Valid-xhtml10.png
Mod Updated 27 Aug 2023
Download link For
TNG 13.1.0
TNG 14.0


TNG 13.0


TNG 12.3.0


TNG 12.0
See Ancestor map for OpenStreetMap version


TNG 11.0
See Ancestor map for OpenStreetMap version


TNG 10.1.3
OpenStreetMap v10.1.3.5b
See Ancestor map for OpenStreetMap version
Download stats Click For Download Stats v10, 11, 12
Statistics for v12.3.0.6
Author(s) Erik Hoppe
TNG 10.1.3: Ken Roy + Alan Craxford
Mod Alan Craxford
Mod 13+ Brent Hemphill + Michel Kirsch
Homepage OpenStreetMap (This page)
Mod Support TNG Community Forums
Contact Developer TNG Community Forums
Latest Mod for TNG v13.1+ for TNG v13.0 for TNG v12.3 for TNG v10.1.3 for TNG v11.1.2 for TNG v12
Min TNG V 10.1.3
Max TNG V nc
Files modified
Related Mods
OSM Automatic Geocoding written by Michel Kirsch
Author of TNG Colouring Book
Mods by me: At my user page.

Purpose of the mod

This mod installs OpenStreetMap (OSM) maps, if you don't have a GoogleMap API key.
The benefit is that you don't have to register anywhere for anything.
Simply Install, Fill your API key box with "OSM" without quotes (TNG 13+) or empty it (TNG < 13), Save and it's done.
The downside is that OSM maps are in many cases not as detailed as Googlemaps, especially outside the more urban areas.
I have added two maps that are more detailed "rural roads" called ESRI World Street Map and ESRI World Topo Map. (See the Edit Options below)
NEW from mod version 4: Toggle your map with a Satellite view.
See Lars Arén's public site Botebygden in the Sites list below.
(Previously on "Replacing Googlemaps with OSM": TNG Community Forum: Replace Google with OSM) You can also use that link for News about this mod.

Update From Google

June 16, 2018: This was sent from to keyholders(?)
Thanks to Steven Davis for the forward.


Google Maps Platform’s new pricing and terms of service go into effect today.

Starting today, these changes go into effect:

* New Maps, Routes, and Places functionality
* Updated pricing for Maps, Routes, and Places
* $200 free monthly usage per billing account
* Free 24-hour customer support
* Updated Query per Second (QPS) limits
* New Terms of Service

Thank you for using Google Maps Platform.

The Google Maps Platform Team

The updated pricing is here: Updated pricing
The queries per second scheme is here: QPS limits
The terms of service are here: T.O.S

MOD Conflict

Placesearch-More Info and Cemetery_Edit mods by Robin Richmond can NOT be used with versions of the OSM mod < v13!


This mod was developed by Erik Hoppe who is NOT maintaining or developing this mod.
See Mod Support in the data box top right.
Several people were involved and I Thank You all - especially you who TESTED the mods. WIthout you, we wouldn't see this mod today.
For TNG v10.1.3 Ken Roy and Alan Craxford kindly modified the v11 .cfg
For Mod v10.1.3.4+ Alan Craxford kindly provided the .cfg


TNG version: 10.1.3
  • A working TNG installation.
  • A backup of all affected files (see the list below)
  • An installed current version of the Mod Manager (is already included in TNG)
  • Latitude and Longitude with decimal points (not decimal commas)


  1. Click on the download link, shown in the summary in the upper right corner of the page.
  2. Un-zip the file and you will find a folder. Open it.
  3. Inside the folder you will find the .cfg file and the accompanying folder OpenStreetMap.X (X = current modversion)
  4. Move/copy/FTP the .cfg file and the folder OpenStreetMap.X to the mods folder of your TNG system.
  5. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.
  6. Use Modmanager Edit options to select your map.
  7. Open Administrator >> Setup >> Map Settings and make sure the Map Key box is empty. Then click Save.
    NEW from TNG v13: Enter OSM in Map Key to activate OpenStreetMap.
  8. Clear your cache.

Mod Manager Edit options

  • Choose from ten maps. Default = OSM. See the OpenStreetMap Choices page for examples
    Acronyms for MM Edit options: OSM (default), OSMFR, SURF, EWSM, EWTM, SAT, HYDDA, WIKI, MTB and TOPO.
    NOTE that the SATellite view contains NO names or other labels
    NOTE that HEATMAPS can NOT toggle views!
  • Scale units for maps. Select "degrees", "us" (miles) or some other. Spellcheck! default = "metric".
  • Close pop-up also by clicking the map. Default = false (no)
  • Mouse scroll-wheel can zoom maps. Default = false (no)
  • A "glowing" layer between icons and map in the heatmaps. Default = true (yes) Not v10

Geocoding when Adding or Editing places (see below):

  • Number of items in the suggestion list. Default = 5
  • Keep the list open after selection. Default = false (no)
  • Max zom after selection. Default = 16
  • Copy place to Name box at page top. Default = false (no)
    • Include Zip-code (when available) in copied name. Default = true (yes)
    • Comma separated list of Country names to exclude from copied name. Default is "" (empty - none)

In the event of a problem

NOTE! Heatmaps may show a map only.
This is a known problem as the data is read by a special interpretator and it is very sensitive about what characters there are in Place names, Person names and Notes.
All problematic characters I have found have been taken care of but there may be some I don't know.
Please contact me through TNG Community Forums: TNG Specific - Code Discussion - Addons if you encounter this. Other issues:

Geocoding (Add and Edit place)

NOTE! Batch geocoding is provided by the mod OSM_Automatic_Geocoding written by User:MichelKirsch.
The "Geocode" tab is removed by OSM but re-installed by this mod.

When you open the map (Add new place) it is pointed to Lat = 0, Long = 0 (if that's your Starting Latitude and Longitude in Administration --> Setup --> Map Settings.
(If you edit a place it is of course pointed to).
The map used below is EWSM (Esri World Street Map).
Geocode1.jpg Click the magnifying glass to get a textbox:   ||   Enter a (partial) placename - local name prefered but English often works (img: Jonkoping - Jönköping)
Geocode2.jpg         ||   Geocode3.jpg Press Enter to receive a reply. Nothing happens? If there is no reply, there is no sign of it. No message, nothing...
If you do get a reply you will have a list of suggestions (incl such characters as "ö"):

Click a suggestion and the map zooms in to the place and Latitude, Longitude and Zoom will be placed in their respective boxes:
It seems to me that it is the "tip" of the pop-up and the "hole" in the custom map-pin that are pointing to the target/coordinates - not the "tip" of the map-pin.

To really pin-point a location: Close the pop-up and click the Satellite View icon (top right)

Zoom in once more (zoom = 17) and place the pin quite exactly:
50 meters = 80 pixels = 0.625 meter/pixel = 2.05 feet/pixel

You have to provide the Level yourself. You also have to add the Place Name to the box at the top. There is a Modmanager Edit option to have the name copied automatically.

Uninstalling the mod

If you want to completely Remove (uninstall) this mod and all its tables, you should

  1. click the Uninstall button to uninstall the mod and then
  2. click the Delete button to delete the config file from the mods folder.

Revision History

Version Date Description 27 Aug 2023 Fix 2 bugs : one with the bad Nominatim URL in ol-geocoder.js (Thx to Deb Smiths, DHarper, Steven and BrentH) and one with the bad link to getperson in heatmap_OSM.php (Thx to Peter, Jean-Luc and Katryne) 15 Apr 2023 Review some little things - Restore the good version number - Modify message for OSM key. 31 Jan 2023 TNG 14.0.1 b1 ready. 27 Jan 2023 TNG 14.0.1 ready. 13 Jan 2023 PHP8.2 ready by Brent Hemphill & MichelK. 01 May 2022 Fix an error in heatmap_OSM.php line 310 by Michel KIRSCH. 04 Apr 2022 Fix an incompatibility with PHP 8.1+ in heatmap_OSM.php by Michel KIRSCH. 04 Jan 2022 Some code modifications by Brent Hemphill
  • Move css so that it can be customized as the TNG 13.1.0 feature allows /BHemph
  • Update to use v6.9.0
  • Update to use v4.1.2
  • Update to remove SURF maps, since the server reached end of life and was replaced with an API key server for tiles.
  • Update to add OSMDE to replace the former SURF map tile server.
  • map tile server list to find available options.
  • Fix PHP 8 warnings created by the mod and in the OSM php files.
  • Update the language string to be like the Google standard in TNG.
  • Update some HTML validation.
  • Allow Map and Satellite icon names to be in the viewed language.

and Michel KIRSCH. Uses now $map['OSM_enabled'] internally instead of substr($mapkey,0,3) == 'OSM'.
Users must still change the Map Settings Map Key to start with OSM to activate the OpenStreetMap mod
Are test version and were never released. 02 Oct 2021 PHP8 Ready (Update by Michel Kirsch)
9 Dec 2020 Required parameter for Geocode in Edit Place was changed giving error message. Now updated. 21 Nov 2020 SATellite view can be selected as the default map 22 Sep 2020 Updated for TNG v13.0 30 Mar 2020 Fix error in v12.3.0.6 that was not loading the OpenLayer css and therefore not showing the zoom option on the map 15 Mar 2020 Updated for TNG 12.3 and also includes fix for deprecated each() function provided by Michel Kirsch for googlemaplib.php 13 Dec 2018 Heatmaps did not show for TNG 11. Thanks to Roeland V for the alert.
2 Dec 2018 One Map setting displayed a blank square for the map, but did show pins in the Event table and the Legend. Thanks to Patricia Hobbs for the alert.
An annoying out-zoom when toggled at zoom > 16 removed.
19 Nov 2018 Optional map SAT = Satellite view, Toggle your map with Satellite view, Increased map free space inner margins, Zoom in new Event-map stabilized
Credits to Alan Craxford for the TNG v10 .cfg 18 Sep 2018 Ken Roy and Alan Craxford kindly modified the v11 .cfg to suit TNG v10.1.3
10.beta9.3 18 Aug 2018 MouseWheel Zoom is OFF by default. Added to MM Edit options - Sugg. by Steven Davis
Eight new maps added for selection via MM Edit options - Sugg. by Katryne
8 Aug 2018 Googlemaps Key message removed from admin_main.php (TNG12) - Sugg. by Steven Davis
MouseWheel Zoom is OFF by default. Added to MM Edit options - Sugg. by Steven Davis
Eight new maps added for selection via MM Edit options - Sugg. by Katryne
7 Jul 2018 Place- and Zoom-levels didn't show at admin_places.php. Thanks to Steven D for the alert.
11 Jun 2018 The errors in heatmaps are gone - as far as I can tell. Thanks to cfj for the alert.
Also one BETA version f TNG v10.
10 Jun 2018 Not public. Some errors still there in heatmaps!!!
7 Jun 2018 Everything pre release is found here: TNG Community Forum: Replace Google with OSM

Sites using this mod

If you download and install this mod, please add your TNG site to the table below:

URL User Note Mod-Version Map-Version TNG-Version User-language Andreas Treichel Public & Private 13​.1​.0​.8j OSM 14.0.3 DE, UK, FR, ES, PL
Sorrell Notes Joel Ford Public & Private OSM 14.0.3 EN
The Severijns / Timmer Familytree Rob Severijns Public / Private OSM 14.0.4 NL,EN
Inez & Leifs familjeträd Leif Johnson Public site v13.0.1.8h v14.0.3 SE, EN
Swedish only (community research site).
Lars Arén Open public site: Many of Erik Hoppe's mods on display. EWSM 13.1.2 SE
Backus Family History dbackus2 Public & Private OSM 14.0 EN
Fam. van Seeventer Sandor van Seeventer Public site OSM 14.0 NL, EN, DE
Our Family History Harrie Klomp OSM maps not working now with TNG version 14.0.1 Partly installed, cannot install. OSM 14.0 NL,EN,DE,FR
Pages From Our Past Allen Prunty Must have account - validate asap OSM 13.0.3 EN
Die Familie Assent-Metternich Rainer Assent Private OSM 13.0.3 DE Jens Nielsen Private OSM 13.0.3 DK
The Everlasting Askews Chandra Martin Public OSM 13 En
A Line of Malkins in New Zealand - Nu Tirani Rick Malkin Private EWSM / Satilite 14.0.2 EN
Genealogie Dorp en Marke Losser Peter Heerink Public Site OSM 13.0.4 NL,EN,DE
À La Mémoire de Notre Famille Frédy Meyers Site privé (développement ) OSM 12.3 FR
My exploration of Genealogy Ivan Hurst Public site OSM 12.3 EN
Ahnenforschung Joachim Drexel Joachim Drexel Public site OSM 12.3 DE,EN
Families all over the world Hans Weebers public / private 12.0.1 NL,EN,DE,FR
Our Family Saga - West Virginia & Beyond Del Groves 12.2 EN
Racines Luxo-Hennuyères Michel Kirsch OSM 14.0.3 FR,EN,GE,NL
Van der Maarel Genealogy Edward van der Maarel 12.0.2 NL,EN
Keijzer, Bus Marcel Keijzer Not a public site EWSM 12.0.1 NL,EN
Stamboom familie Boersma Jan Boersma public site OSM 12.0.3 NL,EN
Roots & Relatives Remembered Ron Krzmarzick Public & Private See Here EWSM See Here EN,DE,CS
my family Oname.gif (no public site) TNG with OSM and (OSM-)Ancestor Map see User:ojay see User:ojay D,NL,GB
Our Roy and Boucher Family Ken Roy Updated Ancestor Map to work with both OpenStreetMap and Google maps 13​.1​.0​.8j OSM
TNG 14.0.4
Martius Family Hendrik Martius Half public 12.0.1 beta2 DE,EN,FR,NL C. Jegersberg Custom public 13.0 13.0 NO,SE,EN R. Petersohn Public 12.0.0 NL,DE,FR,UK
GeneaKat Katryne Chauvigné-Bourlaud Private OSM 14.0.1 FR/EN/SP/IT/PT
Family Histories Steven Davis Public/Private OSM 13.1.1 EN
Kemp(e) Family History Andrew Kemp Public See User:Kempons See User:Kempons EN
majercin genealogy resource Lawrence Majercin Public/Private 12.0.1 EN
Lindell-Herndon Genealogy Bill Herndon Public OSM 14.0.4 DA,DE,EN,ES,FR,SV
The Cole / Tanner Family Tree David Cole Public/Private see here EWSM see here EN,DE,FR,ES,NL
Extended Craxford Family Magazine Alan Craxford Representative map page from website at Craxford Lane, Gretton OSM 10.1.3 EN
Byberry Waltons Bill Walton User Account required EWSM 12.0.1 EN
Wooster Family Group Nick Wooster Public and Private (members of the Wooster Family Group) OSM 11.1.2 EN
MyMispoche Genealogy Carlton Brooks Public and Private OSM 12.0.1 EN
Bartelds/Kratzer Genealogy Jos Bartelds Public OSM 12.0.2 DE,EN,NL
Racine d'Alsace J-Louis Valory Public (registration) EWTM 13.0.4 FR
Lloyd & Lucas - A Merging of Interests Chris Lloyd Public site 12.0.1 EN
MedicSearch William Mooney Public site OSM 12.0.1 EN
Howes One-Name Study Paul Howes Public site OSM 13.0.3 EN
Leicestershire Antills and Connected Families John Antill Public Site
The Williams Family Tree Phil Williams Public site OSM 12.0.3 EN
Te Braake, Baak en Rekkense families Leo te Braake 12.0.3 EN
Porterfield Junction George Porterfield Private site OSM 12.0.3 EN
Genealogische Datenbank JPB Public site see here see here DE, EN, FR
A Bisbee Family History Rick bisbee Public site OSM 12.0.3 EN
Nordic Ancestry Mogens C. Fenger For family members only (and some exceptions) 14.0.3 OSM DA,EN
Sieinos slekt på Internett Eilif A. Nordseth For our famiily / Private site OSM 12.3 EN,SE,NO
Burrowes Family Site Garry Burrowes Family Site / Private site OSM 12.3 EN
Cumberbatch Surname & One-Name Study Bob Cumberbatch Private site OSM 13.0.1 EN
North Isles Family History Tony Gott Public site OSM 13.0 EN
Familienforschung Scabell Helga Scabell Public / Private 13.0.1 DE,EN,PT
Hooley Family Links Rick Hooley Public/Private See Here OSM See Here EN
Les Lapierre d'Amérique Normand Lapierre Private/Public site OSM 14.0 FR,EN
En skånsk släkthistoria Björn Möller Private OSM 13.0.2 SV,EN
Genealogie Buijk Peter Buijk Public/Private OSM 13.0.2 NL,EN
Our Roots&Relatives Kåre Kjøllesdal Private site OSM 14.0.2 NO,EN
Familenforschung Kattau Uwe Kattau Public / Private OSM 13.0.2 DE
YourTrees Berkshire FHS/Paul Barrett Private/Synology NAS OSM 13.0.4 EN
Hangaard Genealogy David Hangard Public / Private OSM 13.0.4 EN,NO
La famille Pierre Trudel Privé / Private OSM 13.0.4 FR,EN
Lathrope Family Genealogy S Sharpe Public OSM 13.0.4 EN
Johnson / Bryans Family Tree Charlie Ferrero Public EWTM 13.1 EN
Helwegs Ahnen Andreas Helweg Public OSM 13.1 DE,EN,NL,DK
Bastiaanssen Genealogy Jan Bastiaanssen Public / Private OSM 13.1.2 EN,NL,ES
Roy Family Genealogy Rob Roy Public OSM 13.1.1 EN
Delvee Family Association Rob Roy Public OSM 13.1.1 EN
Sejarah Thümann Jeffrey Thümann Public OSM 13.0.3 NL, EN
Släktdatabas Listerlandet TwelvE Public OSM 13.1.2 SV, EN, DE, DA
Joseph Oran Holtz Genealogy Pages Jim Holt Private See Here OSM See Here EN
Your Roots are Showing Harold Craswell Public/Private See Here OSM See Here EN
Müller-Krauer Jürgen Müller Public/Private OSM 13.1.2 DE,FR,EN
Coon White Family History Alan Coon Public / Private 13.1.2 EN
ADLER-Wien Herbert Fischer Public OSM 14.0 DE
La Saga bigey Francois BIGEY Public OSM 14.0 FR
Ô mes aieux! O mijn voorouders! Ó, meus ancestrais! Jean-Luc Halleux Public site OSM 14.0.1 FR, NL, PT, EN, ES
The Van Peer Project Drew McClenaghan Private OSM 14.0 En
Dabbling in Genealogy Jeff Rueger Public/Private EWSM 14.0.1 EN, FR
The Severijns / Timmer Familytree Rob Severijns Public / Private OSM 14.0.3 NL
Nos Familles Genealogy Eric Lenerville Public / Private OSM 14.0.4 EN, FR

TNG Modules Impacted

The following TNG Modules are modified, and should be backed up prior to installing this mod:

  • admin_editcemetery.php
  • admin_editmedia.php
  • admin_editplace.php
  • admin_main.php (TNG 12)
  • admin_newcemetery.php
  • admin_newplace.php
  • admin_places.php
  • genlib.php
  • getperson.php
  • headstones.php
  • heatmap.php // Not v10
  • personlib.php
  • placesearch.php
  • showmap.php