About

MazeMap hosts a service that allows customers to push data from their Facility Management System (FMS) for updating the maps directly. This service offers two interfaces for the customer to choose from; either they upload data using SFTP or via REST API.

...

SFTP Server Details

Generating Public SSH key

As mentioned above this push service uses SSH to make sure the connection is safe. 
SSH requires a username and a generated key pair, one key is public and the other private, the following section covers the creation of these keys.

a) Create Username

Create a username, please remember that this will be unique for your user. The username (black arrow below) can be anything you like, but spaces, symbols and special characters should be avoided. Also keep in mind that this username should be unique. In the following example, the username is fmsintegration. 

b) Create SSH Keys

The public part of the SSH key needs to be entered to connect to the MazeMap server (red arrow above). This key has to be created on the local computer.

1) Creating SSH Keys using Windows Command Line:

Step 1: Open the command prompt on your Windows machine.

...

Step 8: Create a support request with MazeMap Support support@mazemap.com including the copied public key in the request.

2) Creating SSH Keys using Linux:

Step 1: Open a terminal on your Linux machine.

...

Step 8: Create a support request with MazeMap Support support@mazemap.com including the the copied public key in the request.

3) Creating SSH Keys using PuTTY (Windows):

Step 1: Download and install PuTTY from the official website (https://www.putty.org/ ).

...

Step 10: Create a support request with MazeMap Support support@mazemap.com including the copied public key in the request.

...

Create a support request with MazeMap Support support@mazemap.com including the copied public key in the request.

Uploading files using SFTP Client

Here's the technical user documentation for connecting to an SFTP server using three four different options: FileZilla, WinSCP, Linux command line , and WinSCPautomated script.

1) Connecting to an SFTP Server using FileZilla:

Step 1: Download and install FileZilla from the official website (https://filezilla-project.org/ ) if you haven't already.

...

Step 12: You should now be connected to the SFTP server and can navigate, upload, and download files as needed.

...

2) Connecting to an SFTP Server using WinSCP (Windows):

Step 1: Download and install WinSCP from the official website (https://winscp.net/ ) if you haven't already.

...

Step 9: You should now be connected to the SFTP server and can navigate, upload, and download files as needed using the WinSCP interface.

3) Connecting to an SFTP Server using Linux Command Line:

Step 1: Open a terminal on your Linux machine.

...

Step 5: To exit the SFTP session, type exit and press Enter.

4) Automating SFTP Connection and File Transfer:

By following these steps, you can automate the process of updating drawings and point of interest (POI) data for MazeMap on a nightly basis, ensuring efficient and regular updates without manual intervention.

...

Uploading/Syncing Files

File and Folder Specifications

Building and Point of Interest files must follow a predefined format:

...

Folder Hierarchy

The files uploaded to the SFTP server must adhere to the following patternsetup:

- Both Building_Manifest.csv and POIList.csv must be present, and have exactly those names and placed in the root of the SFTP.
- Any DWG files must be placed in a folder named drawings and have unique names.

File Formats

The building manifest and points of interest lists are both comma separated values files (the delimiter must be comma; use double quotes to surround a column value if it contains commas). The files should be encoded with Unicode (UTF-8). Examples of both file formats can be found in the appendix.

...