---
tags:
- geospatial
- geobase
- building-footprint-segmentation
- building-detection
---
| <img src="https://upload.wikimedia.org/wikipedia/commons/6/6a/JavaScript-logo.png" width="28" height="28"> | [GeoAi](https://www.npmjs.com/package/geoai) |
|---|---|



> `task = building-footprint-segmentation`

### 🛠 Model Purpose
This model is part of the **[GeoAi](https://github.com/decision-labs/geoai.js)** javascript library.

**GeoAi** enables geospatial AI inference **directly in the browser or Node.js** without requiring a heavy backend.

**GeoAi** pipeline accepts **geospatial polygons** as input (in GeoJSON format) and outputs results as a **GeoJSON FeatureCollection**, ready for use with libraries like **Leaflet** and **Mapbox GL**.

<video controls autoplay loop width="1024" height="720" src="https://geobase-docs.s3.amazonaws.com/geobase-ai-assets/building-footprint-segmentation.mp4"></video>

---
### 🚀 Demo

Explore the model in action with the interactive [Demo](https://docs.geobase.app/geoai-live/tasks/building-footprint-segmentation).

### 📦 Model Information
- **Architecture**: U-Net–style Convolutional Neural Network (CNN)
- **Source Model**: [gunayk3/building_footprint_segmentation](https://huggingface.co/spaces/gunayk3/building_footprint_segmentation)
- **Quantization**: Yes
---

### 💡 Example Usage

```javascript
import { geoai } from "geoai";

// Example polygon (GeoJSON)
const polygon = {
  type: "Feature",
  properties: {},
  geometry: {
    coordinates: [
      [
        [-117.42351735397804, 47.659839523657155],
        [-117.42351735397804, 47.6533360375098],
        [-117.41165191515506, 47.6533360375098],
        [-117.41165191515506, 47.659839523657155],
        [-117.42351735397804, 47.659839523657155]
      ],
    ],
    type: "Polygon",
  },
} as GeoJSON.Feature;

// Initialize pipeline
const pipeline = await geoai.pipeline(
  [{ task: "building_footprint_segmentation" }],
  providerParams
);
 
// Run detection
const result = await pipeline.inference({
  inputs: { polygon }
});
 
// Sample output format
// {
//     "detections": {
//         "type": "FeatureCollection",
//         "features": [
//             {
//                 "type": "Feature",
//                 "properties": {
//                     "confidence": 0.8438083529472351
//                 },
//                 "geometry": {
//                     "type": "Polygon",
//                     "coordinates": [
//                        [
//                          [-117.41771164648438, 47.650790343749996],
//                          [-117.41766873046875, 47.650790343749996],
//                          [-117.41762581445313,47.650790343749996],
//                          ...
//                          [-117.41771164648438, 47.650790343749996]
//                        ]
//                     ]
//                 }
//             },
//             {"type": 'Feature', "properties": {…}, "geometry": {…}}, 
//             {"type": 'Feature', "properties": {…}, "geometry": {…}},
//         ]
//     },
//     "geoRawImage": GeoRawImage {data: Uint8ClampedArray(1048576), width: 512, height: 512, channels: 4, bounds: {…}, …}
// }

```
### 📖 Documentation & Demo

- GeoBase Docs: https://docs.geobase.app/geoai
- NPM Package: https://www.npmjs.com/package/geoai
- Demo Playground: https://docs.geobase.app/geoai-live/tasks/building-footprint-segmentation
- GitHub Repo: https://github.com/decision-labs/geoai.js