LogoLogo
HomeAcademyLoginTry for free
  • Welcome
  • What's new
    • Q2 2025
    • Q1 2025
    • Q4 2024
    • Q3 2024
    • Q2 2024
    • Q1 2024
    • Q4 2023
    • Q3 2023
    • Q2 2023
    • Q1 2023
    • Q4 2022
    • Q3 2022
  • FAQs
    • Accounts
    • Migration to the new platform
    • User & organization setup
    • General
    • Builder
    • Workflows
    • Data Observatory
    • Analytics Toolbox
    • Development Tools
    • Deployment Options
    • CARTO Basemaps
    • CARTO for Education
    • Support Packages
    • Security and Compliance
  • Getting started
    • What is CARTO?
    • Quickstart guides
      • Connecting to your data
      • Creating your first map
      • Creating your first workflow
      • Developing your first application
    • CARTO Academy
  • CARTO User Manual
    • Overview
      • Creating your CARTO organization
      • CARTO Cloud Regions
      • CARTO Workspace overview
    • Maps
      • Data sources
        • Simple features
        • Spatial Indexes
        • Pre-generated tilesets
        • Rasters
        • Defining source spatial data
        • Managing data freshness
        • Changing data source location
      • Layers
        • Point
          • Grid point aggregation
          • H3 point aggregation
          • Heatmap point aggregation
          • Cluster point aggregation
        • Polygon
        • Line
        • Grid
        • H3
        • Raster
        • Zoom to layer
      • Widgets
        • Formula widget
        • Category widget
        • Pie widget
        • Histogram widget
        • Range widget
        • Time Series widget
        • Table widget
      • SQL Parameters
        • Date parameter
        • Text parameter
        • Numeric parameter
        • Publishing SQL parameters
      • Interactions
      • Legend
      • Basemaps
        • Basemap selector
      • AI Agents
      • SQL analyses
      • Map view modes
      • Map description
      • Feature selection tool
      • Search locations
      • Measure distances
      • Exporting data
      • Download PDF reports
      • Managing maps
      • Sharing and collaboration
        • Editor collaboration
        • Map preview for editors
        • Map settings for viewers
        • Comments
        • Embedding maps
        • URL parameters
      • Performance considerations
    • Workflows
      • Workflow canvas
      • Results panel
      • Components
        • Aggregation
        • Custom
        • Data Enrichment
        • Data Preparation
        • Generative AI
        • Input / Output
        • Joins
        • Parsers
        • Raster Operations
        • Spatial Accessors
        • Spatial Analysis
        • Spatial Constructors
        • Spatial Indexes
        • Spatial Operations
        • Statistics
        • Tileset Creation
        • BigQuery ML
        • Snowflake ML
        • Google Earth Engine
        • Google Environment APIs
        • Telco Signal Propagation Models
      • Data Sources
      • Scheduling workflows
      • Sharing workflows
      • Using variables in workflows
      • Executing workflows via API
      • Temporary data in Workflows
      • Extension Packages
      • Managing workflows
      • Workflows best practices
    • Data Explorer
      • Creating a map from your data
      • Importing data
        • Importing rasters
      • Geocoding data
      • Optimizing your data
    • Data Observatory
      • Terminology
      • Browsing the Spatial Data Catalog
      • Subscribing to public and premium datasets
      • Accessing free data samples
      • Managing your subscriptions
      • Accessing your subscriptions from your data warehouse
        • Access data in BigQuery
        • Access data in Snowflake
        • Access data in Databricks
        • Access data in Redshift
        • Access data in PostgreSQL
    • Connections
      • Google BigQuery
      • Snowflake
      • Databricks
      • Amazon Redshift
      • PostgreSQL
      • CARTO Data Warehouse
      • Sharing connections
      • Deleting a connection
      • Required permissions
      • IP whitelisting
      • Customer data responsibilities
    • Applications
    • Settings
      • Understanding your organization quotas
      • Activity Data
        • Activity Data Reference
        • Activity Data Examples
        • Activity Data Changelog
      • Users and Groups
        • Inviting users to your organization
        • Managing user roles
        • Deleting users
        • SSO
        • Groups
        • Mapping groups to user roles
      • CARTO Support Access
      • Customizations
        • Customizing appearance and branding
        • Configuring custom color palettes
        • Configuring your organization basemaps
        • Enabling AI Agents
      • Advanced Settings
        • Managing applications
        • Configuring S3 Bucket for Redshift Imports
        • Configuring OAuth connections to Snowflake
        • Configuring OAuth U2M connections to Databricks
        • Configuring S3 Bucket integration for RDS for PostgreSQL Exports in Builder
        • Configuring Workload Identity Federation for BigQuery
      • Data Observatory
      • Deleting your organization
    • Developers
      • Managing Credentials
        • API Base URL
        • API Access Tokens
        • SPA OAuth Clients
        • M2M OAuth Clients
      • Named Sources
  • Data and Analysis
    • Analytics Toolbox Overview
    • Analytics Toolbox for BigQuery
      • Getting access
        • Projects maintained by CARTO in different BigQuery regions
        • Manual installation in your own project
        • Installation in a Google Cloud VPC
        • Core module
      • Key concepts
        • Tilesets
        • Spatial indexes
      • SQL Reference
        • accessors
        • clustering
        • constructors
        • cpg
        • data
        • http_request
        • import
        • geohash
        • h3
        • lds
        • measurements
        • placekey
        • processing
        • quadbin
        • random
        • raster
        • retail
        • routing
        • s2
        • statistics
        • telco
        • tiler
        • transformations
      • Guides
        • Running queries from Builder
        • Working with Raster data
      • Release notes
      • About Analytics Toolbox regions
    • Analytics Toolbox for Snowflake
      • Getting access
        • Native App from Snowflake's Marketplace
        • Manual installation
      • Key concepts
        • Spatial indexes
        • Tilesets
      • SQL Reference
        • accessors
        • clustering
        • constructors
        • data
        • http_request
        • import
        • h3
        • lds
        • measurements
        • placekey
        • processing
        • quadbin
        • random
        • raster
        • retail
        • s2
        • statistics
        • tiler
        • transformations
      • Guides
        • Running queries from Builder
        • Working with Raster data
      • Release Notes
    • Analytics Toolbox for Databricks
      • Getting access
        • Personal (former Single User) cluster
        • Standard (former Shared) cluster
      • Reference
        • lds
        • tiler
      • Guides
      • Release Notes
    • Analytics Toolbox for Redshift
      • Getting access
        • Manual installation in your database
        • Installation in an Amazon Web Services VPC
        • Core version
      • Key concepts
        • Tilesets
        • Spatial indexes
      • SQL Reference
        • clustering
        • constructors
        • data
        • http_request
        • import
        • lds
        • placekey
        • processing
        • quadbin
        • random
        • s2
        • statistics
        • tiler
        • transformations
      • Guides
        • Running queries from Builder
      • Release Notes
    • Analytics Toolbox for PostgreSQL
      • Getting access
        • Manual installation
        • Core version
      • Key concepts
        • Tilesets
        • Spatial Indexes
      • SQL Reference
        • h3
        • quadbin
        • tiler
      • Guides
        • Creating spatial index tilesets
        • Running queries from Builder
      • Release Notes
    • CARTO + Python
      • Installation
      • Authentication Methods
      • Visualizing Data
      • Working with Data
        • How to work with your data in the CARTO Data Warehouse
        • How to access your Data Observatory subscriptions
        • How to access CARTO's Analytics Toolbox for BigQuery and create visualizations via Python notebooks
        • How to access CARTO’s Analytics Toolbox for Snowflake and create visualizations via Python notebooks
        • How to visualize data from Databricks
      • Reference
    • CARTO QGIS Plugin
  • CARTO for Developers
    • Overview
    • Key concepts
      • Architecture
      • Libraries and APIs
      • Authentication methods
        • API Access Tokens
        • OAuth Access Tokens
        • OAuth Clients
      • Connections
      • Data sources
      • Visualization with deck.gl
        • Basemaps
          • CARTO Basemap
          • Google Maps
            • Examples
              • Gallery
              • Getting Started
              • Basic Examples
                • Hello World
                • BigQuery Tileset Layer
                • Data Observatory Tileset Layer
              • Advanced Examples
                • Arc Layer
                • Extrusion
                • Trips Layer
            • What's New
          • Amazon Location
            • Examples
              • Hello World
              • CartoLayer
            • What's New
        • Rapid Map Prototyping
      • Charts and widgets
      • Filtering and interactivity
      • Summary
    • Quickstart
      • Make your first API call
      • Visualize your first dataset
      • Create your first widget
    • Guides
      • Build a public application
      • Build a private application
      • Build a private application using SSO
      • Visualize massive datasets
      • Integrate CARTO in your existing application
      • Use Boundaries in your application
      • Avoid exposing SQL queries with Named Sources
      • Managing cache in your CARTO applications
    • Reference
      • Deck (@deck.gl reference)
      • Data Sources
        • vectorTableSource
        • vectorQuerySource
        • vectorTilesetSource
        • h3TableSource
        • h3QuerySource
        • h3TilesetSource
        • quadbinTableSource
        • quadbinQuerySource
        • quadbinTilesetSource
        • rasterSource
        • boundaryTableSource
        • boundaryQuerySource
      • Layers (@deck.gl/carto)
      • Widgets
        • Data Sources
        • Server-side vs. client-side
        • Models
          • getFormula
          • getCategories
          • getHistogram
          • getRange
          • getScatter
          • getTimeSeries
          • getTable
      • Filters
        • Column filters
        • Spatial filters
      • CARTO APIs Reference
    • Release Notes
    • Examples
    • CARTO for React
      • Guides
        • Getting Started
        • Views
        • Data Sources
        • Layers
        • Widgets
        • Authentication and Authorization
        • Basemaps
        • Look and Feel
        • Query Parameters
        • Code Generator
        • Sample Applications
        • Deployment
        • Upgrade Guide
      • Examples
      • Library Reference
        • Introduction
        • API
        • Auth
        • Basemaps
        • Core
        • Redux
        • UI
        • Widgets
      • Release Notes
  • CARTO Self-Hosted
    • Overview
    • Key concepts
      • Architecture
      • Deployment requirements
    • Quickstarts
      • Single VM deployment (Kots)
      • Orchestrated container deployment (Kots)
      • Advanced Orchestrated container deployment (Helm)
    • Guides
      • Guides (Kots)
        • Configure your own buckets
        • Configure an external in-memory cache
        • Enable Google Basemaps
        • Enable the CARTO Data Warehouse
        • Configure an external proxy
        • Enable BigQuery OAuth connections
        • Configure Single Sign-On (SSO)
        • Use Workload Identity in GCP
        • High availability configuration for CARTO Self-hosted
        • Configure your custom service account
      • Guides (Helm)
        • Configure your own buckets (Helm)
        • Configure an external in-memory cache (Helm)
        • Enable Google Basemaps (Helm)
        • Enable the CARTO Data Warehouse (Helm)
        • Configure an external proxy (Helm)
        • Enable BigQuery OAuth connections (Helm)
        • Configure Single Sign-On (SSO) (Helm)
        • Use Workload Identity in GCP (Helm)
        • Use EKS Pod Identity in AWS (Helm)
        • Enable Redshift imports (Helm)
        • Migrating CARTO Self-hosted installation to an external database (Helm)
        • Advanced customizations (Helm)
        • Configure your custom service account (Helm)
    • Maintenance
      • Maintenance (Kots)
        • Updates
        • Backups
        • Uninstall
        • Rotating keys
        • Monitoring
        • Change the Admin Console password
      • Maintenance (Helm)
        • Monitoring (Helm)
        • Rotating keys (Helm)
        • Uninstall (Helm)
        • Backups (Helm)
        • Updates (Helm)
    • Support
      • Get debug information for Support (Kots)
      • Get debug information for Support (Helm)
    • CARTO Self-hosted Legacy
      • Key concepts
        • Architecture
        • Deployment requirements
      • Quickstarts
        • Single VM deployment (docker-compose)
      • Guides
        • Configure your own buckets
        • Configure an external in-memory cache
        • Enable Google Basemaps
        • Enable the CARTO Data Warehouse
        • Configure an external proxy
        • Enable BigQuery OAuth connections
        • Configure Single Sign-On (SSO)
        • Enable Redshift imports
        • Configure your custom service account
        • Advanced customizations
        • Migrating CARTO Self-Hosted installation to an external database
      • Maintenance
        • Updates
        • Backups
        • Uninstall
        • Rotating keys
        • Monitoring
      • Support
    • Release Notes
  • CARTO Native App for Snowflake Containers
    • Deploying CARTO using Snowflake Container Services
  • Get Help
    • Legal & Compliance
    • Previous libraries and components
    • Migrating your content to the new CARTO platform
