Suggested citation format:
Ciolek, T. Matthew. 2012. Appendix 6 - The MAPS => WIKIDOT glue: A Keyhole Markup Language (KML) file ready to be used as the X4 script within the Google Earth (http://www.google.com/earth/index.html) and Google Maps' (http://maps.google.com) mapping environments. [in:]
Ciolek, T. Matthew and Stewart Gordon. 2012. Mapping the Contours of a Buddhist World: An Online Database of Georeferenced Buddhist Monasteries, 200 -1200 CE.
www.ciolek.com/PAPERS/mbm-mapping-buddhist-world.html
Appendix 6 - The MAPS => WIKIDOT glue:
A Keyhole Markup Language (KML) file ready to be used as the X4 script
within the Google Earth (http://www.google.com/earth/index.html)
and Google Maps' (http://maps.google.com) mapping environments
The following programming codes have been developed in 2009 by T. Matthew Ciolek for
the "Mapping Buddhist
Monasteries (MBM) 200-1200 CE Project" (http://monastic-asia.wikidot.com).
Please acknowledge this document
(using the suggested citation format above) should you find the enclosed code useful in your own mapping operations.
Return to the Mapping the Contours of a Buddhist World paper.
INSTRUCTIONS to a potential work-oriented Reader:
- When published on Google Maps this KML-based X4 script generates an electronic map of a type that was shown and described in Appendix 5.
- Note that the colour-coded sections (visible in three colours in the online version of this paper, otherwise in paper publications shown as bolded, underlined, or italicised text, respectively) illustrate the overall structure and component parts of the file below:
(a) green or bolded text - kml code used to define the complete set of all potential symbols and colours for mappable data-points as used in the "Mapping Buddhist Monasteries (MBM) 200-1200 CE Project";
(b) blue or underlined text - kml code used to define individual Google Maps symbols;
(c) red or italicised text - kml code used to link individual Google Maps symbols back to the relevant online data files.
- To replicate this code in your own projects feel free to copy all that is contained between the start / end lines below.
- Save it as a plain text file with the extension ".kml" (eg, MyProject.kml)
- Open MyProject.kml with your standalone Google Earth software, which can be downloaded free of charge in both Windows and OS X formats (http://www.google.com/earth/index.html).
- Google Earth will display the following three colour-coded locations: (a) Abhayagiri, in modern Sri Lanka, (b) Nalanda, in modern India and (c) Pagan, in modern Myanmar.
- Note that in the sample below, individual monastic institutions such as Abhayagiri and Nalanda are represented as yellow and blue droplets respectively. However, Pagan, a place known to host in its time of splendour several tens of Buddhist monasteries, is represented by a set of black and white concentric circles.
- Note that the hypertext links to the three respective MBM database files (i.e. Abhayagiri, Nalanda, Pagan) will become operational in the Google Earth environment.
- Upload the now-tested MyProject.kml file to your "My Places" location within Google Maps. This requires a personal a Google Maps account.
- Note that the hypertext links to the three respective MBM database files (i.e. Abhayagiri, Nalanda, Pagan) will now become operational in the Google Maps environment as well.
- You can use the MyProject.kml stub file to develop and grow your own collection of georeferenced and colour-coded mappable data points with back-links to your own or others' sets of online data files.
- Remember, none of your maps should plot more than approximately 200 symbols, otherwise your maps become complicated and messy, in both structural and appearance/display senses. Therefore, new maps, contiguous or otherwise, need to be created in the "My Places" location of your Google Maps account.
- When your work is complete, remember to sign out of the account.
-- start --
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2" xmlns:gx="http://www.google.com/kml/ext/2.2"
xmlns:kml="http://www.opengis.net/kml/2.2" xmlns:atom="http://www.w3.org/2005/Atom">
<Document>
<name>xxxxx.kml (for future reference remember to provide here the name of your new KML source file. Remember to remove this comment in brackets from your KML file.) </name>
<StyleMap id="msn_wht-diamond">
<Pair>
<key>normal</key>
<styleUrl>#sn_wht-diamond</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_wht-diamond</styleUrl>
</Pair>
</StyleMap>
<Style id="sh_target">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/shapes/target.png</href>
</Icon>
</IconStyle>
</Style>
<Style id="sn_red-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/red-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/red-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sn_blu-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/blu-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/blu-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sn_ylw-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/ylw-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/ylw-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sn_target">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/shapes/target.png</href>
</Icon>
</IconStyle>
</Style>
<StyleMap id="msn_target">
<Pair>
<key>normal</key>
<styleUrl>#sn_target</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_target</styleUrl>
</Pair>
</StyleMap>
<StyleMap id="msn_blu-diamond">
<Pair>
<key>normal</key>
<styleUrl>#sn_blu-diamond</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_blu-diamond</styleUrl>
</Pair>
</StyleMap>
<Style id="sh_red-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/red-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/red-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sn_pink-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/pink-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/pink-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<StyleMap id="msn_ylw-diamond">
<Pair>
<key>normal</key>
<styleUrl>#sn_ylw-diamond</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_ylw-diamond</styleUrl>
</Pair>
</StyleMap>
<Style id="sn_grn-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/grn-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/grn-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sh_ylw-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/ylw-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/ylw-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sh_grn-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/grn-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/grn-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<StyleMap id="msn_grn-diamond">
<Pair>
<key>normal</key>
<styleUrl>#sn_grn-diamond</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_grn-diamond</styleUrl>
</Pair>
</StyleMap>
<StyleMap id="msn_red-diamond">
<Pair>
<key>normal</key>
<styleUrl>#sn_red-diamond</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_red-diamond</styleUrl>
</Pair>
</StyleMap>
<Style id="sh_wht-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/wht-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/wht-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sn_wht-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/wht-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/wht-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sh_pink-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/pink-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/pink-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<Style id="sh_blu-diamond">
<IconStyle>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/paddle/blu-diamond.png</href>
</Icon>
<hotSpot x="32" y="1" xunits="pixels" yunits="pixels"/>
</IconStyle>
<ListStyle>
<ItemIcon>
<href>http://maps.google.com/mapfiles/kml/paddle/blu-diamond-lv.png</href>
</ItemIcon>
</ListStyle>
</Style>
<StyleMap id="msn_pink-diamond">
<Pair>
<key>normal</key>
<styleUrl>#sn_pink-diamond</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#sh_pink-diamond</styleUrl>
</Pair>
</StyleMap>
<Placemark><name>Abhayagiri, SL</name>
<description>
<![CDATA[<table border="1"><tr><td>
<font size="-1">See the monastery's data file at<br /><a href="http://monastic-asia.wikidot.com/abhayagiri">http://monastic-asia.wikidot.com/abhayagiri</a>
</font></td></tr></table>]]>
</description>
<styleUrl>#msn_ylw-diamond</styleUrl><Point><coordinates>80.38330000000001,8.35,0</coordinates></Point></Placemark>
<Placemark><name>Nalanda, IN</name>
<description>
<![CDATA[<table border="1"><tr><td>
<font size="-1">See the monastery's data file at<br /><a href="http://monastic-asia.wikidot.com/nalanda">http://monastic-asia.wikidot.com/nalanda</a>
</font></td></tr></table>]]>
</description>
<styleUrl>#msn_blu-diamond</styleUrl><Point><coordinates>84.41670000000001,25.2167,0</coordinates></Point></Placemark>
<Placemark><name>Pagan monastic cluster, MM</name>
<description>
<![CDATA[<table border="1"><tr><td>
<font size="-1">See the monastery's data file at<br /><a href="http://monastic-asia.wikidot.com/pagan">http://monastic-asia.wikidot.com/pagan</a>
</font></td></tr></table>]]>
</description>
<styleUrl>#msn_target</styleUrl><Point><coordinates>94.84999999999999,21.1667,0</coordinates></Point></Placemark>
</Document>
</kml>
-- the end --
http://www.ciolek.com/PAPERS/mbm-mapping-buddhist-world.html
Copyright (c) 2012 by T. Matthew Ciolek. All rights reserved.