---
title: "Utilisation de l'API AI Search : Détection des murs, portes, fenêtres et pièces"
description: "L'API AI Search détecte et mesure automatiquement les éléments de construction sur vos dessins 2D. Au lieu de tracer manuellement les éléments, vous téléchargez un plan d'étage et demandez à l'IA de détecter ce dont vous avez besoin — l'API retourne une géométrie structurée avec des mesures réelles."
url: https://help-takeoff.kreo.net/fr/articles/11688711-utilisation-de-l-api-ai-search-detection-des-murs-portes-fenetres-et-pieces
collection: "API"
updated: 2026-11-15
language: fr
alternates: [en]
---

# Utilisation de l'API AI Search : Détection des murs, portes, fenêtres et pièces

L'API AI Search détecte et mesure automatiquement les éléments de construction sur vos dessins 2D. Au lieu de tracer manuellement les éléments, vous téléchargez un plan d'étage et demandez à l'IA de détecter ce dont vous avez besoin — l'API retourne une géométrie structurée avec des mesures réelles.

## Ce que l'IA peut détecter

**Éléments linéaires** — renvoyés sous forme de segments de ligne avec un point de départ, un point d'arrivée, une longueur et une épaisseur :

-   Murs (y compris les murs intérieurs et extérieurs)
    
-   Portes
    
-   Fenêtres
    

**Éléments surfaciques** — renvoyés sous forme de polygones avec des points de contour, une surface, un périmètre et tout texte trouvé à l'intérieur de la région :

-   Pièces, couloirs et autres espaces fermés
    
-   Zones nommées personnalisées, telles que GIA (Surface Interne Brute) ou GEA (Surface Externe Brute), trouvées en recherchant des étiquettes de texte sur le dessin
    

Toutes les mesures sont converties en unités réelles en fonction de l'échelle que vous avez définie pour le projet, ainsi que les coordonnées en pixels relatives au fichier source.

## Le flux de travail

Chaque recherche IA suit les mêmes quatre étapes. L'URL de base est `https://takeoff.kreo.net/api/ai-search/v1/takeoff2D`, et toutes les demandes nécessitent votre clé API dans l'en-tête `X-API-KEY`.

### 1\. Télécharger votre fichier

`POST /upload` avec le fichier en tant que données de formulaire multipart. Formats pris en charge : PDF, CAO (DWG, DXF, DWF, DGN) et images (PNG, TIFF, JPG, JPEG, BMP, EMF, GIF). La réponse est une clé de fichier temporaire `fileKey` que vous utiliserez à l'étape suivante.

### 2\. Créer un projet

`POST /project` avec la clé `fileKey`. Un projet représente l'analyse d'une **seule page de dessin** — pour les documents multi-pages, spécifiez la page à utiliser avec `pageIndex` (basé sur zéro, par défaut 0) et créez un projet distinct pour chaque page que vous souhaitez analyser.

Vous pouvez définir l'échelle du dessin immédiatement. Pour un dessin à l'échelle 1:100 :

json

```json
{
  "fileKey": "your-file-key",
  "pageIndex": 0,
  "scale": {
    "drawingCalibrationLineLength": 1,
    "originalCalibrationLineLength": 100
  }
}
```

Si le statut du projet revient comme `Calculating` (courant pour les fichiers CAO qui nécessitent une conversion), interrogez `GET /projects/{projectId}/status` jusqu'à ce qu'il soit `Ready`. Vous pouvez également définir ou mettre à jour l'échelle ultérieurement avec `PUT /projects/{projectId}/scale` — mais uniquement lorsque le statut du projet est `Ready`.

### 3\. Exécuter une recherche

`POST /projects/{projectId}/search` lance une tâche de recherche asynchrone :

json

```json
{
  "dpi": 300,
  "type": "wall"
}
```

Paramètres :

-   `type` _(required)_ — what to look for: `wall`, `door`, `window`, `space` (rooms and enclosed areas), or `polygon` (find an area by its text label).
    
