API DECI : importer les points d'eau incendie d'un SDIS

Ce que vos PEI deviennent dans l'application.

Un pompier ouvre la carte, il voit vos points d'eau. Il n'a rien à configurer : l'application télécharge les PEI du département quand il déplace la carte. Voici où ils servent.

Deux façons d'arriver sur la carte

Les départements déjà dans l'application.

Cette liste est lue en base à chaque affichage de la page. Elle compte les PEI actifs, ceux qui ont été retirés par un envoi ou une mise à jour ne sont plus comptés.

1. Seine-Maritime 76 21 274
2. Finistère 29 20 210
3. Ille-et-Vilaine 35 GeoBretagne 17 225
4. Calvados 14 data.calvados.fr 14 701
5. Pyrénées-Atlantiques 64 PIGMA 14 472
6. Charente-Maritime 17 Hydraclic 13 280
7. Vaucluse 84 Hydraclic 13 217
8. Saône-et-Loire 71 13 207
9. Côte-d'Or 21 11 883
10. Morbihan 56 11 632
11. Deux-Sèvres 79 11 535
12. Vienne 86 PIGMA 11 287
13. Côtes-d'Armor 22 10 828
14. Jura 39 7 969
15. Dordogne 24 PIGMA 7 200
16. Tarn 81 6 699
17. Charente 16 PIGMA 6 411
18. Haute-Loire 43 Ma carte IGN 6 105
19. Tarn-et-Garonne 82 4 762
20. Total 223 897

Le vôtre n'y est pas ? Demandez une clé, ou envoyez-moi l'adresse de votre jeu de données s'il est public. Un département ne peut avoir qu'une source : s'il est déjà alimenté depuis une plateforme publique et que vous préférez envoyer vous-même, dites-le dans la demande, je fais la bascule à la main.

Une clé par SDIS, qui ne sert qu'à ça.

1. Vous faites la demande. Le formulaire s'ouvre avec le module « DECI » déjà choisi et un message à compléter : nom du SDIS, département(s), e-mail technique, et l'adresse de vos données si elles sont déjà publiques.
2. Je crée la clé. Elle est rattachée à votre SDIS et ne porte qu'un droit, deci:import. Elle écrit dans une source réservée à votre service, jamais mélangée aux autres. Elle ne peut pas toucher aux PEI d'un autre SDIS.
3. Je vous la transmets. Elle a la forme kd_live_<12 caractères hexa>.<40 caractères hexa>. Je ne garde que l'empreinte du secret (SHA-256) : si vous la perdez, je ne peux pas la retrouver, j'en crée une autre.
4. Vous testez votre fichier ici, avec l'outil plus bas, avant le premier envoi.

Une clé qui a fuité se désactive côté serveur : elle est alors refusée avec un 401. Prévenez-moi et je vous en donne une nouvelle.

Un seul appel, tout le département.

POST https://kilodelta.fr/api/v1/deci/import
X-Api-Key: kd_live_<id>.<secret>
Content-Type: application/json

curl -X POST https://kilodelta.fr/api/v1/deci/import \
  -H "X-Api-Key: $KD_DECI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @peis.json

import os, requests

with open("peis.json", "rb") as f:
    body = f.read()   # octets UTF-8, tels quels

r = requests.post(
    "https://kilodelta.fr/api/v1/deci/import",
    data=body,
    headers={"X-Api-Key": os.environ["KD_DECI_KEY"],
             "Content-Type": "application/json"},
    timeout=300,
)
print(r.status_code, r.json())

Ce qu'il faut savoir avant d'appuyer sur Entrée

Il n'y a pas de limite de débit sur cet endpoint et le traitement est synchrone : la réponse arrive quand tout est écrit. Prévoyez un délai d'attente large côté client. Pour le premier envoi d'un gros catalogue, prévenez-moi, je regarde passer l'import.

Un objet par PEI, à plat.

Le corps est un objet JSON avec un tableau peis. Un tableau seul à la racine ([ {…}, {…} ]) est aussi accepté. À la racine, code_dept est facultatif : s'il manque, le département est déduit des deux premiers caractères du commune_code du premier PEI valide.

Corse et outre-mer : renseignez toujours code_dept. La déduction sur deux caractères donne bien 2A ou 2B, mais 97 pour un code INSEE en 971 ou 974.

Les nombres peuvent être envoyés en texte ("60"), ils sont lus pareil. Les champs en trop sont ignorés. Le type et l'état ne tiennent pas compte de la casse ni des espaces autour.

Les 9 types d'ouvrage

La clé de mise à jour

D'un envoi à l'autre, un PEI est reconnu par son id si vous le fournissez, sinon par une empreinte calculée sur ref. Choisissez une règle et gardez-la : passer de l'une à l'autre fait retirer puis recréer tout le catalogue. Si votre SIG a un identifiant entier stable, donnez-le dans id. Sur un gros catalogue, c'est plus sûr que l'empreinte, qui peut exceptionnellement tomber deux fois sur la même valeur. L'outil de test plus bas signale ces doublons.

Un PEI retiré puis renvoyé plus tard revient avec le même identifiant côté KiloDelta.

Trois PEI, trois cas.

Un poteau complet, une bouche en emploi restreint sans débit connu, une citerne privée. Les valeurs sont inventées pour l'exemple.

