Historique Parcelle — Plugin QGIS
===================================

Géolocaliser les parcelles disparues du cadastre français directement dans QGIS.

Version : 2.0
Site     : https://www.historiqueparcelle.fr
Auteur   : HistoriqueParcelle.fr — contact@historiqueparcelle.fr
Licence  : GPL v2+
GitHub   : https://github.com/romain974/qgis_historiqueparcelle

---

Fonctionnalités
----------------

- Recherche de l'historique des mutations via l'API V3 de historiqueparcelle.fr
- Géolocalisation automatique des parcelles descendantes sur le cadastre actuel (IGN)
- Algorithme DFS descendant : seules les filles / petites-filles sont cartographiées (pas les sœurs)
- Deux sorties :
    - Parcelles géolocalisées : couche polygonale (MultiPolygon, EPSG:4326)
    - Parcelles non géolocalisées : table attributaire (ID, raison, détail des mutations)
- Limite de 500 lignes par recherche

Prérequis
---------

- QGIS ≥ 3.0
- Clé API historiqueparcelle.fr (obtenue sur https://www.historiqueparcelle.fr/membre/acheter)
- Python packages : shapely (généralement inclus dans les installations QGIS)

Installation
------------

Copier le dossier qgis_historiqueparcelle dans le répertoire plugins de QGIS :

  Windows : %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\
  Linux   : ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
  macOS   : ~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/

Puis redémarrer QGIS et activer dans Extension → Gestionnaire d'extensions.

Utilisation
-----------

1. Ouvrir la boîte à outils de traitements (Ctrl+Alt+T)
2. Chercher « Historique Parcelle » dans historiqueparcelle.fr
3. Paramétrer :
   - Couche : vecteur avec identifiants parcelles (14 car.)
   - Champ  : colonne contenant les identifiants
   - Clé API : votre clé historiqueparcelle.fr

Format des identifiants
-----------------------

Les identifiants parcelle font 14 caractères : CCCCCPPPSSNNNN

  CCCCC (5) : Code INSEE de la commune
  PPP   (3) : Préfixe de section (000 si absent)
  SS    (2) : Section cadastrale (ex: AB, A1)
  NNNN  (4) : Numéro de parcelle

Sorties
-------

Parcelles géolocalisées :
  Couche MultiPolygon EPSG:4326 contenant les parcelles descendantes retrouvées
  sur le cadastre actuel, avec les attributs d'origine.

Parcelles non géolocalisées :
  Table attributaire avec :
    parcelle_id — Identifiant recherché
    raison       — Motif du non-retrouvement
    mutations    — Détail des mutations historiques

Changelog
---------

v2.0
  - Migration API V3 (Cloud Run PBF)
  - Algorithme DFS descendant (filles/petites-filles uniquement)
  - Table QGIS pour les non-géolocalisées (remplace CSV)
  - Limite 500 lignes par recherche
  - Documentation mise à jour

v0.1
  - Version initiale

Support
-------

Contact : contact@historiqueparcelle.fr
Bugs    : https://github.com/romain974/qgis_historiqueparcelle/issues
Doc     : https://www.historiqueparcelle.fr
