help writekml                                                                  
-------------------------------------------------------------------------------

Title

writekml -- Keyhole Markup Language file writer

Syntax

writekml, filename(string) plcategory(varname string) [plname(varname string) pldesc(varname string)]

Description

writekml takes latitude and longitude information from a data set in memory and writes a KML file in the current working directory.

Options

filename(string) is the name of the KML file to be written. If it already exists, it will be replaced.

plcategory(varname string) is the name of the variable that groups the places being mapped. Each group is mapped with paddles (flags) of the same color. The Google Maps API makes available eight colors. Trying to map more groups will return an error message.

plname(varname string) is the name of the variable that stores the names of the places being mapped. These names will show up in bold black letters on the list next to the Google map that the KML file renders.

pldesc(varname string) is the name of the variable that stores descriptions of the places being mapped. The descriptions will show up in smaller, lighter-colored type below the place names in the list.

Remarks

writekml expects latitude and longitude to be present in the data set as numeric variables with the same names. If place names or descriptions are missing writekml will fill in the category name instead. The easiest way to associate latitude and longitude information with a data set of physical addresses is to run geocode (if installed) before running writekml.

Example

. writekml, filename(kmlout) plname(name) pldesc(description) plcategory(kind)

Acknowledgements

Adam Ozimek and Daniel Miles, the authors of geocode, inspired this.

Author

Gabi Huiber Durham, NC USA ghuiber@gmail.com

Also see

The article that introduced geocode: Stata Journal, volume 11, number 1: dm0053 The KML documentation