> For the complete documentation index, see [llms.txt](https://docs.mindee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindee.com/v2/fr/modeles-extraction/optional-features/polygons-bounding-boxes.md).

# Polygones (boîtes englobantes)

<figure><img src="/files/ed914926e58de2c3ac1c0d98e8cc32de8524c950" alt="bounding-box polygons displayed in the Live Interface" width="375"><figcaption></figcaption></figure>

## Aperçu

Le **polygones** option, également communément appelée **boîtes englobantes**, est une fonctionnalité que vous pouvez activer dans vos Models.\
Elle indique la zone polygonale précise sur le document où la valeur de chaque champ extrait a été détectée.

* Ces polygones définissent **l'emplacement exact sur le document** contenant les données extraites.
* Ils permettent une vérification visuelle en mettant en évidence l'endroit où le modèle a trouvé chaque valeur sur le document.
* Cette fonctionnalité est particulièrement utile pour créer des interfaces utilisateur qui superposent les données extraites sur les images de documents à des fins de validation ou de révision.

## Fonctionnement <a href="#how-it-works" id="how-it-works"></a>

* Un polygone (boîte englobante) est un tableau de points décrivant une forme fermée autour de la zone de données détectée.
* Les points sont donnés sous forme de coordonnées normalisées par rapport aux dimensions de la page du document :
  * Chaque coordonnée est un nombre à virgule flottante compris entre `0` et `1`.
  * `(0, 0)` correspond au coin supérieur gauche ; `(1, 1)` correspond au coin inférieur droit.
* Plusieurs polygones peuvent être renvoyés s'il existe plusieurs champs extraits ou zones de données.

## **Activer les polygones**

### Activer les polygones sur la plateforme

Lorsque vous définissez l'état d'activation d'une fonctionnalité sur la Plateforme, ce sera la valeur par défaut.\
Tous les appels API utiliseront l'état par défaut, sauf indication contraire explicite lors de l'appel API.

Cela est utile pour les chefs de projet, car cela permet d'activer ou de désactiver une fonctionnalité dans tous les appels API sur ce modèle.

Toute personne disposant d'un accès en écriture au modèle peut définir la valeur par défaut de l'option.

{% @supademo/embed url="<https://app.supademo.com/demo/cmeidsob99f8xh3pybta14v42>" demoId="cmeidsob99f8xh3pybta14v42" %}

### Activer les polygones via des appels API

Si vous avez besoin d’un contrôle plus granulaire sur le moment où la fonctionnalité est utilisée, vous pouvez l’activer ou la désactiver lors de l’exécution d’appels API.

Cela permet de définir dynamiquement l’état d’activation à l’aide de votre logique métier interne ou propre à votre domaine.

Vérifiez le [Configuration du client](/v2/fr/integrations/client-libraries-sdk/configure-the-client.md#optional-features-configuration) section si vous utilisez notre [Bibliothèques clientes / SDK](/v2/fr/integrations/client-libraries-sdk.md).

## Utiliser le résultat des polygones <a href="#example-polygon-bounding-box-data" id="example-polygon-bounding-box-data"></a>

Nous vous recommandons vivement d’utiliser nos [Bibliothèques clientes / SDK](/v2/fr/integrations/client-libraries-sdk.md), car ils incluent diverses fonctions géométriques pour faciliter le traitement.

Pour la gestion des polygones, consultez plus précisément le [Résultat d'extraction](/v2/fr/modeles-extraction/sdk-integration/extraction-result.md#locations) section.

Sinon, consultez le [Intégration manuelle](/v2/fr/integrations/api-reference.md#get-v2-inferences-inference_id) section.

## Quelques cas d'utilisation <a href="#use-cases" id="use-cases"></a>

* Validation visuelle en superposant des boîtes englobantes sur les aperçus de documents afin que les utilisateurs puissent confirmer la précision de l'extraction.
* Débogage de la qualité de l'extraction en analysant les régions détectées.
* Amélioration de l'interface utilisateur avec des champs mis en évidence pour une meilleure expérience utilisateur.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mindee.com/v2/fr/modeles-extraction/optional-features/polygons-bounding-boxes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
