Polygon Layer

Polygon Layer can display GeoJSON features. GeoJSON supports the following geometry types: Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon.

Studio supports all the GeoJSON types above. You can pass in either a single Feature or a FeatureCollection

An example of the Polygon Layer.

An example of the Polygon Layer.

A path GeoJSON layer can display data like trip routes or contours. Stroke color can be set with a numerical field.

Polygon Layer, filled and colored

Polygon Layer, filled and colored

A polygon GeoJSON layer is essentially a choropleth layer and works best for rendering geofences. Fill color or height can be set with a numerical field. For example, it can display population by census tracts.

Polygon Layer showing 3D buildings.

Polygon Layer showing 3D buildings.

To add a Polygon Layer, your dataset must contain geometry data.

GeoJSON Input

When upload a GeoJSON file contains FeatureCollection, a Polygon Layer will be auto-created.

Example GeoJSON

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [102.0, 0.5]
      },
      "properties": {
        "prop0": "value0"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [102.0, 0.0],
          [103.0, 1.0],
          [104.0, 0.0],
          [105.0, 1.0]
        ]
      },
      "properties": {
        "prop0": "value0"
      }
    }
  ]
}

Geometries (Polygons, Points, LindStrings etc) can be embedded into CSV as a GeoJSON or WKT formatted string.

  1. GeoJSON string
id,_geojson
1,"{""type"":""Polygon"",""coordinates"":[[[-74.158491,40.835947],[-74.157914,40.83902]]]}"
  1. WKT string

Example data.csv with WKT string The Well-Known Text (WKT) representation of geometry values is designed for exchanging geometry data in ASCII form.

id,_geojson
1,"POLYGON((0 0,10 0,10 10,0 10,0 0),(5 5,7 5,7 7,5 7, 5 5))"

CSV Input

Paths can be created by joining a list of points from latitude and longitude, sort by an index field (e.g. timestamp) and group by uniq ids.

Layer columns:

  • id: - required - A id column is used to group by points. Points with the same id will be joined into a single path.
  • lat: - required - The latitude of the point
  • lon: - required - The longitude of the point
  • alt: - optional - The altitude of the point
  • sort by: - optional - A sort by column is used to sort the points, if not specified, points will be sorted by row index.

Example CSV

idlatitudelongitudesort by
A40.81773-74.209860
A40.81765-74.209871
A40.81746-74.209982
B40.64375-74.332420
B40.64353-74.209871
B40.64222-74.330012

Filter Polygons

With polygons added to your map, you can select them to create geospatial boundaries that serve as a filter.


Selecting a neighborhood polygon to filter suitability analysis results.

Learn more in the geospatial filter documentation.

Settings

The follow sections detail every setting available in the Polygon Layer.

Basic

Core settings for the Polygon Layer.

SettingDescription
Layer TypeMust be Polygon to use the Polygon Layer.
DatasetThe dataset to use for the Polygon Layer.
ColumnsThe column(s) containing polygon data.
GeoJSONA GeoJSON FeatureCollection to use for polygon generation. See above.
Table columnsTabular input used for polygon generation. See above.

Fill Color

Settings related to the fill color of the polygons.

SettingDescription
Fill Color ToggleToggle on/off to show/hide fill color.
Color Based OnThe field to base the fill color on.
Color ScaleThe color scale and palette for the fill color.
OpacityThe opacity of the fill color. 100 = fully opaque, 0 = fully transparent.

Stroke Color

Settings related to the stroke color of the polygons.

SettingDescription
Stroke ToggleToggle on/off to show/hide stroke.
Stroke Color Based OnThe field to base the stroke color on.
Stroke Color ScaleThe color scale and palette for the stroke color.

Stroke Width

Settings related to the stroke widths of the polygons.

SettingDescription
Stroke WidthThe stroke width in pixels. When based on a column, define a range instead of a static width.
Stroke Width Based OnA field to base stroke width on.

Height

Height settings for the polygon layer. Height is best viewed with the 3D viewing mode.

SettingDescription
Height SliderIncrease to raise the height of the layer's polygon.
Height Based OnAn column to base the height off of.
Height ScaleChoose from linear, sqrt, and log.
Fixed HeightApplies height without additional modifications.
Shows WireframeShow the wireframes that define the polygon.
Polygon Layer visualizing building footprints with fixed heights.

Polygon Layer visualizing building footprints with fixed heights.

Label

Label settings for the Polygon Layer. Labels are attached to each polygon.

SettingDescription
Label FieldSelect a field to display on the label.
Font SizeThe size of the font to use on the label.
Font ColorThe color of the label font.
Outline WidthThe width of the outline in pixels. Set to 0 to disable the outline.
Outline ColorThe color for the outline label.
Background ColorToggle to enable a background color for the label. Choose a color with the color selector.
Text AnchorWhere, relative to the polygons, to anchor the text. Choose from start, middle, or end.
AlignmentHow to align the text. Choose from top, middle, or bottom.
+ Add More LabelsAdd another label to the polygons.
Polygons with labels.

Polygons with labels.

JSON Schema

For details on how to programmatically specify layer properties, refer to the Layer Configuration specification.