Supported file formats

Learn about file formats supported on different platforms.


Overview

Different file formats are supported depending on the platform option.

Platform optionFile format
ConsoleGeoJSON
KML
WKT
APIGeoJSON
SDKGeoJSON
KML
Shapefile
WKT

GeoJSON

GeoJSON files store coordinates in JSON format. Both extensions, .geojson and .json, are accepted. Allowed types of coordinates are Point and Polygon.

AOI examples

An example of a single AOI GeoJSON

JSON

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [-77.05788457660967, 38.87253259892824],
            [-77.05465973756702, 38.87291016281703],
            [-77.0531553685479, 38.87053267794386],
            [-77.05552622493516, 38.868757801256],
            [-77.05844056290393, 38.86996206506943],
            [-77.05788457660967, 38.87253259892824]
          ]
        ]
      }
    }
  ]
}
  
An example of a multipart AOI GeoJSON

JSON

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [-0.23813040507974392, 51.468798304729745],
            [-0.04103438196207776, 51.468798304729745],
            [-0.04103438196207776, 51.54859446205262],
            [-0.23813040507974392, 51.54859446205262],
            [-0.23813040507974392, 51.468798304729745]
          ]
        ]
      },
      "id": 0
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [-2.007448902677595, 52.535413959131574],
            [-2.007448902677595, 52.4032156024264],
            [-1.7842843091614498, 52.4032156024264],
            [-1.7842843091614498, 52.535413959131574],
            [-2.007448902677595, 52.535413959131574]
          ]
        ]
      },
      "id": 1
    }
  ]
}
  

POI examples

An example of a single POI GeoJSON

JSON

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-73.98716020201383, 40.73106717134863]
      }
    }
  ]
}
  
An example of a multipart POI GeoJSON

JSON

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-73.98716020201383, 40.73106717134863]
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-71.05828675347368, 42.360262258503866]
      }
    }
  ]
}
  

KML

Keyhole Markup Language (KML) is an XML-based format initially developed for Google Earth.

AOI examples

An example of a single AOI KML

Xml

    <kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -77.05788457660967,38.87253259892824
            -77.05465973756702,38.87291016281703
            -77.0531553685479,38.87053267794386
            -77.05552622493516,38.868757801256
            -77.05844056290393,38.86996206506943
            -77.05788457660967,38.87253259892824
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </Placemark>
</kml>
  
An example of a multipart AOI KML

Xml

    <kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -0.23813040507974392,51.468798304729745
            -0.04103438196207776,51.468798304729745
            -0.04103438196207776,51.54859446205262
            -0.23813040507974392,51.54859446205262
            -0.23813040507974392,51.468798304729745
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </Placemark>
  <Placemark>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -2.007448902677595,52.535413959131574
            -2.007448902677595,52.4032156024264
            -1.7842843091614498,52.4032156024264
            -1.7842843091614498,52.535413959131574
            -2.007448902677595,52.535413959131574
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </Placemark>
</kml>
  

POI examples

An example of a single POI KML

Xml

    <kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <Point>
      <coordinates>-73.98716020201383,40.73106717134863</coordinates>
    </Point>
  </Placemark>
</kml>
  
An example of a multipart POI KML

Xml

    <kml xmlns="http://www.opengis.net/kml/2.2">
  <Placemark>
    <Point>
      <coordinates>-73.98716020201383,40.73106717134863</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <Point>
      <coordinates>-71.05828675347368,42.360262258503866</coordinates>
    </Point>
  </Placemark>
</kml>
  

Shapefile

The Shapefile file format should consist of at least 3 required files:

  • .shp — feature geometry
  • .shx — an index position
  • .dbf — attribute information

Other optional files can be included in a Shapefile as well, such as .cpg, .prj, .xml, .sbn, or .sbx.

WKT

Well-known text (WKT) is used to represent vector geometry objects. Allowed types of coordinates are Point and Polygon.

AOI examples

An example of a single AOI WKT

Wkt

    POLYGON ((-77.05788457660967 38.87253259892824, -77.05465973756702 38.87291016281703, -77.0531553685479 38.87053267794386, -77.05552622493516 38.868757801256, -77.05844056290393 38.86996206506943, -77.05788457660967 38.87253259892824))
  
An example of a multipart AOI WKT

Wkt

    POLYGON ((-0.23813040507974392 51.468798304729745, -0.04103438196207776 51.468798304729745, -0.04103438196207776 51.54859446205262, -0.23813040507974392 51.54859446205262, -0.23813040507974392 51.468798304729745))
POLYGON ((-2.007448902677595 52.535413959131574, -2.007448902677595 52.4032156024264, -1.7842843091614498 52.4032156024264, -1.7842843091614498 52.535413959131574, -2.007448902677595 52.535413959131574))
  

POI examples

An example of a single POI WKT

Wkt

    POINT (-73.98716020201383 40.73106717134863)
  
An example of a multipart POI WKT

Wkt

    POINT (-73.98716020201383 40.73106717134863)
POINT (-71.05828675347368 42.360262258503866)
  

Troubleshooting

I can’t upload a GeoJSON file

Check that your GeoJSON file is structured as a feature collection object.

AOI example

An example of an AOI feature collection structure

JSON

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [...]
      }
    }
  ]
}
  

POI example

An example of a POI feature collection structure

JSON

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [...]
      }
    }
  ]
}
  

Can I upload a KML file with Z-value coordinates?

You can upload a KML file with Z-value coordinates. However, we will ignore the Z-value coordinates, as we only support two-dimensional input geometries.