Skip to main content

Uploading data files

You can upload your own geodata to 2GIS 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 or delete existing ones: for more information, see the Adding 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, .csv.gz, .geojson, or .geojson.gz formats must contain only one column with geometry information in one of the following 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. Enter a dataset description if necessary.

  8. Select at least one data attribute with a geometric data type: Latitude, Longitude, or WKT.

  9. The service automatically generates an attribute structure for the dataset. To include the attribute in the resulting dataset, select the checkbox next to the required row and change the attribute parameters if necessary.

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

    Configuring data attributes

  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 - geometry field
  • 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. Create a filter by territory from polygons (optional)​

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. Select the Create a filter by territory checkbox and click Continue.

    Creating a filter from polygons

  2. To assign names to new geofilters, make sure that the uploaded polygons contain a name field in properties. For example:

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

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 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. On the Filters tab, set the remaining filters if necessary.

  6. Click Create layer.

    If there are no created dashboards yet, the first 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?​