Geometry Operations API

The Geometry Operations API provides powerful spatial analysis and geometry manipulation capabilities. It allows you to perform 41 different operations on GeoJSON geometries including:

• Boolean operations - union, intersection, difference of polygons
• Measurements - distance between points, polygon area
• Transformations - buffer, simplify, rotate, scale, translate
• Clustering - DBSCAN, K-means, Voronoi diagrams
• Spatial predicates - contains, intersects, within, valid
• Generators - random points, lines, polygons, grids

This API accepts GeoJSON geometries directly in the request body and returns results in a unified format, making it easy to integrate into any application that works with geographic data.

To make it easy for you to get started with the Geometry Operations API, we have created an API Playground where you can test operations interactively.

• Authentication and API key
• API reference
• Supported Operations
• Code samples
• Pricing

Authentication and API key

To use the Geometry Operations API, you'll need an API key. You can register and get a Geometry Operations API Key for free without a credit card.

We offer a free plan, so there's no need to stress about cost. Start for free and upgrade to a paid plan when the needs of your project increase. For more information on our plans, visit the Pricing page.

How to get the Geoapify API key

1. Register on the Geoapify MyProjects page.
2. Create a new project.
3. Go to the API Keys section. One API key is generated automatically. You can generate multiple API keys per project if required.
4. Optionally, you can protect the API key by listing allowed IP addresses, HTTP referrers, origins, and CORS.
5. Choose "Geometry Operations API" and an API key to generate a URL and programming code.
6. Press the "Try" button to execute the API call and get the result object example.

API reference

The Geometry Operations API is an HTTP POST request API that performs spatial analysis and geometry manipulation on GeoJSON data. It supports 41 operations including boolean operations, measurements, transformations, clustering, and more.

Request URL

POST https://api.geoapify.com/v1/geometry/operation?apiKey=YOUR_API_KEY

Query parameters

Request body

All requests are sent as HTTP POST with a JSON body. The request body always includes an operation field.

All other request fields depend on the selected operation and can include:

• operation-specific top-level fields (for example: points, geometry, bbox)
• operation-specific nested parameters in params (for example: params.units, params.steps)

Use Supported Operations to find each operation's required and optional request fields.

Request field conventions

• params.<name> in operation docs means the field must be sent inside the params object.
• bbox can be sent in array format [minLon, minLat, maxLon, maxLat] or object format {lon1, lat1, lon2, lat2}.
• Each operation page uses the same parameter table structure: Name, Type, Description, Example.

Response object

The Geometry Operations API returns a unified response structure for all operations:

Response types:

Example response (geojson):