Powered by GitBook
On this page
  • BBOX from Values
  • Clip with Polygons
  • Create Grid
  • Create Isolines
  • Create Routes
  • Create Tileset
  • Point from Static LatLon
  • Remove Holes
  • Spatial Process
  • ST Boundary
  • ST Bounding Box
  • ST Extent
  • ST Generate Points
  • ST Geocode
  • ST Make Line
  • ST Make Polygon
  • ST Polygonize

Was this helpful?

Export as PDF
  1. CARTO User Manual
  2. Workflows
  3. Components

Spatial Constructors

PreviousSpatial AnalysisNextSpatial Indexes

Last updated 5 months ago

Was this helpful?

Components that given the specifications in the input generate new sets of spatial data; those being points, line, polygons and even tilesets.

BBOX from Values

Description

This component creates a new table containing a 'geom' column and a single row containing a geography that represents a bounding box as defined by the input min/max values.

Inputs

  • Minimum X [Number]

  • Minimum Y [Number]

  • Maximum X [Number]

  • Maximum Y [Number]

Outputs

  • Result table [Table]

Clip with Polygons

Description

This component creates a new table containing the geographies of the input table clipped to the combined boundary of the geographies in another table. Geographies in this second table must be of type polygon.

Inputs

  • Table to clip [Table]

  • Polygons table [Table]

  • Geo column in table to clip [Column]

  • Geo column in polygons table [Column]

