{"name":"BIS_fnc_KMLimport","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","games":{"tkoh":"1.00","arma3":"0.50"},"since":"tkoh 1.00","arma3_since":"0.50","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","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.","type_expr":"String","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","type_expr":"Array<Array>","description":"in format [type, positionXYZ, folder, name, description]\n- 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\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":[{"code":["private _data = \"subDir\\myFile.kml\" call BIS_fnc_KMLimport;"]}],"see_also":["BIS_fnc_keypointsExportFromKML","BIS_fnc_dbImportXML","BIS_fnc_posDegToWorld"]}