{
  "type": "geojson",
  "data": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Example response (number):

{
  "type": "number",
  "data": 3941.52
}

Example response (boolean):

{
  "type": "boolean",
  "data": true
}

Response HTTP status codes

Supported Operations

The API supports 41 operations organized into 10 categories.

Select an operation to view required inputs, result type, and request examples.

1. Constructive / Polygon Set Operations

These operations combine or compare polygon geometries.

• union - Merges multiple polygons into a single polygon, combining all areas.
• intersection - Finds the overlapping area common to all input polygons.
• difference - Subtracts subsequent polygons from the first polygon.

2. Point Set / Surface / Clustering

These operations work with point collections to create surfaces, hulls, or clusters.

• voronoi - Creates a Voronoi diagram from a set of points. Each cell contains all locations closest to its seed point.
• clustersDbscan - Performs DBSCAN (Density-Based Spatial Clustering) on points.
• clustersKmeans - Performs K-means clustering on points.
• concave - Creates a concave hull (alpha shape) around a set of points.
• convex - Creates a convex hull around a set of points - the smallest convex polygon containing all points.
• tin - Creates a Triangulated Irregular Network (TIN) from points.

3. Spatial Predicates (Boolean)

These operations test spatial relationships and return true or false.

• contains - Checks if geometry1 completely contains geometry2.
• crosses - Checks if two geometries cross each other.
• disjoint - Checks if two geometries have no points in common.
• intersects - Checks if two geometries have at least one point in common.
• within - Checks if geometry1 is completely within geometry2.
• valid - Checks if a geometry is valid according to OGC standards.

4. Measurement (Numeric)

These operations calculate distances and areas, returning numeric values.

• distance - Calculates the distance between two points.
• area - Calculates the area of a polygon in square meters.
• pointToLineDistance - Calculates the shortest distance from a point to a line.
• pointToPolygonDistance - Calculates the shortest distance from a point to a polygon boundary.

5. Line Operations

These operations work with lines and points along lines.

• pointOnLine - Checks if a point lies on a line. Returns true if the point is exactly on the line, false otherwise.
• nearestPointOnLine - Finds the nearest point on a line (supports MultiLineString).
• lineIntersect - Finds all intersection points between two lines.
• along - Returns a point at a specified distance along a line.

6. Transformations

These operations modify geometries by applying spatial transformations.

• buffer - Creates a buffer polygon around a geometry at a specified distance.
• simplify - Simplifies a geometry by reducing the number of vertices while preserving shape.
• transformRotate - Rotates a geometry around a pivot point.
• transformScale - Scales a geometry from a given origin.
• transformTranslate - Moves a geometry by a specified distance in a given direction.

7. Geometry Centers

These operations calculate different types of center points for geometries.

• center - Calculates the absolute center point (centroid of bounding box).
• centerMean - Calculates the mean center of all vertices.
• centerMedian - Calculates the median center using iterative approach.
• centerOfMass - Calculates the center of mass (centroid) of a geometry.

8. Bounding / Envelope

These operations calculate bounding regions for geometries.

• bbox - Returns the bounding box of a geometry as a polygon.
• envelope - Returns the minimum bounding rectangle (envelope) containing all geometries.

9. Grid & Random Generators

These operations generate grids and random geometries within a bounding box.

• grid - Generates a grid of cells within a bounding box.
• randomPoint - Generates random points within a bounding box.
• randomLineString - Generates random line strings within a bounding box.
• randomPolygon - Generates random polygons within a bounding box.

10. Geometry Queries & Advanced

These operations provide advanced spatial queries and calculations.

• pointsWithinPolygon - Finds all points that fall within a polygon.
• greatCircle - Calculates the great circle arc between two points on Earth's surface.
• tesselate - Divides a polygon into triangles.

union

Category: Constructive / Polygon Set Operations

Merges multiple polygons into a single polygon, combining all areas.

Example of API request:

{
  "operation": "union",
  "polygons": [
    {
      "type": "Polygon",
      "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
    },
    {
      "type": "Polygon",
      "coordinates": [[[5, 5], [15, 5], [15, 15], [5, 15], [5, 5]]]
    }
  ]
}

Result type: geojson

Back to Supported Operations

intersection

Category: Constructive / Polygon Set Operations

Finds the overlapping area common to all input polygons.

Example of API request:

{
  "operation": "intersection",
  "polygons": [
    {
      "type": "Polygon",
      "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
    },
    {
      "type": "Polygon",
      "coordinates": [[[5, 5], [15, 5], [15, 15], [5, 15], [5, 5]]]
    }
  ]
}

Result type: geojson

Back to Supported Operations

difference

Category: Constructive / Polygon Set Operations

Subtracts subsequent polygons from the first polygon.

Example of API request:

{
  "operation": "difference",
  "polygons": [
    {
      "type": "Polygon",
      "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
    },
    {
      "type": "Polygon",
      "coordinates": [[[5, 5], [15, 5], [15, 15], [5, 15], [5, 5]]]
    }
  ]
}

Result type: geojson

Back to Supported Operations

voronoi

Category: Point Set / Surface / Clustering

Creates a Voronoi diagram from a set of points. Each cell contains all locations closest to its seed point.

Example of API request:

{
  "operation": "voronoi",
  "points": [
    {"type": "Point", "coordinates": [-73.985, 40.748]},
    {"type": "Point", "coordinates": [-73.979, 40.754]},
    {"type": "Point", "coordinates": [-73.968, 40.785]}
  ],
  "bbox": [-74.02, 40.70, -73.90, 40.82]
}

Result type: geojson

Back to Supported Operations

clustersDbscan

Category: Point Set / Surface / Clustering

Performs DBSCAN (Density-Based Spatial Clustering) on points.

Example of API request:

{
  "operation": "clustersDbscan",
  "points": [
    {"type": "Point", "coordinates": [-73.985, 40.748]},
    {"type": "Point", "coordinates": [-73.984, 40.749]},
    {"type": "Point", "coordinates": [-73.968, 40.785]}
  ],
  "maxDistance": 500,
  "params": {
    "units": "meters",
    "minPoints": 2
  }
}

Result type: geojson

Back to Supported Operations

clustersKmeans

Category: Point Set / Surface / Clustering

Performs K-means clustering on points.

Example of API request:

{
  "operation": "clustersKmeans",
  "points": [
    {"type": "Point", "coordinates": [-73.985, 40.748]},
    {"type": "Point", "coordinates": [-73.984, 40.749]},
    {"type": "Point", "coordinates": [-73.968, 40.785]},
    {"type": "Point", "coordinates": [-73.967, 40.784]}
  ],
  "params": {
    "numberOfClusters": 2
  }
}

Result type: geojson

Back to Supported Operations

concave

Category: Point Set / Surface / Clustering

Creates a concave hull (alpha shape) around a set of points.

Example of API request:

{
  "operation": "concave",
  "points": [
    {"type": "Point", "coordinates": [-73.985, 40.748]},
    {"type": "Point", "coordinates": [-73.979, 40.754]},
    {"type": "Point", "coordinates": [-73.968, 40.785]},
    {"type": "Point", "coordinates": [-73.990, 40.760]}
  ],
  "params": {
    "maxEdge": 1,
    "units": "kilometers"
  }
}

Result type: geojson or empty (when no hull can be formed with given maxEdge)

Note: params.maxEdge is optional. If provided and the points are too spread apart relative to maxEdge, the operation returns an empty result.

Back to Supported Operations

convex

Category: Point Set / Surface / Clustering

Creates a convex hull around a set of points - the smallest convex polygon containing all points.

Example of API request:

{
  "operation": "convex",
  "points": [
    {"type": "Point", "coordinates": [-73.985, 40.748]},
    {"type": "Point", "coordinates": [-73.979, 40.754]},
    {"type": "Point", "coordinates": [-73.968, 40.785]},
    {"type": "Point", "coordinates": [-73.990, 40.760]}
  ]
}

Result type: geojson

Back to Supported Operations

tin

Category: Point Set / Surface / Clustering

Creates a Triangulated Irregular Network (TIN) from points.

Example of API request:

{
  "operation": "tin",
  "points": [
    {"type": "Point", "coordinates": [-73.985, 40.748]},
    {"type": "Point", "coordinates": [-73.979, 40.754]},
    {"type": "Point", "coordinates": [-73.968, 40.785]},
    {"type": "Point", "coordinates": [-73.990, 40.760]}
  ]
}

Result type: geojson

Back to Supported Operations

contains

Category: Spatial Predicates (Boolean)

Checks if geometry1 completely contains geometry2.

Example of API request:

{
  "operation": "contains",
  "geometry1": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [20, 0], [20, 20], [0, 20], [0, 0]]]
  },
  "geometry2": {
    "type": "Point",
    "coordinates": [10, 10]
  }
}

