Geospatial / tiled imagery

Guide for labeling geospatial data.


When you attach a geospatial dataset to a project, Labelbox will automatically adjust the editor interface for labeling geospatial data.

For more information on the import format, see our docs on Geospatial / Tiled Imagery import formats.

How Slippy maps work

Tiled imagery uses a Slippy Map tool for labeling map tiles of the earth at various zoom levels. Slippy Map is a term that refers to modern web maps that let you zoom and pan around.

Map tiles are structured like a pyramid of zoom levels. The topmost layer is the largest in size and only includes one tile. The tiles in each subsequent layer decrease in size, but increase in number and resolution. You can use the minZoom and maxZoom parameters to specify the zoom level limits. The zoom parameter is an integer between 0 (zoomed out) and 18 (zoomed in). 18 is normally the maximum, but some tile servers may go beyond that.

In order to use our Tiled imagery tool, you must use a tile server to create your map tiles. When you import your map tiles, you can use bounds to specify the area of interest and to break up your map tiles into labeling tasks.

Tiled imagery supports the following coordinate reference systems (CRS):

EPSG:3857A projected coordinate system measured in meters on a flattened surface. It is the projection of EPSG:4326 coordinate system onto a square for viewing on a web app. Uses the Spherical Mercator projection (AKA Web Mercator projection) to render on a web page.
EPSG: 4326A geographic coordinate system used by GPS to express locations on the earth using GeoJSON longitude and latitude. Also known as the World geodetic system (WGS84).
SimpleA basic geographic coordinate reference system that maps x to longitude and y to latitude. Also uses the Equirectangular or Plate Carrée projection to render on a web page.

Supported annotation types

These are the annotation types you may include in your ontology for labeling tiled imagery data. Classification-type annotations can be applied at the global level and/or nested within an object-type annotation.

Import annotationExport annotation
Bounding boxSee payloadSee payload
PolygonSee payloadSee payload
PolylineSee payloadSee payload
PointSee payloadSee payload
Radio classificationSee payloadSee payload
Checklist classificationSee payloadSee payload
Free-form text classificationSee payloadSee payload


Use polygon for segmentation mask use cases

It is our recommendation to use our polygon tool if your use case requires segmentation masks.

  1. The polygon tool with free hand annotations will allow you to draw the necessary shapes and the export will return the vertices in the coordinate system of your geo file.
  2. You will not have to deal with really large PNGs that are returned when using segmentation masks

Bounding box

Create a bounding box by starting at one corner and dragging your cursor to create the shape around an object in the tiled image.

You can also click & drag to reposition the bounding box on the tiled image.


Create a polygon annotation by clicking to create each point in the shape. Click the first point to close the Polygon.

In order to create a more freehand shape, click and hold down your mouse, and our polygon tool with automatically add vertices in the path of the cursor. The slower you move your cursor, the closer the points will be together.


Pen tool

Use the pen tool to outline the item in the image. Hold the cursor down to draw freehand or let the cursor go to draw straight lines between points. The pen tool is only available when creating polygons. Click the pen icon with the plus sign to use the pen tool.

Erase tool

You can use the erase tool to clean up the edges of your polygon. Click the pen icon with the minus sign to use the erase tool.


Use the polyline tool to label lines in the tiled imagery editor. Click on the last point to complete the shape.



Use the point tool to label precise locations on the tiled image.