Outputs

  • Result table [Table]

Create Grid

Description

This component creates a new table containing points distributed in a regular grid, according to a given interval. Point geographies are stored in a column named 'geo'. The extent to cover is defined by an ancillary table with geographies.

Inputs

  • Reference table (used for extent) [Table]

  • Geo column [Column]

  • Interval (degrees) [Number]

Outputs

  • Result table [Table]

Create Isolines

Description

This component computes isolines.

Inputs

  • Source table

Settings

  • Geo column: select a column that contains points that will be the origin point of the isoline.

  • Mode: Select a mode of transport for the isoline calculation.

  • Type of range: Select between time or distance for the isoline calculation.

  • Range value (seconds/meters): Input a numeric value that represent seconds if time was selected or meters if distance was selected.

Provider-specific settings:

TravelTime:

  • Departure time: Take into account historical traffic conditions to generate the isoline. Accepted values are now or a timestamp in this format: YYYY-MM-DDThh:mm:ss, for example: 2024-01-31T09:30:00

  • Single shape (default true): Force the resulting isoline to be a single polygon.

TomTom

  • Departure time: Accepted values are any, now or a timestamp in this format: YYYY-MM-DDThh:mm:ss, for example: 2024-01-31T09:30:00

  • Use traffic information if available: Check this option to take into account historical traffic conditions to generate the isoline.