Result type: boolean

Back to Supported Operations

crosses

Category: Spatial Predicates (Boolean)

Checks if two geometries cross each other.

Example of API request:

{
  "operation": "crosses",
  "geometry1": {
    "type": "LineString",
    "coordinates": [[0, 0], [10, 10]]
  },
  "geometry2": {
    "type": "LineString",
    "coordinates": [[0, 10], [10, 0]]
  }
}

Result type: boolean

Back to Supported Operations

disjoint

Category: Spatial Predicates (Boolean)

Checks if two geometries have no points in common.

Example of API request:

{
  "operation": "disjoint",
  "geometry1": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [5, 0], [5, 5], [0, 5], [0, 0]]]
  },
  "geometry2": {
    "type": "Polygon",
    "coordinates": [[[10, 10], [15, 10], [15, 15], [10, 15], [10, 10]]]
  }
}

Result type: boolean

Back to Supported Operations

intersects

Category: Spatial Predicates (Boolean)

Checks if two geometries have at least one point in common.

Example of API request:

{
  "operation": "intersects",
  "geometry1": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  },
  "geometry2": {
    "type": "Polygon",
    "coordinates": [[[5, 5], [15, 5], [15, 15], [5, 15], [5, 5]]]
  }
}

Result type: boolean

Back to Supported Operations

