Uploading data files | Urbi Pro | 2GIS Documentation
Urbi Pro
Maps
Search
Navigation
On-Premise
Urbi Pro
CityLens
Account

Uploading data files

Upload and work with your own geodata in Urbi Pro service. You can work with the uploaded data like with any built-in data category.

The ability to upload data depends on the tariff.

You can upload data for any territory, but a detailed map is only available for countries with built-in data: see the list of countries.

To work with your own data:

  1. Prepare a data file.
  2. Upload the data to the service.
  3. Create a filter by territory from polygons (optional).
  4. Create a layer.

1. Prepare a data file

General requirements

  • Format: .csv, .csv.gz, .geojson, .geojson.gz, .kml, .kmz, .shp (you need also upload the .shx and .dbf files), or .shp.zip (an archive must contain the .shp, .shx, .dbf, and .prj files).
  • Size: up to 100 MB.
  • Encoding: UTF-8.
  • Coordinate System: WGS84(4326).

Geometry

  • Available geometry types:

    FeatureCollection and GeometryCollection are not supported.

    The file must contain only one geometry type.

  • Data in .csv, .csv.gz, .geojson, or .geojson.gz formats must include a column with geometry information in one of the following formats:

    • WKT (Well-known text).
    • Latitude/longitude as floating-point numbers (only for point objects).

    Use only one column for specifying geometry.

Dates and time

Supported formats:

  • Date only:

    • YYYY-MM-DD (2023-10-05)
    • DD/MM/YYYY (05/10/2023)
    • DD.MM.YYYY (05.10.2023)
    • DD Mon YYYY (05 Oct 2023)

  • Date and time:

    • YYYY-MM-DD HH:MM (2023-10-05 14:30)
    • YYYY-MM-DD HH:MM:SS (2023-10-05 14:30:00)

  • Date and time with a timezone:

    • YYYY-MM-DDTHH:MM:SS±HH:MM (2023-10-05T14:30:00+03:00)
    • YYYY-MM-DDTHH:MM:SSZ (2023-10-05T11:30:00Z)
    • Ddd, DD Mon YYYY HH:MM:SS TIMEZONE (Thu, 05 Oct 2023 13:30:00 GMT)

Note

If no timezone is specified in the uploaded data, UTC+0 is applied by default.

Data

  • Any additional columns with information about objects are allowed.
  • Additional columns can be used as filters. The maximum number of filters is 40.
  • The number of unique values in a filter is not more than 30.
  • When setting field aliases, you can use digits, letters, characters " ", ".", "_", "$", round brackets. Do not use a comma when setting field aliases.

Data preparation can be done in any GIS software, with programming languages, or in Excel (point objects only).

File example:

example.csv 
"Plot number","Type","Counstruction status","Planned category type","Sector TPSS number","ADM competitors (5 min)","ADM Density competitors","Urbi competitors (5 min)","Urbi Density competitors","Population count","Population density","geometry","Area (m2)"
"37","Residential","constructed","residential","SW14","0","0.0","0","0.0","24","0.0114907756079154","MULTIPOLYGON (((54.5533360489372 24.4070865895649, 54.5537666032566 24.407208446631405, 54.553899603709 24.406814267612795, 54.55346912918721 24.406692421312805, 54.5533360489372 24.4070865895649)))","2090.1"
"60","Residential","constructed","residential","SE42","0","0.0","0","0.0","59","0.0143151993294631","MULTIPOLYGON (((54.5950160683146 24.4368505784661, 54.5956536269804 24.437030010752995, 54.595830181732204 24.436504162972696, 54.5951926253267 24.436324731604895, 54.5950160683146 24.4368505784661)))","4124.2"

2. Upload the data

Upload data button

  1. Go to the Main or Data tab.

  2. Click Upload data.

  3. Drag a file to the download area or Select a file on a computer.

  4. Click Upload.

  5. After the upload is finished, click Next.

  6. Enter a dataset name. Requirements:

    • The length can be up to 50 characters.
    • Can contain letters, numbers, spaces, and special characters.

  7. Specify data attributes if necessary.

    At least one field with coordinates must be selected.

  8. Click Create a dataset.

    The data appears in the Uploaded Data dataset group as a card.

Data attributes

Configure the data attributes

After uploading the file, the service automatically generates an attribute structure for the dataset. To change the structure:

  • Select the checkbox next to the desired row so that the attribute is included in the final data set.

  • Specify the field name in the Title column.

  • Select the attribute type in the Type column:

    • Latitude
    • Longitude
    • WKT: geometry field
    • Name
    • Attribute
    • Date

  • Select the Filter type for the attribute:

    • Select box
    • Multiple choice from the list
    • Numerical range
    • Text filter
    • Date range with time

Note

If you cancel the attribute setup or close its window, the data set remains in the library – its card is displayed with a note about the need to set up attributes. You are only able to work with the data set after performing attribute settings.

3. Create a filter by territory from polygons (optional)

If your uploaded data contains geometries of the polygon type, you can use them to create new territory filters. This allows you to filter any Urbi Pro data not only by standard territory types (countries, cities, regions, and others) but also by your unique areas.

Example scenario

Upload polygons that limit the areas where you would like to purchase a property and then analyze information on firms and urban environment within these polygons.

To create a filter by territory, select the Create a filter by territory checkbox and click Continue.

Creating a filter from polygons

To assign meaningful names to new areas, make sure that uploaded polygons contain a name field in properties. Example:

{
    "type": "Feature",
    "properties": {
        "Name": "Area 1"
    },
    "geometry": {
        "coordinates": [...],
        "type": "Polygon"
    },
    "id": 0
},

Now when you create layers, you can select the uploaded dataset from a list in the Territories field.

4. Create a layer

To save the filtered sample and customize its visualization (e.g., as a heatmap), create a layer.

  1. Go to the Main or Data tab.

  2. Select the uploaded dataset.

  3. On the Filters tab, select a Territory.

  4. If you selected the uploaded data that contains geometries of the line or polygon type, you can select the data display method on top of the Filters tab:

    • Points: display as centroid points (the centers of the object geometries).
    • Geometries: display as real data geometries (lines or polygons).

  5. Set the remaining filter parameters if necessary.

  6. Click Create layer.

    If there are no dashboards in the project yet, the first dashboard is created, and the layer with data is automatically added to it.

  7. If there is a dashboard in the project, specify where to add the layer in the dialog box:

    • Select the created dashboard in the list and click Create.
    • Click Add to the new dashboard, enter a name of the new dashboard, and click Create. A new dashboard is created, and the layer with data is automatically added to it.

What's next?