Proposed Google Mapping API XML Standard

Convention: 
	Text in the form of #Title# are placeholders for data. See explanations following the XML for more information.




<map title="#Document-Title#">

 <mapcenter lng="#Map-Center-Longitude#" lat="#Map-Center-Latitude#" zoom="#Map-Zoom-Level#"/>
 <mapcenter zoom="auto" slat="#S-Lat#" wlng="#W-Lng#" nlat="#N-LAT#" elng="#E-Lng#"/>

 <info #Additional-Freeform-Attributes# />

 <polyline color="#Polyline-Hex-Color#" weight="#Polyline-Weight#" width="#Polyline-Width#">
  <point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
  <point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
  <point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
  .
  .
  .
  <point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
 </polyline>

 <marker lng="#Marker-Point-Longitude#" lat="#Marker-Point-Latitude#" icon="#Icon-Name#">
  <infowindow><![CDATA[#HTML-for-Infowindow#]]></infowindow>
  <link><![CDATA[#HTML-for-Marker-Link#]]></link>
 </marker>

 <icon name="#Icon-Name#" copy="#Icon-Copy#" xanchor="#Icon-X-Anchor#" yanchor="#Icon-Y-Anchor#" xiwanchor="#Icon-X-IWAnchor#" yiwanchor="#Icon-Y-IWAnchor#" xisanchor="#Icon-X-ISAnchor#" yisanchor="#Icon-Y-ISAnchor#">
  <image src="#Icon-Source-Image#" width="#Icon-Source-Image-Width#" height="#Icon-Source-Image-Height#"/>
  <shadow src="#Icon-Shadow-Image#" width="#Icon-Shadow-Image-Width#" height="#Icon-Shadow-Height#"/>
  <printimage src="#Icon-Print-Image#" />
  <mozprintimage src="#Icon-Moz-Print-Image#" />
  <printshadow src="#Icon-Print-Shadow-Image#" />
  <transparent src="#Icon-Transparent-Image#" />
  <imageMap>
   <mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
   <mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
   <mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
   .
   .
   .
   <mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
  </imageMap>
 </icon>

</map>



Documentation:	

Element: <map> (Required)

	Attribute	Type	Description					Placeholder			Required	Default
        title		string	Document Title					#Document-Title#		no		blank

	</map> (required)

	Format: <map title="#Document-Title#">
		.
		.
		.
                </map>

	Ex:	<map title="this is the title of the map"> 
		.
		.
		.
		</map>

Element: <mapcenter> (optional) - Set the map center and zoom

	Attribute	Type	Description					Placeholder			Required	Default
	lng		float	Map initial center longitude			#Map-Center-Longitude#		no		-90
	lat		float	Map initial center latitude			#Map-Center-Latitude#		no		35
	zoom		int	Map initial zoom level (1-15)			#Map-Zoom-Level#		no		5

	Format: <mapcenter lng="#Map-Center-Longitude#" lat="#Map-Center-Latitude#" zoom="#Map-Zoom-Level#"/>

	Ex:	<mapcenter lng="-90" lat="35" zoom="5"> 

	Automatic Zoom Calculated with these attributes:
	zoom		text	Set to 'auto'					#Map-Zoom-Level#		no		--
        slat		float	South Latitude - minx				#S-Lat#				no		--
        nlat		float	North Latitude - maxx				#N-Lat#				no		--
        wlng		float	West Longitude - miny				#W-Lng#				no		--
        elng		float	East Longitude - maxy				#E-Lng#				no		--

	Format: <mapcenter zoom="auto" slat="#S-Lat#" wlng="#W-Lng#" nlat="#N-LAT#" elng="#E-Lng#"/>

	Ex:	<mapcenter zoom="auto" slat="30" wlng="-95" nlat="38" elng="-85"> 

	Note: Center of map will be calculated automatically as the center of the bounding box coordinates

Element: <info> (optional) - Freeform element for non-API data

	Attribute	Type	Description					Placeholder			Required	Default
	All attributes and child elements are free form.

	Format: <info #Additional-Freeform-Attributes# />
		or
		<info #Additional-Freeform-Attributes#>
			<freeform />
			.
			.
			.
			<freeform />
		</info>

Element: <polyline> (optional) - Draw lines on a map. 

	Attribute	Type	Description					Placeholder			Required	Default
	color		string	Hex color value for polyline, start with #	#Polyline-Hex-Color#		no		#0000ff
	weight		float	Value from 0 to 1 for opacity, 1 is solid.	#Polyline-Weight#		no		0.5
	width		int	Width of polyline in pixels.			#Polyline-Width#		no		1

	</polyline> (required)

	Element: <polyline> Child <point> (at least 2 required) Longitude and Latitude in Decimal notation for a point on the polyline

	Attribute	Type	Description					Placeholder			Required	Default
	lng		float	Longitude coordinate				#Polyline-Point-Longitude#	yes		none
	lat		float	Latitude coordinate				#Polyline-Point-Longitude#	yes		none

	Format: <polyline color="#Polyline-Hex-Color#" weight="#Polyline-Weight#" width="#Polyline-Width#">
			<point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
			<point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
			<point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
			.
			.
			.
			<point lng="#Polyline-Point-Longitude#" lat="#Polyline-Point-Latitude#" />
		</polyline>

	Ex:	<polyline color="#ff0000" weight="1.0" width="2">
			<point lng="-90.422973" lat="34.953493" />
			<point lng="-90.422973" lat="35.362176" />
			<point lng="-89.478149" lat="35.353216" />
			<point lng="-89.489135" lat="34.953493" />
			<point lng="-89.972534" lat="34.809293" />
			<point lng="-90.422973" lat="34.953493" />
		</polyline>

Element: <marker> (optional) - Place a marker on the map

	Attribute	Type	Description					Placeholder			Required	Default
	lng		float	Longitude coordinate				#Marker-Point-Longitude#	yes		none
	lat		float	Latitude coordinate				#Marker-Point-Longitude#	yes		none
	icon		string	Name of the icon (see <icon> element)		#Icon-Name#			no		Google red icon

	Element: <marker> Child <infowindow> (optional) Contents of the infowindow
		<infowindow> element contains html for the infowindow. Any html tags and text can be contained in this
		element, including newline characters. Use the <![CDATA[ html tags ]]> format to include html tags.

	Element: <marker> Child <link> (optional) Contents of the link html used to open an infowindow
		<link> element contains html for a link used to open the infowindow. Any html tags and text can be contained in this
		element, including newline characters. Use the <![CDATA[ html tags ]]> format to include html tags. Usually the form
		of this element is an abbreviated version of the infowindow html.

	Format:	<marker lng="#Marker-Point-Longitude#" lat="#Marker-Point-Latitude#" icon="#Icon-Name#">
			<infowindow><![CDATA[#HTML-for-Infowindow#]]></infowindow>
			<link><![CDATA[#HTML-for-Marker-Link#]]></link>
		</marker>

	Ex:	<marker lng="-89.25" lat="34.75" iconname="red small">
			<infowindow><![CDATA[<div style="width:200px;"><font style="font-size: 1.5em;">Red Icon, small</font></div>]]></infowindow>
			<link><![CDATA[Marker 1:<font style="font-size: .8em;">Small Red Icon</font>]]></link>
		</marker>

Element: <icon> (optional) - Describe an icon

	Attribute	Type	Description					Placeholder			Required	Default
	name		string	Icon name, used in <marker> as attribute "icon"	#Icon-Name#			yes		none
	copy		string	Icon name to copy attributes from		#Icon-Copy#			no		none
	xanchor		int	'x' coordinate icon anchor point		#Icon-X-Anchor#			yes		0
	yanchor		int	'y' coordinate icon anchor point		#Icon-Y-Anchor#			yes		0
	xiwanchor	int	'x' coordinate infowindow anchor point		#Icon-X-IWAnchor#		yes		0
	yiwanchor	int	'y' coordinate infowindow anchor point		#Icon-Y-IWAnchor#		yes		0
	xisanchor	int	'x' coordinate icon shadow anchor point		#Icon-X-ISAnchor#		yes		0
	yisanchor	int	'y' coordinate icon shadow anchor point		#Icon-Y-ISAnchor#		yes		0

	Element: <icon> Child <image> (required) Icon's image file

	Attribute	Type	Description					Placeholder			Required	Default
	src		string	Image file name, relative or absolute path	#Icon-Source-Image#		yes		none
	width		int	Pixel width of image file			#Icon-Source-Image-Width#	no*		source
	height		int	Pixel height of image file			#Icon-Source-Image-Height#	no*		source

	Element: <icon> Child <shadow> (optional) Icon's shadow file (Defaults to source if element is missing.)

	Attribute	Type	Description					Placeholder			Required	Default
	src		string	Image file name, relative or absolute path	#Icon-Source-Image#		yes		none
	width		int	Pixel width of image file			#Icon-Source-Image-Width#	no*		source
	height		int	Pixel height of image file			#Icon-Source-Image-Height#	no*		source

Format:	<icon name="#Icon-Name#" copy="#Icon-Copy#" xanchor="#Icon-X-Anchor#" yanchor="#Icon-Y-Anchor#" 
	xiwanchor="#Icon-X-IWAnchor#" yiwanchor="#Icon-Y-IWAnchor#" xisanchor="#Icon-X-ISAnchor#" yisanchor="#Icon-Y-ISAnchor#">
		<image src="#Icon-Source-Image#" width="#Icon-Source-Image-Width#" height="#Icon-Source-Image-Height#"/>
		<shadow src="#Icon-Shadow-Image#" width="#Icon-Shadow-Image-Width#" height="#Icon-Shadow-Height#"/>
		<printimage src="#Icon-Print-Image#" />
		<mozprintimage src="#Icon-Moz-Print-Image#" />
		<printshadow src="#Icon-Print-Shadow-Image#" />
		<transparent src="#Icon-Transparent-Image#" />
		<imageMap>
			<mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
			<mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
			<mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
			.
			.
			.
			<mark x="#Icon-Imagemap-X-Mark#" y="#Icon-Imagemap-Y-mark#"/>
		</imageMap>
	</icon>


Standards Document Rev 2.1 02/02/2006 John Coryat - USNaviguide