-   `dpi` _(required)_ — search resolution: `150`, `300`, `450`, or `600`. Default is `300`. Higher DPI can improve detection on dense drawings but takes longer.
    
-   `text` — required when `type` is `polygon`: the text label to search for, e.g. `"GEA"` for gross external area. Must be omitted for other types.
    
-   `includeWalls` — only for `type: space`: extends space areas to wall center lines.
    
-   `cropBox` — an optional `[x1, y1, x2, y2]` rectangle to limit the search to part of the drawing.
    

La réponse contient un `jobId`.

### 4\. Obtenir les résultats

`GET /projects/{projectId}/search/{jobId}` — interrogez jusqu'à ce que le `status` soit `Ready`. Vous pouvez filtrer les résultats par confiance IA avec le paramètre de requête optionnel `confidence` (une valeur entre 0 et 1).

**Les résultats linéaires** (murs, portes, fenêtres) sont retournés sous forme de `lines`:

json

```json
{
  "status": "Ready",
  "lines": [
    {
      "p1": [1715.523, 218.374],
      "p2": [1667.250, 525.628],
      "length": 15.6,
      "thickness": 0.25
    }
  ]
}
```

`p1` et `p2` sont les extrémités de la ligne médiane en pixels ; `length` et `thickness` sont en mètres.

**Les résultats surfaciques** (espaces et polygones) sont retournés sous forme de `contours`:

json

```json
{
  "status": "Ready",
  "contours": [
    {
      "points": [[1127.16, 812.88], [1127.16, 704.4], [1031.88, 704.4], [1031.88, 812.88]],
      "text": ["DblBedroom", "13.0m²"],
      "area": 12.86,
      "perimeter": 14.38
    }
  ]
}
```

`points` sont les sommets du polygone en pixels, `area` est en mètres carrés, `perimeter` est en mètres, et `text` contient les étiquettes trouvées par l'IA à l'intérieur de la région — utile pour faire correspondre les résultats aux noms de pièces du plan. Si un contour comporte des trous, la surface les exclut et le périmètre les inclut.

## Conseils

-   **Définissez l'échelle avant de rechercher.** Sans une échelle correcte, les longueurs et les surfaces ne correspondront pas aux dimensions du monde réel.
    
-   **Un projet = une page.** Créez un projet par page pour les PDF multi-pages.
    
-   **Utilisez** `cropBox` pour accélérer les recherches et éviter le bruit lorsque vous n'avez besoin que d'une partie d'une grande feuille.
    
-   **Besoin du dessin converti ?** Pour les projets créés à partir d'images ou de fichiers CAO, `GET /projects/{projectId}/pdf` télécharge le projet en tant que PDF.
    

## Référence complète

Les schémas détaillés et les exemples de résultats pour chaque type d'élément sont disponibles dans notre portail développeur : [Walls](https://kreo-software.readme.io/reference/walls), [Doors](https://kreo-software.readme.io/reference/doors), [Windows](https://kreo-software.readme.io/reference/windows), [Rooms and Areas](https://kreo-software.readme.io/reference/rooms-and-areas), et [GIA](https://kreo-software.readme.io/reference/gia).

Des questions ? Contactez-nous à [**info@kreo.net**](mailto:info@kreo.net) ou via le chat intégré à l'application.

## Related

- [Prise en main de l'API Kreo](https://help-takeoff.kreo.net/fr/articles/11688710-prise-en-main-de-l-api-kreo.md)
- [Utilisation de l'API Core Platform : Projets, Mesures et Export PDF](https://help-takeoff.kreo.net/fr/articles/11688712-utilisation-de-l-api-core-platform-projets-mesures-et-export-pdf.md)
- [API Kreo : FAQ et dépannage](https://help-takeoff.kreo.net/fr/articles/11688713-api-kreo-faq-et-depannage.md)
- [Kreo Software & Contractor Foreman Intégration](https://help-takeoff.kreo.net/fr/articles/6600742-kreo-software-and-contractor-foreman-integration.md)
