Skip to content
On this page

The Points of Interest (POI)

The POI module allows you to manage declared POIs, their types, and vehicles assigned to given depots.

1. POI types

Each customer can define their own list of POI types.

The POI type consists of:

  • names - any POI type name declared by the user
  • is_depot flags - indicates whether the type (and all associated POIs) constitute a fleet depot/base.

1.1. List of POI types

To go to the list of declared POI types, edit it or create a new one press the icon below in the POI list. Poi type btn

How to go to the list of POI types? POI-table-types-btn

POI type lists_ POI-types list

1.2. Adding POI types

POI type creation form: POI-table-types-btn

2. The Points of Interest database (POI)

The place database (POI) represents all locations related to the client's operations, in particular depots where vehicles are stationed.

2.1. POI summary

A summary of all POIs saved in the database allows you to view them on a map and in a table.

POI-table

The tabular list of POIs contains information such as:

  • name - the name of the POI declared by the client
  • address - exact address of the point (street, postal code, city)
  • type- type of POI, among those declared by the client. If the is_depot flag has been assigned to a type, a house symbol will appear next to its name,

Filtering and Search

  • search: text search filter looks for matching text in name and address.
  • type - search by poi types declared by the client
  • database - filtering points only database, only not database

2.2. Adding POIs via the form

❗ Before creating your first POI, create POI types . See chapter: Poi types


The buttons for adding individual points via the form are located in the upper right corner, above the table with POIs

Adding a new point via the form: POI-add-btn

The form for creating a new POI contains the following fields:

  • name - any unique name for the point
  • type- POI type selector. ❗ If the selector is empty or does not have the type you are looking for, create POI types link. ❗

Form for creating a new point: POI-add-form

2.3. Adding POIs from a CSV file

Importing POI points from a file is a mechanism that allows you to quickly save a large amount of data from a file.

A. POI import template

Download the POI's Import Template in CSV format: poi.csv

Follow these steps to import POIs:

  1. Download the CSV import template.
  2. Open the CSV file in a program like Microsoft Excel or Google Sheets.
  3. Enter your details:
  • Add new items in the columns listed in Table 1.
  • Make sure the headers match Table 1; otherwise, the import will fail.
  • Fill in the required fields with data of the type specified in table 1 (string,int); importing won't be possible without them.
  1. After adding your data, save the file in CSV format, following the guidelines in sections B and C.

B. CSV file - general requirements

  • Import only works with CSV files.
  • Use semicolon ( ; ) as the separator and UTF-8 encoding.
  • Headers must match Table 1 and the template; otherwise, import will fail.
  • Each POI should occupy one line.

C. CSV file - detailed requirements

Refer to Table 1 for obligatory header names, data types, required fields, and descriptions.

Table 1. Scope of data to import

HeaderData typeRequired?Description
nameStringTakUnique POI point name
typeNameStringTakThe name of the POI type that appears in the database - selected from the client's declared POI types ❗ Before creating POI point, create POI types .See the poi types section link
position_latFloatTakThe latitude of the point
position_lonFloatTakLongitude of the point
address_countryStringTakPOI address: country
address_postalCodeStringTakPOI address: postal code
address_streetStringTakPOI address: street
address_streetNumberStringTakPOI address: street number
address_flatNumberStringNiePOI address: flat number
address_additionalStringNiePOI address: address additiona information

D. POI import process

To proceed to the import of POIs from a file, click the button located above the table on the right

Go to the POI import pageImport poi brn

To import a file, follow these steps:

  1. Select the .csv file and confirm your selection with the Upload button.

Adding POI - confirmation of file uploadImport of poi - upload

  1. A preview of the POI you intend to upload will be displayed on the screen
  • If the imported data is correct, confirm the import with the Create button

  • If, after importing the file, you would like to correct some data, click the Back button, modify the relevant data in the file (e.g. in Microsoft Excel®), and then import the file again.

    Adding POI - preview of imported POIImport poi - preview

  1. Information about the number of correctly imported POI will be displayed on the screen

_ Adding POI - correctly imported POI_ . Import poi - success

3. Vehicles assigned to POI

Users can view all vehicles assigned to the database and transfer vehicles between selected depots/bases.

How to redirect to manage vehicles pagePOI-manage-vehciles-btn

To change the vehicle assigned to a given depot, select the appropriate depot and the destination depot. Find the vehicle you want to move and press the arrow button.

Managing vehicles in POIPOI-manage-vehciles