OpenStreetMap

OpenStreetMap
Summary	Replaces Google maps with OpenStreetMaps
Validation	The mod is XHTML compliant.
Mod Updated	6 Aug 2024
Download link	For TNG 14.0.5 TNG 14.0.6 with Google Maps patch2openstreetmap_v14.0.5.9c_p.zip TNG 14.0.5 Without patch Openstreetmap_v14.0.5.9c.zip For TNG 13.1.0 TNG 14.0 openstreetmap_v13.1.0.9c.zip For TNG 13.0 v13.0.0.7c For TNG 12.3.0 v12.3.0.6b For TNG 12.0 v12.0.0.5b See Ancestor map for OpenStreetMap version For TNG 11.0 v11.1.2.5b See Ancestor map for OpenStreetMap version For 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, 13.1.0.9, and 14.0.5.9
Author(s)	Erik Hoppe TNG 10.1.3: Ken Roy + Alan Craxford Mod 10.1.3.4+: Alan Craxford Mod 13+ Brent Hemphill + Michel Kirsch
Homepage	OpenStreetMap (This page)
Mod Support	TNG Community Forums
Contact Developer	TNG Community Forums
Latest Mod	14.0.5.9c-p for TNG 14.0.5 with patch 14.0.5.9c for TNG 14.0.5 without patch 13.1.0.8j for TNG v13.1+ 13.0.0.7c for TNG v13.0 12.3.0.6b for TNG v12.3 10.1.3.5b for TNG v10.1.3 11.1.2.5b for TNG v11.1.2 12.0.0.5b for TNG v12
Min TNG V	10.1.3
Max TNG V	14+
Files modified	See TNG Modules Impacted
Related Mods	OSM Automatic Geocoding written by Michel Kirsch
Notes	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 google-maps-platform-noreply@google.com to keyholders(?)
Thanks to Steven Davis for the forward.

Hi,

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.

Sincerely,
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!

Developer

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

Requirements

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)

Installation

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, OSMDE, 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:

• Try using the Mod Manager Remove capability
• Replace all affected files with the copies you made before the installation.
• TNG Community Forums: TNG Specific - Code Discussion - Addons

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).
Click the magnifying glass to get a textbox:   ||   Enter a (partial) placename - local name prefered but English often works (img: Jonkoping - Jönköping)
         ||    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 any tables if created, 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
