Skip to content

jplusplus/thenmap-v0

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

thenmap

Post war political world map

  • 1946 -- 2013 is acceptable but not perfect
  • 1940 -- 1946 is missing a lot of data, but could be fixed
  • 1920 -- 1945 will require more work, as a lot of shapes need to be created from scratch
  •  -- 1920 will require _a lot_ of research
    

The code is not even a beta, so use at you own risk. Feel free to report any bugs in the Trello board

Example with dataset: Unemployment in EU

Available map languages: sv,en,fi,fr,de,es,ru,it,nl,pl,zh,pt,ar,ja,fa,no,he,tr,da,uk,ca,id,hu,vi,ko,et,cs,hi,sr,bg

Script to generate svg maps is in generators/map-factory

How to use

The easiest way to implement thenmap is by creating a <div> or <section> element with the id "thenmap", and then include the following piece of code:

<script src="//thenmap.net/thenmap.js"></script>

Nations are now colored with css classes. The css can also be hosted, like here (decolonization of the world): //www.thenmap.net/demo

And here is the unemployment in European nations, year by year (using customized styles): //www.thenmap.net/demo/demo.html

You can also build your own, custom controls for the map, like in this map showing countries taking part in the Eurovision Song Contest since the start: //www.thenmap.net/demo/demo.html

For more control over the script, see alternative usage method below

Five maps are currently avaiable, but more maps can easily be rendered. (A python script renders all maps automatically):

Nation names are translated into 30 languages, thanks to the WikiData project. Swedish and English should be fully covered. English is used as a fallback language, when no translation is available. A better approach should be implemented.

The languages are: sv,en,fi,fr,de,es,ru,it,nl,pl,zh,pt,ar,ja,fa,no,he,tr,da,uk,ca,id,hu,vi,ko,et,cs,hi,sr, and bg

All parameters to the script:

  • controls=true/false (Show control buttons below the player? Default true)
  • autoinit=true/false (Initiate the map automatically? Will also load JQuery if not already loaded. Default true)
  • mlang=LANGUAGE CODE (Map map language. Default: sv = Swedish. See the list above)
  • lang=LANGUAGE CODE (interface language. Default: sv)
  • fYear=YEAR (First year. Default 1946. Map is incomplete before 1946)
  • lYear=YEAR (Last year. Default 2013. Current borders, names and flags will be used after 2014)
  • sYear=YEAR (What year should be displayed on page load?)
  • offset=mm-dd (Show borders and nations from this date of the year. Default: 07-01. If browsing by month -- not yet implemented -- this would be date day of the month.)
  • dataCss=XXXX (Name of hosted data set. Default: none)
  • debug=true/false (Default false)

If autoinit is not used, the script is loaded like this:

var mymap = Thenmap.init(element,callback);

callback is the function to call everytime the map updates, element is the html element to attach the map to.

Avaiable methods are:

  • Thenmap.init(e,cb)
  • Thenmap.moveRight()
  • Thenmap.moveLeft()
  • Thenmap.togglePlayPause()
  • Thenmap.moveToStart()
  • Thenmap.moveToEnd()
  • Thenmap.playTimeline()
  • Thenmap.stopTimeline()

Values:

  • Thenmap.currentYear
  • Thenmap.isPlaying (true/false)
  • Thenmap.svg (the map svg element)

WikiData integration

The map has tooltip windows for each nation, that can contain additional data. By default the nation's name and flag is displayed. Flags and names are fetched from WikiData when the maps are created. Basically every nation that has a Wikipedia article in any language also has a WikiData entry. When WikiData entries are missing (yes, there are actually a few such examples!), we go there to create one. The advantages of using WikiData are plenty:

  • Translations to all languages with major Wikipedia editions, using the principle of least astonishment. This works very well for us, as these are the names that are most likely used in mainstream media. When names are missing, or we are unhappy about the name forms, we can override them with local translations.
  • We get additional data, such as flags, relatively well referenced with sources.
  • We can use images from Wikimedia Commons.
  • The nation data is kept up to date by a huge community.
  • All data is CC0
  • As each nation has a WikiData ID, more data (e.g. Wikipedia link) can easily be requested On the flipside:
  • Flags (the actual images from WikiMedia Commons, not the WikiData entry) can sometimes have more restrictive licenses. We should probably add an option to filter out CC0 and public domain images only.
  • We can only be as granular as WikiData. We will, in other words, not be able to display every flag, capital, etc, unless we create a local repository for such data

Credits, copyright and licensing

Thenmap is Copyright © 2013 Leo Wallentin and Jens Finnäs, and free to reuse, modify and distribute under the MIT license (see below).

JS minification is done with JShrink, copyright © 2009 by Robert Hafner.

The slider uses a patched and stripped down version of Dragdealer JS v0.9.5, copyright © 2010 by Ovidiu Chereches, and released under the MIT License.

Dynamic CSS and JS loading is handled by LazyLoad, copyright © 2011 by Ryan Grove ryan@wonko.com.

Internationalization by Light-i18n by Jérémie Bordier.

Nation names are provided by tens of thousand of Wikipedia editors, thanks to the WikiData project and community, CC-0, when no local translation is available.

Maps are prerendered with Kartograph.py, licensed under AGPL, by Gregor Aisch

Jenks breaks algorithm for choropleth maps by Daniel J Lewis

Colors schemes are from ColorBrewer2 by Cynthia A. Brewer, Geography, Pennsylvania State University; imported with brewer2mpl, copyright © 2012 by Matt Davis, and released under the MIT License.

The icon font was generated with IcoMoon.

Shapefiles are primarily based on Natural Earth, but also borrowing from DIVA-GIS free spatial data and CSHAPES, Weidmann, Nils B., Doreen Kuse, and Kristian Skrede Gleditsch. 2010. [The Geography of the International System: The CShapes Dataset. International Interactions 36 (1)](http://www.tandfonline.com/doi/abs/10.1080/ 03050620903554614#.UqAvJrXtkWM), especially after 1975. Hyderabad borders are from sharemap.org by anonymous users, CC-BY-SA 3.0. Countless old, public domain maps have been used to recreate old borders when needed. We would appreciate a line of credit if you find our shapes useful and reuse them!

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

Historical political world maps, an old proof-of-concept version

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published