within

Category: Spatial Predicates (Boolean)

Checks if geometry1 is completely within geometry2.

Example of API request:

{
  "operation": "within",
  "geometry1": {
    "type": "Point",
    "coordinates": [5, 5]
  },
  "geometry2": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Result type: boolean

Back to Supported Operations

valid

Category: Spatial Predicates (Boolean)

Checks if a geometry is valid according to OGC standards.

Example of API request:

{
  "operation": "valid",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Result type: boolean

Back to Supported Operations

distance

Category: Measurement (Numeric)

Calculates the distance between two points.

Example of API request:

{
  "operation": "distance",
  "point1": {"type": "Point", "coordinates": [-73.985, 40.748]},
  "point2": {"type": "Point", "coordinates": [-118.243, 34.052]},
  "params": {
    "units": "kilometers"
  }
}

Result type: number

Back to Supported Operations

area

Category: Measurement (Numeric)

Calculates the area of a polygon in square meters.

Example of API request:

{
  "operation": "area",
  "polygon": {
    "type": "Polygon",
    "coordinates": [[[-73.98, 40.75], [-73.97, 40.75], [-73.97, 40.76], [-73.98, 40.76], [-73.98, 40.75]]]
  }
}

Result type: number

Back to Supported Operations

pointToLineDistance

Category: Measurement (Numeric)

Calculates the shortest distance from a point to a line.

Example of API request:

{
  "operation": "pointToLineDistance",
  "point": {"type": "Point", "coordinates": [5, 5]},
  "line": {
    "type": "LineString",
    "coordinates": [[0, 0], [10, 0]]
  },
  "params": {
    "units": "meters"
  }
}

Result type: number

Back to Supported Operations

pointToPolygonDistance

Category: Measurement (Numeric)

Calculates the shortest distance from a point to a polygon boundary.

Example of API request:

{
  "operation": "pointToPolygonDistance",
  "point": {"type": "Point", "coordinates": [15, 15]},
  "polygon": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  },
  "params": {
    "units": "meters"
  }
}

Result type: number

Back to Supported Operations

pointOnLine

Category: Line Operations

Checks if a point lies on a line. Returns true if the point is exactly on the line, false otherwise.

Example of API request:

{
  "operation": "pointOnLine",
  "point": {"type": "Point", "coordinates": [5, 0]},
  "line": {
    "type": "LineString",
    "coordinates": [[0, 0], [10, 0], [10, 10]]
  }
}

Result type: boolean

Note: To find the closest point on a line from a given point, use nearestPointOnLine instead, which returns a GeoJSON point.

Back to Supported Operations

nearestPointOnLine

Category: Line Operations

Finds the nearest point on a line (supports MultiLineString).

Example of API request:

{
  "operation": "nearestPointOnLine",
  "point": {"type": "Point", "coordinates": [5, 5]},
  "line": {
    "type": "LineString",
    "coordinates": [[0, 0], [10, 0], [10, 10]]
  },
  "params": {
    "units": "kilometers"
  }
}

Result type: geojson

Back to Supported Operations

lineIntersect

Category: Line Operations

Finds all intersection points between two lines.

Example of API request:

{
  "operation": "lineIntersect",
  "line1": {
    "type": "LineString",
    "coordinates": [[0, 0], [10, 10]]
  },
  "line2": {
    "type": "LineString",
    "coordinates": [[0, 10], [10, 0]]
  }
}

Result type: geojson

Back to Supported Operations

along

Category: Line Operations

Returns a point at a specified distance along a line.

Example of API request:

{
  "operation": "along",
  "line": {
    "type": "LineString",
    "coordinates": [[-73.985, 40.748], [-73.968, 40.785]]
  },
  "distance": 2,
  "params": {
    "units": "kilometers"
  }
}

Result type: geojson

Back to Supported Operations

buffer

Category: Transformations

Creates a buffer polygon around a geometry at a specified distance.

Example of API request:

{
  "operation": "buffer",
  "geometry": {
    "type": "Point",
    "coordinates": [-73.985, 40.748]
  },
  "distance": 1,
  "params": {
    "units": "kilometers",
    "steps": 64
  }
}

Result type: geojson

Back to Supported Operations

simplify

Category: Transformations

Simplifies a geometry by reducing the number of vertices while preserving shape.

Example of API request:

{
  "operation": "simplify",
  "geometry": {
    "type": "LineString",
    "coordinates": [[0, 0], [1, 1], [2, 0], [3, 1], [4, 0], [5, 1]]
  },
  "params": {
    "tolerance": 0.5,
    "highQuality": true
  }
}

Result type: geojson

Back to Supported Operations

transformRotate

Category: Transformations

Rotates a geometry around a pivot point.

Example of API request:

{
  "operation": "transformRotate",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  },
  "angle": 45,
  "params": {
    "pivot": [5, 5]
  }
}

