Skip to main content

Uploading data files

You can upload your own geodata to Urbi Pro service.

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.

Availability in demo tariff plan

If you use the demo tariff plan, you cannot upload data files.

To upload a file with a dataset and work with it:

  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 with a data sample.

After uploading the data, you can update the data in the dataset. If you uploaded a dataset with point objects, you can manually add new objects to the dataset and edit or delete existing ones: for more information, see the Adding and editing point objects section.

1. Prepare a data file​

General requirements​

  • Formats:
    • .csv, .csv.gz
    • .geojson, .geojson.gz
    • .shp (you also need to upload the .shx and .dbf files)
    • .shp.zip (an archive must contain the .shp, .shx, .dbf, and .prj files)
    • .kml
    • .kmz
    • .xlsx (you can only upload the first sheet of the file)
    • .gpkg
  • 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 and .csv.gz formats must contain at least one column with geometry. Data in .geojson and .geojson.gz formats must contain at least one field with geometry. Supported geometry formats:

    • WKT (Well-Known Text)
    • Latitude and longitude as floating-point numbers (only for point objects)

Dates and time​

Supported formats:

  • Date only (UTC±00:00 is applied by default):

    • 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 (UTC±00:00 is applied by default):

    • YYYY-MM-DD HH:MM (2023-10-05 14:30)
    • YYYY-MM-DD HH:MM:SS (2023-10-05 14:30:00)
    • DD/MM/YYYY HH:MM (05/10/2023 14:30)
    • DD/MM/YYYY HH:MM:SS (05/10/2023 14:30:00)
    • DD.MM.YYYY HH:MM (05.10.2023 14:30)
    • DD.MM.YYYY HH:MM:SS (05.10.2023 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)
    • YYYY-MM-DD HH:MM:SSZ (2023-10-05 11:30:00Z)
    • YYYY-MM-DDTHH:MM:SS.sss±HH:MM (2023-10-05T14:30:00.000+03:00)
    • Ddd, DD Mon YYYY HH:MM:SS TIMEZONE (Thu, 05 Oct 2023 13:30:00 GMT)

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 maximum number of unique values in a filter is 30.
  • When configuring field aliases, you can use digits, letters, space, characters ., _, $, and round brackets (). Do not use commas.

You can prepare data in any GIS software, with programming languages, or in Excel (point objects only).

File example​

example.csv
"Plot number","Type","Construction 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​

  1. Go to the Main or Data tab.

  2. Click Upload data.

    Upload data button

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

  4. Click Upload.

  5. Enter a dataset name. The maximum number of characters is 50. The name can contain letters, numbers, spaces, and special characters.

  6. Select a group to add a dataset.

  7. (Optional) Enter a dataset description.

  8. The service automatically generates an attribute structure for the dataset. To include the attribute in the resulting dataset, select its checkbox and change the attribute parameters if necessary.

    Configuring data attributes

  9. In the attribute list, select the checkbox for at least one attribute that contains geometry information. In the Type field, select the attribute type:

    If you cancel the attribute configuration or close the dialog, the uploaded dataset remains on the Data tab. In the dataset card, a note indicating that attributes need to be configured will be displayed. You will be able to work with the dataset only after the configuration is complete.

  10. Click Create a dataset.

The data appears in the selected dataset group as a card (by default, it is the Uploaded Data group).

Data attributes parameters​

Parameter
Description
TitleField name.
TypeAttribute type:
  • Latitude
  • Longitude
  • WKT
  • H3 ID
  • Name
  • Attribute
  • Date
Filter typeFilter type for the attribute:
  • Select box - selecting one value from the list
  • Multiple choice from the list - selecting multiple values from the list
  • Numerical range
  • Text filter
  • Date range with time

3. (Optional) Create a filter by territory from polygons​

If uploaded data contains geometries of the polygon type, you can use them to create your own territorial division. This allows you to create new territory filters (geofilters) and filter data not only by standard territory types (regions, districts, settlements, and others) but also by your unique areas.

For example, you can upload polygons with the boundaries of the areas of your interest and analyze information on firms and urban environment within these polygons.

To create a filter by territory:

  1. Make sure that the data you upload contains:

    • geometries of the polygon type
    • an attribute with the Name type (the attribute can have any name)

  2. When uploading data, select the Create a filter by territory checkbox and click Continue.

    Creating a filter from polygons

After that, when you filter data by territories, you can select the territories from the uploaded dataset in the Geofilter settings dialog:

Geofilters with polygons

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. In the Geofilter settings dialog, select up to 50 territories for which the data sample is created. You can use standard and custom territories and also build polygons, proximity zones, and circles on the map. For more information, see the Geofilters section. After you select the territories, click Done.

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

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

  5. On the Filters tab, set the remaining filters if necessary.

  6. Click Create layer.

    If there are no created dashboards yet, the dashboard with one scene is created, and the layer with data is automatically added to the scene.

  7. If there is at least one dashboard created, specify where to add the layer in the dialog:

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

What's next?​