HERE

  • Arrival Time: any, now or timestamp (YYYY-MM-DDThh:mm:ss). Not compatible with Departure Time

  • Departure Time: any, now or timestamp (YYYY-MM-DDThh:mm:ss). Not compatible with Arrival time

  • Optimize for: balanced (default), quality, performance.

  • Routing mode: fast (default), short

  • Origin radius (m): Consider any position in the radius of the origin point as origin.

Advanced Options:

  • Isoline Options: A JSON object that can contain other provider specific options, for example: {"option1":"value", "option2": 123}. Check each provider documentation for a complete reference of available options in the External links section below.

Outputs

  • Result table: The component generates a table that contains the following columns:

    • All columns from input table.

    • An orig_geom column that contains the original point geometry in the selected geo column.

    • A geom column that contains the generated isoline.

    • A carto_isoline_metadata column that can contain additional information. Usually details if the isoline failed for some reason. In most scenarios it will be null if the isoline was generated correctly.

External links

Create Routes

Description

This component creates routes between origin and destination points stored in a table.

Inputs

  • Source table [Table]

  • Origin column [Column]

  • Destination column [Column]

  • Name for column with routes [String]

  • Mode [Selection]

Outputs

  • Result table [Table]

External links

Create Tileset

Description

This component creates a tileset.

