KML To Layer (Conversion)

This ArcGIS 2.8 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Summary

Converts a KML or KMZ file into feature classes and a layer file. The layer file maintains the symbology found within the original KML or KMZ file.

Learn more about KML support in ArcGIS

Usage

  • This tool creates a file geodatabase containing a feature class within a feature dataset. The feature class name will be named point, line, polygon, or multipatches, dependent on the original features of the KML file. At the same folder level as the file geodatabase will be a layer file which can be added to a map to draw the features. This layer file draws features based on their schema of point, line, or polygon, while maintaining the original KML symbology.

    Each feature class created will have attributes which maintain information about the original KML file. The original folder structure, name, and pop-up information, as well as fields that help define how the features sit on a surface, all make up the attributes of each feature.

  • Rasters, or ground overlays, will be converted into a mosaic dataset inside the file geodatabase. The source raster in its native format is available in a folder of GroundOverlays at the same level as the output file geodatabase. Ground overlays are not converted by default. Use the Include Ground Overlay option to create rasters.

    Note:

    Converting overlays using the KML To Layer tool may take a long time, depending on source data. All available rasters and overlays inside the KML will be converted. All of the imagery will be converted if a KML references a service that provides imagery. Highly detailed imagery may take a long time to convert due its file size.

  • Output will be generated in the WGS84 coordinate system. The output features can be reprojected to another coordinate system, if desired, using the Project tool.

  • Input up to KMZ version 2.2 of the OGC KML standard is mostly supported. Point locations that use the address tag (by way of geocoding) are not supported. A valid latitude and longitude location is required inside the source KML.

  • The ArcGIS Pro 1.3 release introduces native support for KML and KMZ as data sources. To perform geoprocessing operations on a KML layer, they need to be converted to features inside a file geodatabase. Using the KML to Layer tool, select the KML layer from your Contents menu and drag it into the Input KML File parameter on the tool. After it has been converted, perform the geoprocessing operations on the new output.

Parameters

LabelExplanationData Type
Input KML File

The KML or KMZ file to translate.

File; KML Layer
Output Location

The destination folder for the file geodatabase and layer (.lyrx) file.

Folder
Output Data Name
(Optional)

The name of the output file geodatabase and layer file. The default is the name of the input KML file.

String
Include Ground Overlay
(Optional)

Include ground overlays from the KML (raster, air photos, and so on). Use caution if the KMZ points to a service that serves raster imagery. The tool will attempt to translate the raster imagery at all available scales. This process could be lengthy and possibly overwhelm the service.

  • Checked—Ground overlay is included in the output.
  • Unchecked—Ground overlay is not included in the output. This is the default.
Boolean

Derived Output

LabelExplanationData Type
Output Layer File

The output layer file.

Group Layer
Output File Geodatabase

The output geodatabase containing a feature class within a feature dataset.

Workspace

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics