---
title: "SPATIAL UPLOAD (This function is subject to a separate order.)"
slug: "spatial-upload-this-function-is-subject-to-a-separate-order-9-1"
updated: 2024-04-02T11:51:26Z
published: 2024-05-03T09:18:39Z
canonical: "support.keypro.fi/spatial-upload-this-function-is-subject-to-a-separate-order-9-1"
excludeFromSearch: true
excludeFromExternalSearch: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.keypro.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# SPATIAL UPLOAD (This function is subject to a separate order.)

Add background maps using the **Spatial upload** ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-rrd3m0cq.png) tool. Organize and add new background maps to the background layer levels and specify the symbology* for imported files (*Esri™ SHP only). Background maps imported into the system are shared or available for a specific group or user. First, in the main toolbar, click **Spatial upload** ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-2cgh7fcb.png).

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-ko98jg0g.png)

The **Spatial upload** tool supports the following file formats for creating background maps:

- Esri™ SHP
- Bentley MicroStation™ DGN (V8)
- Autodesk AutoCAD™ DWG
- CSV files (X;Y; name; color; size), see the chapter [CSV file format](/docs/spatial-upload-this-function-is-subject-to-a-separate-order-9-1#_Aineiston_CSV_-tiedoston).

In addition, you can create network objects directly from files in the Esri™ SHP format (network). More information on this is provided in the [Uploading network objects chapter (Settings must be configured through the admin user interface.)](/docs/spatial-upload-this-function-is-subject-to-a-separate-order-9-1#_Aineiston_lataus_suoraan).

## Managing layers

To upload background maps, select an existing layer or create a new background layer on the **Layers** tab. To create a background map layer, enter its name in the **Layer name** field and click **Add layer** ![add](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-gn8u1up9.png). The layer appears in the **Reference maps** section on the **Layers** form. You can organize the background map layers and their hierarchy.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-ec2iksvi.png)

The user-created layer is now visible under the Reference maps layer.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-62xm52mo.png)

You can create user-specific or group-specific background maps. Any layers you create will be shared by default and will be marked with the unlocked lock icon ![lock_open](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-4e7kzzdf.png). You can define a layer as private by selecting the checkbox. The icon will be replaced with a locked lock ![lock](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-rqo6fjo7.png) and the layer you created will not be visible to others. When you have defined the level you created as private, the **Groups** checkbox will be activated. If you want a specific group to see the background map you created, select the name of the group in the drop-down menu for **Group**. Admin users can create groups and add users to the groups.

## Spatial upload form

1. Select the **Upload** tab.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719256822.png)
2. Click **Browse** and select the file you want to upload.
3. If you are uploading an ESRI **shp** file, also select the **dbf** file.
4. Check the file type before uploading. This field is usually filled in automatically so that it matches the file you selected.
5. Select the projection applicable to the file that is uploaded.
6. Select the background map layer to which your file is added.
7. Select **Remove existing files** if you want the layer to include only the data included in the files you are uploading (as if you would first delete all files from the layer in question, see the chapter [Deleting reference maps](/docs/spatial-upload-this-function-is-subject-to-a-separate-order-9-1#_Aineiston_poisto)).
8. Define the style settings applicable to the object types **(Esri™ SHP only).**

**TIP:** If your file includes objects with various style settings, you might have to separate them into different files based on their symbology.

1. Click ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-oe6lrpfv.png) **Upload**. The progress bar indicates the status of the file upload. Note that it could take several minutes to upload a large file.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719300855.png)
2. Browse the the Log tab for a file upload.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719313025.png)
3. When the file upload is complete, the following notification is displayed: **Data is ready, zoom to extent?** Click **Zoom** and check the result on the map.

When the file has been uploaded, it appears in the **Layers section** on the Layers tab of the Spatial upload form: ![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-dmk6ny1q.png)

**Note!** When you create new network objects, you can use the snapping function on the background map.

