Keyhole Markup Language (KML) is an XML markup language used in SketchUp, Earth and 3D Warehouse. It is an open format that can be used in many applications beyond Google. It comes in the KML and KMZ (Zipped version) formats.

KML is an XML format that describes the integration of mixed media into an application like Earth. KMZ is a container file for KML and its media objects. Inside a KMZ file, a 3D model is in the dae format.

KML and KMZ files are easy to create by hand. But of course SketchUp is needed for real 3D modeling.

Exporting Edit

Export models from the 3D Warehouse via SketchUp.

Export KML/KMZ files from SketchUp from the menus "File > Export > 3D Model" and then choose file type "Google Earth KMZ".

Share models on the 3D Warehouse from the menus "File > 3D Warehouse > Share Model".

KMZ Edit

The KMZ file is a ZIP containing image "textures", KML and COLLADA "dae" objects.

An example KMZ file, SID.kmz contains


The KML file, /doc.kml, describes the use of the resources /models/SID.dae and /images/textures*.jpg.

KML for Google Maps Edit

A limited subset of KML can be used with Google Maps. SketchUp KMZs are not compatible with Google Maps.

Dynamic Live Data Edit

KML is self updating using the Update and Change and Regions elements, and using the NetworkLinkControl element as in the example available for Earth Quakes.

 <?xml version="1.0" encoding="UTF-8"?>
 <kml xmlns="">
   <name>USGS Real-time Earthquakes</name>
     <name>Earthquake Epicenters</name>

The NetworkLink element references the source of this file (itself).

Incremental updates Edit

For dynamic display, a KMZ with a 3D model wants to do incremental updates using the Update and Change and Regions techniques so the whole model KMZ package isn't reloaded.

The Regions feature allows streaming large datasets for a smooth view. Viewing can begin before the entire file is completely downloaded. Level of detail improves as the streaming download continues.

See this note from KML Support for caveats.

Links Edit

Community content is available under CC-BY-SA unless otherwise noted.