OpenStreetMap

OpenStreetMap
Summary	Replaces the Google maps with OpenStreetMaps
Validation	The mod is XHTML compliant.
Mod Updated	22 Sep 2020
Download link	for TNG 13.0 OpenStreetMap v13.0.0.7.zip for TNG 12.3.0 OpenStreetMap v12.3.0.6a.zip for TNG 12.0 OpenStreetMap v12.0.0.5 See Ancestor map for OpenStreetMap version for TNG 11.0 OpenStreetMap v11.1.2.5a See Ancestor map for OpenStreetMap version for TNG 10.1.3 OpenStreetMap v10.1.3.5 See Ancestor map for OpenStreetMap version
Download stats	Click For Download Stats Statistics for v12.3.0.6
Author(s)	Erik Hoppe TNG 10.1.3: Ken Roy + Alan Craxford Mod 10.1.3.4+: Alan Craxford
Homepage	OpenStreetMap (this page)
Mod Support	TNG Community Forums: TNG Specific - Code Discussion - Addons
Contact Developer
Latest Mod	13.0.0.7 for TNG v13.0 12.3.0.6a for TNG v12.3 10.1.3.5 for TNG v10.1.3 11.1.2.5a for TNG v11.1.2 12.0.0.5 for TNG v12
Min TNG V	10.1.3
Max TNG V	13.0
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, Empty your API key box, 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 re "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 Alan Craxford's sample link 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, 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
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.
8. Clear your cache.

Modmanager 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.
• 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 all its tables, you should

1. click the Remove 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
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	Name	Note	MOD-version	Using Map (Edit Opt)	TNG-version	User-Language
Botebygden (Swedish only)	Erik Hoppe	Mod dev. (Public site: Many of my mods on display)	12.3.0.6a	EWSM	12.3	SE
A Line of Malkins	Rick Malkin	Private	12.3.0.6a	OSM	12.3	En
Genealogie Dorp en Marke Losser	Peter Heerink	Public Site	12.3.0.6a	OSM	12.3	NL
À 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
Roots from Luxemburg and Hainaut(Belgium)	Michel KIRSCH		12.0.0.5	OCM	12.0.2	EN, FR
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
Treichel-Familie.de	A. Treichel	Public & Private	12.0.0.5		12.2	DE, UK, FR, ES, PL
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	Created Ancestor Map - Open Street Map to work with Open Street Map	12.3.0.6	OSM	12.3.0	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	12.0.0.3		12.0.2	NO, SE, EN
Familiestamboom.frl	R. Petersohn	Public	12.0.0.1		12.0.0	NL, DE, FR, UK
Lignées Revestoises	Katryne Chauvigné-Bourlaud	Public	12.3.0.6a	OSM	12.3	FR,EN
GeneaKat	Katryne Chauvigné-Bourlaud	Private	12.3.0.6a	OSM	12.3	FR,EN
Family Histories	Steven Davis	Public/Private	12.3.0.6a	OSM	12.3	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	12.0.0.3	OSM	12.0.2	DA, DE, EN, ES, FR, SV
Cole / Tanner Family Tree	David Cole	Public/Private	see here	EWSM	see here	English
Extended Craxford Family Magazine	Alan Craxford	Representative map page from website at Craxford Lane, Gretton	10.1.3.4	OSM	10.1.3	English
[1] Byberry Waltons	Bill Walton	User Account required	12.0.0.3	EWSM	12.0.1	English
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	Private - T19	13.0.0.7	EWSM	13.0	FR
Lloyd & Lucas - A Merging of Interests	Chris Lloyd	Public site	12.0.0.3		12.0.1	English
MedicSearch	William Mooney	Public site	12.0.0.3	OSM	12.0.1	EN
Howes One-Name Study	Paul Howes	Public site	12.0.0.5	OSM	12.2	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
Current info on my user page	JPB	Public site	see here		see here	DE, FR, EN
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)	12.0.0.5	OSM	12.2	DA, EN, DK
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	EN
North Isles Family History	Tony Gott	Public site	13.0.0.7	OSM	13.0	EN

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