{
  "code_dept": "26",
  "peis": [
    {
      "ref": "26362-0147",
      "id": 90147,
      "commune_code": "26362",
      "commune_nom": "Valence",
      "lat": 44.933412,
      "lon": 4.892307,
      "type": "poteau",
      "etat": "disponible",
      "debit_1bar": 72,
      "pression": 1.4,
      "pression_statique": 4.2,
      "adresse": "Avenue Victor Hugo",
      "domaine": "public"
    },
    {
      "ref": "26362-0588",
      "id": 90588,
      "commune_code": "26362",
      "commune_nom": "Valence",
      "lat": 44.915871,
      "lon": 4.921654,
      "type": "bouche",
      "etat": "emploi_restreint",
      "adresse": "Rue Faventines",
      "domaine": "public"
    },
    {
      "ref": "26362-R012",
      "id": 91012,
      "commune_code": "26362",
      "commune_nom": "Valence",
      "lat": 44.94712,
      "lon": 4.905581,
      "type": "citerne",
      "etat": "disponible",
      "volume_pa": 120,
      "domaine": "privé"
    }
  ]
}

Depuis un export GeoJSON

L'endpoint ne prend pas de GeoJSON directement. Si votre SIG exporte une FeatureCollection de points en EPSG:4326, une ligne de jq fait la conversion. Adaptez les noms de propriétés à votre export.

jq '{code_dept: "26", peis: [.features[] | {
      ref:        .properties.numero,
      commune_code: .properties.insee,
      lat:        .geometry.coordinates[1],
      lon:        .geometry.coordinates[0],
      type:       .properties.type_kd,
      etat:       .properties.etat_kd,
      debit_1bar: .properties.debit
    }]}' export.geojson > peis.json

Dans un GeoJSON, l'ordre est longitude puis latitude. Les valeurs de type et d'etat doivent être celles des listes ci-dessus : si votre base utilise des codes (PI, BI, PA…), faites la correspondance dans votre requête d'export.

Voyez le résultat avant d'envoyer.

Déposez votre fichier ou collez son contenu. L'outil applique les mêmes règles que le serveur et vous montre ce qui serait retenu, ignoré, et comment vos PEI s'afficheraient. Rien ne quitte votre navigateur : aucune requête n'est faite, aucune clé n'est demandée.

Un compte rendu, pas un simple « OK ».

Un envoi accepté répond 200 avec le bilan de l'import. Par exemple, pour un deuxième envoi :

{
  "ok": true,
  "source_id": 57,
  "code_dept": "26",
  "received": 4812,
  "added": 6,
  "updated": 4801,
  "removed": 3,
  "skipped": 5,
  "reasons": {
    "bad_coords": 2,
    "unknown_type": 3
  },
  "unknown_types": [
    "hydrant_prive"
  ],
  "unknown_etats": []
}

Les raisons possibles

Un etat inconnu n'écarte pas le PEI : il est enregistré indisponible et la valeur apparaît dans unknown_etats.

Comment vos champs deviennent une couleur.

En intervention, le pompier doit lire en une seconde s'il peut engager un PEI. La couleur de la bordure vient de l'état, puis du débit (ou du volume pour les ressources statiques). L'emploi restreint est traité comme disponible pour la couleur, la restriction est affichée dans la fiche. Ce que voit le pompier, forme par forme et zoom par zoom, est détaillé sur la page Carte des points d'eau incendie (PEI).

Le bleu n'est pas un défaut. Un PEI disponible sans débit s'affiche en bleu, « disponible, débit non renseigné ». Pas en jaune : je ne veux pas faire croire à un débit faible quand il est seulement inconnu. Pour les calculs, le débit est alors estimé à la médiane.

Essayez

Au zoom fort, un capuchon indique le réseau (NF S 62-200) : rouge sous pression permanente, bleu non pressurisé (citernes, points d'aspiration, PENA, colonnes), jaune quand la pression statique atteint 8 bar (à défaut, la pression dynamique).

Les codes que vous pouvez recevoir.

Les erreurs 401, 403 et 422 ont toutes la même forme :

{
  "status": 403,
  "error": 403,
  "messages": {
    "error": "Cette clé n'a pas le droit deci:import."
  }
}

Relire ce que l'application reçoit.

Ce sont les endpoints que l'application appelle. Ils sont publics, sans clé. Remplacez 26 par votre département.

curl "https://kilodelta.fr/api/v1/deci/manifest?depts=26"

{
  "items": [
    {
      "dept": "26",
      "count": 4807,
      "updated_at": "2026-09-30 06:12:41",
      "version": "3f9a1c2e"
    }
  ]
}

count doit correspondre à added + updated de votre dernier envoi. version change à chaque envoi : c'est elle qui dit aux téléphones de retélécharger.

curl "https://kilodelta.fr/api/v1/deci/positions?dept=26"

// chaque ligne : [id KiloDelta, lat, lon, type_code, color_code, cap_code]
{ "v": "3f9a1c2e", "dept": "26", "peis": [ [418233, 44.933412, 4.892307, 0, 4, 0], … ] }

curl "https://kilodelta.fr/api/v1/deci/peis/418233"

La fiche renvoie tout ce que le pompier voit au tap. Votre ref y figure sous le nom external_k, votre adresse sous street_address, avec etat_label, type_label et le color_code calculé.

Ces réponses sont mises en cache (5 minutes pour manifest, plus longtemps pour les positions et les fiches, avec un ETag). Un curl direct voit tout de suite la nouvelle version. La carte en haut de cette page compte vos PEI dès le rechargement.

Ce qu'on me demande.