Result type: geojson

Back to Supported Operations

transformScale

Category: Transformations

Scales a geometry from a given origin.

Example of API request:

{
  "operation": "transformScale",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  },
  "factor": 2,
  "params": {
    "origin": "center"
  }
}

Result type: geojson

Origin options: center, centroid, sw, se, nw, ne, or [lon, lat] coordinate array.

Back to Supported Operations

transformTranslate

Category: Transformations

Moves a geometry by a specified distance in a given direction.

Example of API request:

{
  "operation": "transformTranslate",
  "geometry": {
    "type": "Point",
    "coordinates": [-73.985, 40.748]
  },
  "distance": 1,
  "direction": 90,
  "params": {
    "units": "kilometers"
  }
}

Result type: geojson

Back to Supported Operations

center

Category: Geometry Centers

Calculates the absolute center point (centroid of bounding box).

Example of API request:

{
  "operation": "center",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Result type: geojson

Back to Supported Operations

centerMean

Category: Geometry Centers

Calculates the mean center of all vertices.

Example of API request:

{
  "operation": "centerMean",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 5], [0, 5], [0, 0]]]
  }
}

Result type: geojson

Back to Supported Operations

centerMedian

Category: Geometry Centers

Calculates the median center using iterative approach.

Example of API request:

{
  "operation": "centerMedian",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Result type: geojson

Back to Supported Operations

centerOfMass

Category: Geometry Centers

Calculates the center of mass (centroid) of a geometry.

Example of API request:

{
  "operation": "centerOfMass",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Result type: geojson

Back to Supported Operations

bbox

Category: Bounding / Envelope

Returns the bounding box of a geometry as a polygon.

Example of API request:

{
  "operation": "bbox",
  "geometry": {
    "type": "LineString",
    "coordinates": [[0, 0], [5, 3], [10, 8]]
  }
}

Result type: geojson

Back to Supported Operations

envelope

Category: Bounding / Envelope

Returns the minimum bounding rectangle (envelope) containing all geometries.

Example of API request:

{
  "operation": "envelope",
  "geometries": [
    {"type": "Point", "coordinates": [0, 0]},
    {"type": "Point", "coordinates": [10, 10]},
    {"type": "Point", "coordinates": [5, 15]}
  ]
}

Result type: geojson

Back to Supported Operations

grid

Category: Grid & Random Generators

Generates a grid of cells within a bounding box.

Example of API request:

{
  "operation": "grid",
  "bbox": [-73.99, 40.74, -73.96, 40.77],
  "type": "square",
  "cellSide": 0.5,
  "params": {
    "units": "kilometers"
  }
}

Result type: geojson

Grid types: hex, point, square, triangle

Back to Supported Operations

randomPoint

Category: Grid & Random Generators

Generates random points within a bounding box.

Example of API request:

{
  "operation": "randomPoint",
  "bbox": [-73.99, 40.74, -73.96, 40.77],
  "count": 10
}

Result type: geojson

Back to Supported Operations

randomLineString

Category: Grid & Random Generators

Generates random line strings within a bounding box.

Example of API request:

{
  "operation": "randomLineString",
  "bbox": [-73.99, 40.74, -73.96, 40.77],
  "count": 5,
  "params": {
    "numVertices": 10,
    "maxLength": 0.01
  }
}

Result type: geojson

Back to Supported Operations

randomPolygon

Category: Grid & Random Generators

Generates random polygons within a bounding box.

Example of API request:

{
  "operation": "randomPolygon",
  "bbox": [-73.99, 40.74, -73.96, 40.77],
  "count": 3,
  "params": {
    "numVertices": 6,
    "maxRadialLength": 0.01
  }
}

Result type: geojson

Back to Supported Operations

pointsWithinPolygon

Category: Geometry Queries & Advanced

Finds all points that fall within a polygon.

Example of API request:

{
  "operation": "pointsWithinPolygon",
  "points": [
    {"type": "Point", "coordinates": [5, 5]},
    {"type": "Point", "coordinates": [15, 15]},
    {"type": "Point", "coordinates": [8, 8]}
  ],
  "polygon": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
}

Result type: geojson

Back to Supported Operations

greatCircle

Category: Geometry Queries & Advanced

Calculates the great circle arc between two points on Earth's surface.

Example of API request:

{
  "operation": "greatCircle",
  "point1": {"type": "Point", "coordinates": [-73.985, 40.748]},
  "point2": {"type": "Point", "coordinates": [2.352, 48.856]},
  "params": {
    "npoints": 100
  }
}

Result type: geojson

Back to Supported Operations

tesselate

Category: Geometry Queries & Advanced

Divides a polygon into triangles.

Example of API request:

{
  "operation": "tesselate",
  "polygon": {
    "type": "Polygon",
    "coordinates": [[[0, 0], [10, 0], [10, 10], [5, 15], [0, 10], [0, 0]]]
  }
}

Result type: geojson

Back to Supported Operations

Code samples

The Geometry Operations API is an HTTP POST request that accepts JSON and returns GeoJSON or other data types. Requests are platform-independent and can be made from most programming languages. For our code samples, we use JavaScript.

Call Geometry Operations API

The call to the Geometry Operations API is a simple HTTP POST request. For example:

const myAPIKey = "YOUR_API_KEY";

async function geometryOperation(requestBody) {
  const response = await fetch(
    `https://api.geoapify.com/v1/geometry/operation?apiKey=${myAPIKey}`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json"
      },
      body: JSON.stringify(requestBody)
    }
  );
  return response.json();
}

