Geospatial / tiled imagery
Guide for labeling geospatial data.
Overview
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):
CRS | Description |
---|---|
EPSG:3857 | A 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: 4326 | A 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). |
Simple | A 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 annotation | Export annotation | |
---|---|---|
Bounding box | See payload | See payload |
Polygon | See payload | See payload |
Polyline | See payload | See payload |
Point | See payload | See payload |
Radio classification | See payload | See payload |
Checklist classification | See payload | See payload |
Free-form text classification | See payload | See payload |
Use polygon for segmentation mask use cases
It is our recommendation to use our polygon tool if your use case requires segmentation masks.
- 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.
- 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.
Polygon
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.
Polyline
Use the polyline tool to label lines in the tiled imagery editor. Click on the last point to complete the shape.

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

Updated 3 months ago