03-Toggling Placemarks
This documentation is no longer maintained. Please see the new GeoServer documentation at http://docs.geoserver.org
 | This page is under construction. |
Vector Placemarks
When GeoServer generates KML for a vector dataset, it attaches information from the data to each feature that is created. When clicking on a vector feature, a pop-up window is displayed. This is called a placemark. By default this is a simple list which displays attribute data, although this information can be customized using Freemarker templates [OTHER LINK FORTHCOMING].
If you would like this information not to be shown when a feature is clicked (either for security reasons, or simply to have a cleaner user interface), it is possible to disable this functionality. To do so, use the KMATTR parameter in a KML request to turn off attribution.
The syntax for KMATTR is as follows. Note that KMATTR is a format option, so the syntax is slightly different from a simple key/value pair. Instead, append format_options=kmattr:false to your KML request. For example:
http://localhost:8080/geoserver/wms/kml?layers=<layername>&format_options=kmattr:false
Raster Placemarks
Unlike vector features, whose placemark is enabled by default, with raster images of features, placemarks are disabled by default. If you would like to enable this feature, you can use the KMPLACEMARK format option in your KML request. The syntax is similar to the KMATTR format option specified above. For example, using the KML reflector, the syntax would be:
http://localhost:8080/geoserver/wms/kml?layers=<layername>&format_options=kmplacemark:true