---
name: "BIS_fnc_KMLimport"
type: function
status: ok
groups: ["Map and Markers"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_KMLimport
revid: 352171
updated: 2024-02-01T23:25:37Z
---

# BIS_fnc_KMLimport

*Function · Map and Markers · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

## Description

Read positions from a [KML file](https://en.wikipedia.org/wiki/Keyhole_Markup_Language).

> [!NOTE]
> Recommended to execute in loading screen.

## Syntax

```sqf
filePath call BIS_fnc_KMLimport
```

**Parameters:**

- `filePath`: [String](../topics/String.md) - (Optional, default `"hsim\Doc_H\GoogleEarth\Missions\" + missionName + ".kml"`) KML file path

  > [!NOTE]
  > **Arma 3:** Default value only works in Take On Helicopters. Do not rely on it in Arma 3.

**Returns:** [Array](../topics/Array.md) of [Array](../topics/Array.md)s in format [type, positionXYZ, folder, name, description]
- type: [Number](../topics/Number.md) - 0 for a point, 1 for a line, 2 for a polygon
- positionXYZ: [Position](../topics/Position.md) - format [PositionAGL](../topics/Position.md#positionagl)
- folder: [String](../topics/String.md) - path to the value, "" if in the .kml root
- name: [String](../topics/String.md) - location's name
- description: [String](../topics/String.md) - location's description

## Examples

### Example 1

```sqf
private _data = "subDir\myFile.kml" call BIS_fnc_KMLimport;
```

## See also

[BIS_fnc_keypointsExportFromKML](../functions/BIS_fnc_keypointsExportFromKML.md) · [BIS_fnc_dbImportXML](../functions/BIS_fnc_dbImportXML.md) · [BIS_fnc_posDegToWorld](../functions/BIS_fnc_posDegToWorld.md)

<sub>Source: [BI Community Wiki — BIS fnc KMLimport](https://community.bistudio.com/wiki/BIS_fnc_KMLimport) (revision 352171).</sub>