// Example: Calculate union of two polygons
const result = await geometryOperation({
  operation: "union",
  polygons: [
    {
      type: "Polygon",
      coordinates: [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
    },
    {
      type: "Polygon",
      coordinates: [[[5, 5], [15, 5], [15, 15], [5, 15], [5, 5]]]
    }
  ]
});

console.log(result);
// { type: "geojson", data: { type: "Polygon", coordinates: [...] } }

Visualize geometry result with Leaflet

When the operation returns a GeoJSON result, you can display it on a Leaflet map:

// Call the API
const result = await geometryOperation({
  operation: "buffer",
  geometry: { type: "Point", coordinates: [-73.985, 40.748] },
  distance: 1,
  params: { units: "kilometers" }
});

// Add result to map
if (result.type === "geojson") {
  L.geoJSON(result.data, {
    style: function (feature) {
      return {
        color: '#3388ff',
        fillColor: '#3388ff',
        fillOpacity: 0.3,
        weight: 2
      };
    }
  }).addTo(map);
}

Visualize geometry result with MapLibre GL

You can also visualize geometry results on a MapLibre GL map:

// Call the API
const result = await geometryOperation({
  operation: "convex",
  points: [
    { type: "Point", coordinates: [-73.985, 40.748] },
    { type: "Point", coordinates: [-73.979, 40.754] },
    { type: "Point", coordinates: [-73.968, 40.785] },
    { type: "Point", coordinates: [-73.990, 40.760] }
  ]
});

// Add result to map
if (result.type === "geojson") {
  map.addSource('geometry-result', {
    type: 'geojson',
    data: result.data
  });

  map.addLayer({
    id: 'geometry-fill',
    type: 'fill',
    source: 'geometry-result',
    paint: {
      'fill-color': '#3388ff',
      'fill-opacity': 0.3
    }
  });

  map.addLayer({
    id: 'geometry-line',
    type: 'line',
    source: 'geometry-result',
    paint: {
      'line-color': '#3388ff',
      'line-width': 2
    }
  });
}

Handle different result types

The Geometry Operations API returns different result types depending on the operation:

async function handleResult(requestBody) {
  const result = await geometryOperation(requestBody);

  switch (result.type) {
    case 'geojson':
      // Display on map or process geometry
      console.log('Geometry result:', result.data);
      L.geoJSON(result.data).addTo(map);
      break;
      
    case 'number':
      // Display numeric result (distance, area)
      console.log('Numeric result:', result.data);
      break;
      
    case 'boolean':
      // Handle spatial predicate result
      console.log('Boolean result:', result.data);
      break;
      
    case 'empty':
      // No result
      console.log('No result');
      break;
  }
}

// Example: Check if point is within polygon
handleResult({
  operation: "within",
  geometry1: { type: "Point", coordinates: [5, 5] },
  geometry2: {
    type: "Polygon",
    coordinates: [[[0, 0], [10, 0], [10, 10], [0, 10], [0, 0]]]
  }
});
// Output: Boolean result: true

Visualize geometry result with OpenLayers

Here's how to display geometry results using OpenLayers:

// Call the API
const result = await geometryOperation({
  operation: "grid",
  bbox: [-73.99, 40.74, -73.96, 40.77],
  type: "hex",
  cellSide: 0.2,
  params: { units: "kilometers" }
});

// Add result to map
if (result.type === "geojson") {
  const vectorSource = new ol.source.Vector({
    features: new ol.format.GeoJSON({
      featureProjection: "EPSG:3857"
    }).readFeatures(result.data)
  });

  const style = new ol.style.Style({
    stroke: new ol.style.Stroke({
      color: 'rgba(51, 136, 255, 1.0)',
      width: 2
    }),
    fill: new ol.style.Fill({
      color: 'rgba(51, 136, 255, 0.2)'
    })
  });

  const vectorLayer = new ol.layer.Vector({
    source: vectorSource,
    style: style
  });

  map.addLayer(vectorLayer);
}

Pricing

The API call cost is calculated in credits. This helps us keep pricing simple and make our APIs universally usable:

Each POST request to the Geometry Operations API consumes 1 credit regardless of the operation performed or the complexity of input geometries.

Please choose from our various Pricing Plans to suit your needs, including a Free Plan with 3000 credits/day included.