14.0.5.9c_p	6 Aug 2024	Updated by Steven Davis to support Google Maps patch on TNG 14.0.5 download page testing provided by Ron Krzmarzick
14.0.5.9c 13.1.0.9c	30 Jul 2024	Updated by Ken Roy to fix syntax error in heatmap
13.1.0.9	28 Jul 2024	Updated by Ken Roy to remove the links to polyfill.io completely as not needed for TNG 13.1 through 14.0.4 testing provided by Ron Krzmarzick
14.0.5.9b	27 Jul 2024	Updated by Ken Roy to remove the links to polyfill.io completely as not needed for TNG 14.0.5 testing provided by Ron Krzmarzick
14.0.5.9a	29 Jun 2024	Updated by Ron Krzmarzick to fix polyfill.io vulnerability
14.0.5.9	2 Jun 2024	Updated by Ken Roy for changes made to fix Google Map async calls during TNG 14.0.5
13.1.0.8j	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)
13.1.0.8h	15 Apr 2023	Review some little things - Restore the good version number - Modify message for OSM key.
13.1.0.8g	31 Jan 2023	TNG 14.0.1 b1 ready.
13.1.0.8f	27 Jan 2023	TNG 14.0.1 ready.
13.1.0.8e	13 Jan 2023	PHP8.2 ready by Brent Hemphill & MichelK.
13.1.0.8d	01 May 2022	Fix an error in heatmap_OSM.php line 310 by Michel KIRSCH.
13.1.0.8c	04 Apr 2022	Fix an incompatibility with PHP 8.1+ in heatmap_OSM.php by Michel KIRSCH.
13.1.0.8b	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 https://github.com/openlayers/openlayers Update to use v4.1.2 https://github.com/jonataswalker/ol-geocoder 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. http://leaflet-extras.github.io/leaflet-providers/preview/ 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
13.1.0.8 13.1.0.8a		Are test version and were never released.
13.0.0.7c	02 Oct 2021	PHP8 Ready (Update by Michel Kirsch)
13.0.0.7b 12.3.0.6b 12.0.0.5b 11.1.2.5b 10.1.3.5b	9 Dec 2020	Required parameter for Geocode in Edit Place was changed giving error message. Now updated.
13.0.0.7a	21 Nov 2020	SATellite view can be selected as the default map
13.0.0.7	22 Sep 2020	Updated for TNG v13.0
12.3.0.6a	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
12.3.0.6	15 Mar 2020	Updated for TNG 12.3 and also includes fix for deprecated each() function provided by Michel Kirsch for googlemaplib.php
11.1.2.5a	13 Dec 2018	Heatmaps did not show for TNG 11. Thanks to Roeland V for the alert.
10.1.3.5 11.1.2.5 12.0.0.5	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.
10.1.3.4 11.1.2.4 12.0.0.4	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
10.1.3.3	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
11.1.2.3 12.0.0.3	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
11.1.2.2 12.0.0.2	7 Jul 2018	Place- and Zoom-levels didn't show at admin_places.php. Thanks to Steven D for the alert.
10.0.0.beta8 11.1.2.1 12.0.0.1	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.
11.1.2.0 12.0.0.0	10 Jun 2018	Not public. Some errors still there in heatmaps!!!
10.0.0.beta7 11.1.2.beta7 12.0.0.beta7	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
Sorrell Notes	Joel Ford	Public & Private	13.1.0.8j	OSM	14.0.3	EN
Treichel-Familie.de	Andreas Treichel	Public & Private	14​.0​.5​.9c	OSM	14.0.6	DE,EN,FR,ES,PL
The Severijns / Timmer Familytree	Rob Severijns	Public / Private	See here	OSM	See here	NL,EN
Familjen Johnson	Leif Johnson	Public site	See here	OSM	See here	SE, EN
Botebygden Swedish only (community research site).	Lars Arén	Open public site: Many of Erik Hoppe's mods on display.	13.1.0.8d	EWSM	13.1.2	SE
Backus Family History	dbackus2	Public & Private	13.1.0.8g	OSM	14.0	EN
Fam. van Seeventer	Sandor van Seeventer	Public site	14.0.5.9c_p	OSM	TNG 14.0.5	NL, EN, DE
Our Family History	Harrie Klomp	OSM maps not working now with TNG version 14.0.1 Partly installed, cannot install.	13.1.0.8g	OSM	14.0	NL,EN,DE,FR
Pages From Our Past	Allen Prunty	Must have account - validate asap	13.0.0.8d	OSM	13.0.3	EN
Die Familie Assent-Metternich	Rainer Assent	Private	13.0.0.7b	OSM	13.0.3	DE
jkni.dk/TNG	Jens Nielsen	Private	13.0.0.7b	OSM	13.0.3	DK
The Everlasting Askews	Chandra Martin	Public	13.0.0.7a	OSM	13	En
A Line of Malkins in New Zealand - Nu Tirani	Rick Malkin	Private	13.1.0.8j	EWSM / Satilite	14.0.2	EN
Genealogie Dorp en Marke Losser	Peter Heerink	Public Site	13.0.0.7b	OSM	13.0.4	NL,EN,DE
À La Mémoire de Notre Famille	Frédy Meyers	Site privé (développement )	12.3.0.6a	OSM	12.3	FR
My exploration of Genealogy	Ivan Hurst	Public site	12.3.0.6	OSM	12.3	EN
Ahnenforschung Joachim Drexel	Joachim Drexel	Public site	12.3.0.6a	OSM	12.3	DE,EN
Families all over the world	Hans Weebers	public / private	12.0.0.5		12.0.1	NL,EN,DE,FR
Our Family Saga - West Virginia & Beyond	Del Groves		12.0.0.5		12.2	EN
Racines Luxo-Hennuyères	Michel Kirsch		13.1.0.8h	OSM	14.0.3	FR,EN,GE,NL
Van der Maarel Genealogy	Edward van der Maarel		12.0.0.3		12.0.2	NL,EN
Keijzer, Bus	Marcel Keijzer	Not a public site	12.0.0.2	EWSM	12.0.1	NL,EN
Stamboom familie Boersma	Jan Boersma	public site	12.0.0.5	OSM	12.0.3	NL,EN
Roots & Relatives Remembered	Ron Krzmarzick	Public & Private	See here	EWSM	See here	EN,DE,CS
my family		(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	14.0.5.9b	OSM	TNG 14.0.5	EN,FR
Martius Family	Hendrik Martius	Half public	12.0.0.1		12.0.1 beta2	DE,EN,FR,NL
Jegersberg.com	C. Jegersberg	Custom public	13.0		13.0	NO,SE,EN
Familiestamboom.frl	R. Petersohn	Public	12.0.0.1		12.0.0	NL,DE,FR,UK
GeneaKat	Katryne Chauvigné-Bourlaud	Private	13.1.0.8g	OSM	14.0.1	FR/EN/SP/IT/PT
Family Histories	Steven Davis	Public/Private	14.0.5.9b	OSM	TNG 14.0.5	EN
Kemp(e) Family History	Andrew Kemp	Public	See User:Kempons		See User:Kempons	EN
majercin genealogy resource	Lawrence Majercin	Public/Private	12.0.0.2		12.0.1	EN
Lindell-Herndon Genealogy	Bill Herndon	Public	13.1.0.8h	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	10.1.3.4	OSM	10.1.3	EN
Byberry Waltons	Bill Walton	User Account required	12.0.0.3	EWSM	12.0.1	EN
Wooster Family Group	Nick Wooster	Public and Private (members of the Wooster Family Group)	11.1.2.3	OSM	11.1.2	EN
MyMispoche Genealogy	Carlton Brooks	Public and Private	12.0.0.3	OSM	12.0.1	EN
Bartelds/Kratzer Genealogy	Jos Bartelds	Public	12.0.0.3	OSM	12.0.2	DE,EN,NL
Racine d'Alsace	J-Louis Valory	Public (registration)	13.0.0.7	EWTM	13.0.4	FR
Lloyd & Lucas - A Merging of Interests	Chris Lloyd	Public site	14.0.5.9c		14.0.5	EN
MedicSearch	William Mooney	Public site	12.0.0.3	OSM	12.0.1	EN
Howes One-Name Study	Paul Howes	Public site	13.0.0.7b	OSM	13.0.3	EN
Leicestershire Antills and Connected Families	John Antill	Public Site	12.0.0.5
The Williams Family Tree	Phil Williams	Public site	12.0.0.5	OSM	12.0.3	EN
Te Braake, Baak en Rekkense families	Leo te Braake		12.0.9.5		12.0.3	EN
Porterfield Junction	George Porterfield	Private site	12.0.0.5	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	12.0.0.5	OSM	12.0.3	EN
Nordic Ancestry	Mogens C. Fenger	For family members only (and some exceptions)	14.0.5	OSM	13.1.0.8j	DA,EN
Sieinos slekt på Internett	Eilif A. Nordseth	For our famiily / Private site	12.3.0.6a	OSM	12.3	EN,SE,NO
Burrowes Family Site	Garry Burrowes	Family Site / Private site	12.3.0.6a	OSM	12.3	EN
Cumberbatch Surname & One-Name Study	Bob Cumberbatch	Private site	13.0.0.7	OSM	13.0.1	EN
North Isles Family History	Tony Gott	Public site	13.0.0.7	OSM	13.0	EN
Familienforschung Scabell	Helga Scabell	Public / Private	12.03.0.6		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	13.1.0.8g	OSM	14.0	FR,EN
En skånsk släkthistoria	Björn Möller	Private	13.0.0.7b	OSM	13.0.2	SV,EN
Genealogie Buijk	Peter Buijk	Public/Private	13.0.0.7b	OSM	13.0.2	NL,EN
Our Roots&Relatives	Kåre Kjøllesdal	Private site	14.0.5.9	OSM	14.0.5	NO,EN
Familenforschung Kattau	Uwe Kattau	Public / Private	13.0.0.7b	OSM	13.0.2	DE
YourTrees	Berkshire FHS/Paul Barrett	Private/Synology NAS	13.0.0.7b	OSM	13.0.4	EN
Hangaard Genealogy	David Hangard	Public / Private	13.0.0.7b	OSM	13.0.4	EN,NO
La famille Trudel-le.inc	Pierre Trudel	Privé / Private	10.0.0.7b	OSM	13.0.4	FR,EN
Lathrope Family Genealogy	S Sharpe	Public	13.0.0.7c	OSM	13.0.4	EN
Johnson / Bryans Family Tree	Charlie Ferrero	Public	13.0.0.7c	EWTM	13.1	EN
Helwegs Ahnen	Andreas Helweg	Public	13.0.0.7c	OSM	13.1	DE,EN,NL,DK
Bastiaanssen Genealogy	Jan Bastiaanssen	Public / Private	14.0.5.9	OSM	TNG 14.0.5	EN, NL, ES
Roy Family Genealogy	Rob Roy	Public	3.1.0.8b	OSM	TNG 13.1.1	EN
Delvee Family Association	Rob Roy	Public	3.1.0.8b	OSM	TNG 13.1.1	EN
Sejarah Thümann	Jeffrey Thümann	Public	13.0.0.7c	OSM	13.0.3	NL, EN
Släktdatabas Listerlandet	TwelvE	Public	13.1.0.8d	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	13.0.0.7c	OSM	13.1.2	DE,FR,EN
Coon White Family History	Alan Coon	Public / Private	13.0.0.1		13.1.2	EN
ADLER-Wien	Herbert Fischer	Public	13.1.0.8d	OSM	14.0	DE
La Saga bigey	Francois BIGEY	Public	13.1.0.8g	OSM	14.0	FR
Ô mes aieux! O mijn voorouders! Ó, meus ancestrais!	Jean-Luc Halleux	Public site	13.1.0.8g	OSM	14.0.1	FR, NL, PT, EN, ES
The Van Peer Project	Drew McClenaghan	Private	13.1.0.8j	OSM	14.0	En
Dabbling in Genealogy	Jeff Rueger	Public/Private	13.1.0.8g	EWSM	14.0.1	EN, FR
The Severijns / Timmer Familytree	Rob Severijns	Public / Private	See here	EWSM	See here	NL
Nos Familles Genealogy	Eric Lenerville	Public / Private	13.1.0.8j	OSM	14.0.4	EN, FR
Auf den Spuren meiner Ahnen	Michael Klein	Public / Private	14.0.5.9	OSM	TNG 14.0.5	DE, FR,ES,NL,EN
Genealogie.nu	Peter Fasol	Public	14.0.5.9	OSM	TNG 14.0.5	NL

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