Inputs

  • Source table [Table]

  • Geo column [Column]

  • Tileset name [String]

  • Tileset description [String]

  • Minimum zoom [Number]

  • Maximum zoom [Number]

  • Minimum zoom column [Column]

  • Maximum zoom column [Column]

  • Maximum tile size (KB) [Number]

  • Tile feature order [String]

  • Drop duplicates [Boolean]

Outputs

External links

Point from Static LatLon

Description

This component creates a new table containing a single row with a single point geography. The point is stored in a column named 'geo'.

Inputs

  • Longitude [Number]

  • Latitude [Number]

Outputs

  • Result table [Table]

Remove Holes

Description

This component generates a new geo column with polygons without holes.

Inputs

  • Source polygons table [Table]

  • Geo column [Column]

Outputs

  • Result table [Table]

Spatial Process

Description

This component performs high-level spatial object editing from a simple, single component. You can combine multiple objects or cut the spatial objects of the input table.

With this component you can combine objects, cut 1st from 2nd, cut 2nd from 1st, create the intersection object or create the inverse intersection object. Define the action that you want to do using the “Action” field.

Inputs

  • source table [Table]

  • 1st Spatial Field [Column]

  • 2nd Spatial Field [Column]

  • Action [Selection]

Outputs

  • Result table [Table]

ST Boundary

Description

This component adds a new column with the boundary of the input geography.

Inputs

  • Source table [Table]

  • Geo column [Column]

Outputs

  • Result table [Table]:

External links

ST Bounding Box

Description

This component creates a new column containing rectangles that represents the bounding box of each geometry.

Inputs

  • Source table [Table]

  • Geo column [Column]

Outputs

  • Result table [Table]

External links

ST Extent

Description

This component creates a new table containing a 'geom' column and a single row containing a geography that represents the bounding box of the input table.

Inputs

  • Source table [Table]

  • Geo column [Column]

Outputs

  • Result table [Table]

External links

ST Generate Points

Description

This component generates a table with a specified number of random points within a extent.

The extent is specified using a table with polygons.

Inputs

  • Source table [Table]

  • Geo column [Column]

  • Number of points [Number]

Outputs

  • Result table [Table]

External links

ST Geocode

Description

This component geocodes an input table.

It generates a new table with an additional column named 'geo' containing the geocoded addresses.

Inputs

  • Source table [Table]

  • Column with addresses [Column]

  • Country [Selection]

Outputs

  • Table with geocoded rows [Table]

  • Table with rows that could not be geocoded [Table]

External links

ST Make Line

Description

This component creates a new table with an additional column with line geographies. Geographies are created based on another column containing arrays of points.

Inputs

  • Source table [Table]

  • Points column [Column]

Outputs

  • Result table [Table]

External links

ST Make Polygon

Description

This component creates a new table with an additional column with polygon geographies. Geographies are created based on another column containing polylines.

Inputs

  • Source table [Table]

  • Polylines column [Column]

Outputs

  • Result table [Table]

External links

ST Polygonize

Description

This component adds a new column with polygons, created from a column containing arrays of lines representing polygon edges.

Inputs

  • Source table [Table]

  • Geo column [Column]

Outputs

  • Result table [Table]

External links

This component requires installed in the chosen connection to build the workflow.

CARTO . The default one is TravelTime, but TomTom and HERE are also available. Please contact the team at for more information.

This component requires installed in the chosen connection to build the workflow.

On July, 17th 2024 this component was deprecated in favor of the components in the category.

This component requires installed in the chosen connection to build the workflow.

This component requires installed in the chosen connection to build the workflow.

This component requires installed in the chosen connection to build the workflow.

This component requires installed in the chosen connection to build the workflow.

BigQuery reference
the CARTO Analytics Toolbox
makes use of different isoline providers
support@carto.com
TravelTime API reference
HERE API reference
TomTom API reference
the CARTO Analytics Toolbox
BigQuery reference
Tileset Creation
the CARTO Analytics Toolbox
BigQuery reference
BigQuery reference
Redshift reference
BigQuery reference
Snowflake reference
Redshift reference
PostgreSQL reference
BigQuery reference
the CARTO Analytics Toolbox
BigQuery reference
the CARTO Analytics Toolbox
BigQuery reference
BigQuery reference
PostgreSQL reference
BigQuery reference
Snowflake reference
Redshift reference
PostgreSQL reference
the CARTO Analytics Toolbox
BigQuery reference