ImportKML()

Summary

Imports features from one or more KML files into a geographic file.

 

Changes

Added to Version 2017.

 

Syntax

ImportKML(string kml_filename, array kml_folders, string out_db_folder, array options)

 

Argument	Contents
kml_filename	The file name of the file to import
kml_folders	An array of folders that you want to import from the kml file, in the format {"folder1/folder2/folder3", "folder1/folder2/folder4", ...}; if null, the whole file is imported.
out_db_folder	The path for the new geographic files

 

Option	Type	Contents
Import Points	Boolean	If "True" import points in the KML file; the default is "False"
Import Lines	Boolean	If "True" import lines in the KML file; the default is "False"
Import Areas	Boolean	If "True" import areas in the KML file; the default is "False"
Datum	Integer	The datum code
Label	String	A descriptive label for the geographic file
Layer Name	String	The name of the layer in the geographic file
Median Split	Boolean	If "True" special handling insures that entities which cross the 180 degree longitude line are imported properly; if "False" (the default), no special handling is invoked
NAD Conversion	Array	Input_datum, output_datum, hp_datum_file where input_datum and output are different datums, chosen from "NAD27", "NAD83" or "NAD83HP". hp_datum_file is the name of the high precision conversion file (if NAD83HP is specified).
Node Layer Name	String	The desired name for the endpoint layer (only when importing a line layer)
Optimize	Boolean	Whether to optimize the geographic file automatically after the import; defaults to "True"
Projection	String and Array	A string with the projection name, and an array of projection options; the option {"units","us-ft"} needs to be specified for normal 1927 State Plane Coordinates
Transform	Array	Array indicating the transformation to apply to coordinates in the file. This can have three forms:1. An array of two or more four-element arrays containing local and world coordinates for control points, for example, {{real localX1, real localY1, real longitude1, real latitude1}, ...}2. An array of four elements - {real X_multiplier, real Y_multiplier, real X_offset, real Y_offset}3. Center and Extent transform {c1_x, c1_y, width_1, c2_x, c2_y, width_2}where center is shifted from (c1_x,c1_y) to (c2_x,c2_y), and vector of length width_1 out of c_1 becomes a vector of length width_2 out of c_2.

 

Returns

An array of imported geographic file names.

 

Notes

• The attribute table is hard linked to the geography if it exists and Layer Name has been specified.

Example

???

 

Error Codes

Error Type	Meaning
NotFound	There is no file by this name; or there are no entities in the files of the desired type
Error	The file is not a valid KML file

 

See Also

Function	Summary
GetKMLInfo()???