## Deleting background maps

1. Select the **Layers** tab.
2. Expand the **Layers** section if it is hidden.
3. In the drop-down menu for **Name**, select the layer where the background map you want to delete is located.
4. Select the file you want to delete and click **Delete selected files ![cross](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-7ypc3oxe.png)**.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719326908.png)
5. Confirm and check the result on the map.

## Deleting a background map layer

1. Select the **Layers** tab.
2. In the drop-down menu for **Name**, select the layer you want to delete.
3. Click Delete
4. If there are files attached to the level, the following notification will be displayed: **Layer**  If you are sure that you know what you are doing and you still want to delete the layer, click **Delete** to confirm the action.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-ed2128oc.png)

## Material in CSV format

Rules for importing CSV files:

1. Fields are separated by semicolons (*;*).
2. No column headers are used.
3. Rows are in the following format: X;Y;[TEXT];[COLOUR];[SIZE]
4. The TEXT, COLOUR, AND SIZE columns can be empty.
5. If TEXT is empty, a point object is created. Otherwise, free text is created.
6. If COLOUR or SIZE is empty, default values are applied.
7. COLOUR is an RGB value, such as “255 255 0”.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-lc9mu4rd.png)

**TIP:** If you want to create both point objects and free text, create two versions of the file – one containing the texts and another where text boxes are empty – and upload both files to the same layer.

## Uploading network objects (Settings must be configured through the admin user interface.)

1. Select shp and dbf files, or a zip file containing such files, as the files.
2. Select **Network** as the file type.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719529986.png)
3. Click ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-eaugusai.png) **Upload**.
4. On the **Import settings** form, select **Method**.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719540530.png)
5. Check that the mappings are correct.
6. Click ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-fky5lili.png) **Upload**. The progress bar indicates the status of the file upload. Note that it could take several minutes to upload a large file.
7. When the file upload is complete, the following notification is displayed: **Data is ready, zoom to extent?** Click **Zoom** and check the result.

### Uploading network objects by using Area import (Settings must be configured through the admin user interface)

1. Select **shp** and **dbf** files, or a zip file containing such files, as the files.
2. Select **Network** as the file type.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695299137011.png)
3. Click ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-eaugusai.png) **Upload**.
4. On the **Import settings** form, select **Area import** as the **Method**.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695299146499.png)
5. Check that the mappings are correct.
6. Click ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-fky5lili.png) **Upload**. The progress bar indicates the status of the file upload. Note that it could take several minutes to upload a large file.
7. When the file upload is complete, the following notification is displayed: **Data is ready, zoom to extent?** Click **Zoom** and check the result.

## Spatial upload for consumer points

This chapter describes how to use **Spatial upload** ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-s4uiee0x.png) tool for importing consumer points. The **Spatial upload** ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-vk848l3u.png) tool can be found from the main toolbar.

![Graphical user interface, text, application, chat or text message Description automatically generated](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-tt05hzmq.png)

### Importing the consumer points

1. Open the **Spatial upload**![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-v44vdhhl.png) form in the main tool.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719550239.png)
2. In the **Upload** tab, fill in the following fields as described:

- **Files**: Zip-package with shape files. You can only select .dbf and .shp files.
- **File type:** Network.
- **Projection:** Select accordingly.

1. Styles can be edited in **Style settings.**
2. Click **Upload** which opens the **Import settings** window.![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/image-1695719570982.png)
3. In the **Import settings** window, fill in the following fields as described:

- **Method:** Simple network.
- **Plan name:** Generated automatically*.
- **Points:** Select **Consumer point** from the drop-down menu.

**Lines and Areas:** Can be left as they are (they are not used in this type of import).

1. Click **Upload** ![layers_import](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/other-tools-image-pqneehke.png)**.**
2. If the importing was done successfully, a popup dialog with a **Zoom** button appears.
3. Consumer points are now imported.