Google KML Writer Parameters

The value of the hint attribute of the kml element for the dataset.

The default is none. Users wishing to write datasets for Google Sky should use the value target=sky.

See the Google KML documentation for further information.

Specifies the filename of an external kml file that will be used to store Style or StyleMap elements.

If specified, all Style and Stylemap elements will be routed to this document. The value of this parameter may be a filename or a relative path (for example files/style.kml).

When using the writer to create a KMZ file, it is recommended that you put the style document in a subdirectory. This ensures the proper file will be loaded when the KMZ is opened in Google Earth.

Specifies the filename of an external kml file that will be used to store Schema information for the dataset. If specified, Schema elements will be written to this file, and the schemaUrl value of each placemark will be updated accordingly.

The value of this parameter may be a filename or a relative path.

When using the writer to create a KMZ file, it is recommended to put the schema document in a sub-directory. This ensures the proper file will be loaded when the KMZ is opened in Google Earth.

Controls whether or not the writer will examine incoming features to determine if they have raster geometry. If a raster geometry is detected, the feature will be forced to be a GroundOverlay feature. The value can be Yes or No. The default is Yes.

Specifies how the writer will handle raster features. This preference only applies if Generate Raster Ground Overlays is enabled.

There are three possible values:

• write - (default) Write the raster feature using the FME writer that corresponds to the Raster Output Format parameter. This option allows the KML writer to handle raster features irregardless of their origin, as well as to take advantage of any resampling performed during the transformation process.
• copy - Copy the image file that the raster feature originated in to the directory of the KML dataset. The resulting <GroundOverlay> element will reference the copy of the image file. Note: This will only work for PNG, JPEG, or TIFF images.
• relative - Similar to the "copy" option, but leaves the image file in its original location. This option avoids gratuitous file copying.

Specifies which file format should be used if the Raster Handling Mode parameter is set to "write".

Possible values are tiff (default), jpeg, png, gif.

Specifies the preferred format for associated texture files. This preference will be used as long as the specified format supports the properties of the texture raster; if not, it will be overridden.

In the default Auto mode, the writer chooses the best representation based on the incoming texture raster.

If the preferred format is ignored, a message is added to the log file. Possible reasons that the preference will be ignored include a lack of raster palette support, alpha channel support, or color depth support in the selected format.

Specifies whether icons should be copied from their location to the dataset’s images directory.

The possible values are Yes and No. The default is Yes.

Note: This only applies to icons referenced by the kml_icon attribute, icons referenced by the kml_icon_href will not be copied. If the kml_icon_href is present, the value of kml_icon will be ignored.

Specifies whether or not schema elements should be output. Possible values are Yes, or No. The default is Yes.

Specifies whether or not NetworkLink elements should be automatically generated when documents are referenced. The default is Yes.

Specifies whether features should be oriented before writing.

Possible values are None (default), Right, and Left.

Specifies whether or not the writer should increase the logging verbosity.

The default is No.

Selecting Yes ensures that the output KML file contains an XML comment that indicates the version of FME used to create the file.

Controls whether a root-level <Document> element is created.

The default is No.

Specifies whether or not features with vector geometry (Placemarks) should be passed through the regionator pipeline prior to writing.

The default is No.

Specifies whether or not GroundOverlay features should be passed through the ground overlay pyramider pipeline prior to writing. This pipeline will create an ‘image pyramid’ out of the overlay raster, splitting the raster into smaller files or varying resolution, to improve viewing performance.

The default is No.

Specifies whether or not PhotoOverlay features should be passed through the photo overlay pyramider pipeline prior to writing.

The default is No.

If the value is no (default), then the folders for user-defined feature types will only be created if at least one feature is written with a feature type corresponding to the folder name.

If the value is yes, then a <Folder> will be created for each user-defined feature type, regardless of whether or not any features are written with that feature type.

Note: This option does not apply to feature type fanout.

Specifies the URL value of the targetHref for the NetworkLinkControl Updates.

Specifies whether or not features with model geometry should be reprojected such that the model geometry is a local coordinate system with meter units.

Yes (default): The input feature must have a valid coordinate system, and will be reprojected as necessary.

No: The placement location of the model must be specified via format attributes, and the geometry will be written to a Collada file as-is.

Note: Google Earth requires the geometry to use values with valid COLLADA units.

KML supports a full 3D model. By default, if any feature is 3D, it will be written out to 3D KML. 3D KML an embedded Collada model which causes the file size to increase.

You can turn off the 3D support in the KML writer and force FME to write out to 2.5D by setting this parameter to Yes. The representation will still appear to be 3D but it will be a simple shape.

• Yes: A single textures.txt file will be generated for the whole dataset.
• No (default): Texture mapping will be performed by adding the required <ResourceMap> elements to the Placemark element’s Model geometry.

The OGC KML 2.2 specification has deprecated use of the textures.txt file in favor of ResourceMap elements.

If the value is folder, then a single level of folders will be created, where each folder’s name maps to the value of the fanout attribute. If the value is subfolder, then a two-level folder hierarchy will be created, where the top-level folder’s name will be the same as the original feature type, and each subfolder’s name maps to the value of the fanout attribute.

Specifies whether or not the KML file should be compatible with Google Maps Engine. Enabling this mode will result in KML files that may fail validation.

• Yes: The type attribute value in the generated schema will not be prefixed with a namespace. Missing, null, or empty user attributes will be written as empty nodes.
• No (default): type values in the generated schema will be prefixed, with xsd: as the default prefix. Missing, null, or empty user attributes will not be written.