Skip to content

Aerial Images & Pipelines (old import method)

Aerial images and pipelines still use the old importer, so you'll need to follow a different import procedure.

Aerial Images

The aerial images script can be used to import aerial images.

CSV Format

The following headers must be present in the CSV file, and they cannot be blank:

HeaderTypeBlankHelp
Aerial imageStringNOEach file referenced in this column must exist in the --data_path folder
OwnerStringNOCompany with the given name must exist in the platform
Taken atDateNOISO format

Note: Any additional fields will be stored as extra data object.

Script Arguments

This script does not accept any parameters beyond the commonly required ones (environment, api_key, data_path).

Example

Example of calling the aerial_images import script on prod:

bash
python -m importers.infrastructure.aerial_images --environment prod --api_key {API_KEY_VALUE} --data_path {PATH_TO_FOLDER}

Pipelines

The pipelines import script can be used to import pipeline infrastructure data.

Data Format

Unlike the other scripts, the pipelines script requires a GeoJSON file present in the data import folder. No other files are required.

As the script is invoked, the GeoJSON file will be converted to a CSV file for compatibility with other data import scripts.

Important: No other CSV files can be in the data import folder.

GeoJSON Fields

The following fields must be present in the GeoJSON file, and they cannot be blank:

HeaderTypeBlankHelpExtra
Line IdString or NumberNOUsed to group in maps and is important to capture for each operator
Segment IdString or NumberNO
GeometryLineString or MultiLineStringNO
MaterialStringYES
DiameterStringYES
StatusStringNO
MilesNumberYES

Notes:

  • Any additional fields will be stored as extra data object.
  • If present, pipe_mat_1 will be used as pipeline segment material and nominal_di will be used as segment diameter. If not present, the values will be set to "Other".

Script Arguments

This script requires an operator name under the --owner argument, plus the commonly required ones (environment, api_key, data_path).

Example

Example of calling the pipelines import script on prod:

bash
python -m importers.infrastructure.pipelines --environment prod --api_key {API_KEY_VALUE} --data_path {PATH_TO_FOLDER} --owner {OWNER_NAME}