{"name":"BIS_fnc_KMLimport","operator":null,"title":"BIS fnc KMLimport","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_KMLimport","revid":352171,"updated":"2024-02-01T23:25:37Z","groups":["Map and Markers"],"status":"ok","replaced_by":[],"games":[{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Read positions from a [KML file](https://en.wikipedia.org/wiki/Keyhole_Markup_Language).\n\n> [!NOTE]\n> Recommended to execute in loading screen.","syntaxes":[{"syntax":"filePath call BIS_fnc_KMLimport","since":null,"effect":null,"exec":null,"params":[{"name":"filePath","type":"String","optional":true,"default":"`\"hsim\\Doc_H\\GoogleEarth\\Missions\\\" + missionName + \".kml\"`","description":"KML file path\n\n> [!NOTE]\n> **Arma 3:** Default value only works in Take On Helicopters. Do not rely on it in Arma 3.","types":["String"],"since":null,"text":"filePath: String - (Optional, default `\"hsim\\Doc_H\\GoogleEarth\\Missions\\\" + missionName + \".kml\"`) KML file path\n\n> [!NOTE]\n> **Arma 3:** Default value only works in Take On Helicopters. Do not rely on it in Arma 3."}],"returns":{"type":"Array of Arrays in format [type, positionXYZ, folder, name, description]","types":["Array"],"description":"type: Number - 0 for a point, 1 for a line, 2 for a polygon - positionXYZ: Position - format PositionAGL - folder: String - path to the value, \"\" if in the .kml root - name: String - location's name - description: String - location's description","text":"Array of Arrays in format [type, positionXYZ, folder, name, description]\n- type: Number - 0 for a point, 1 for a line, 2 for a polygon\n- positionXYZ: Position - format PositionAGL\n- folder: String - path to the value, \"\" if in the .kml root\n- name: String - location's name\n- description: String - location's description"}}],"examples":[{"text":"```sqf\nprivate _data = \"subDir\\myFile.kml\" call BIS_fnc_KMLimport;\n```","code":["private _data = \"subDir\\myFile.kml\" call BIS_fnc_KMLimport;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_keypointsExportFromKML","BIS_fnc_dbImportXML","BIS_fnc_posDegToWorld"],"notes":[],"categories":["Arma 3: Functions","Function Group: Map and Markers","Functions","Introduced with Take On Helicopters version 1.00","Take On Helicopters: Functions","Take On Helicopters: New Functions"],"docblock":null,"filled_from_docblock":[]}