@ignfab/geocontext 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2024 Mickaël Borne <https://github.com/mborne>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,195 @@
+# geocontext
+
+Un serveur MCP expérimental fournissant du contexte spatial pour les LLM.
+
+## Motivation
+
+Les LLM renforcent l'idée que la magie est possible avec l'informatique. Il n'en est rien. Pour qu'un assistant soit en mesure de connaître la date et l'heure, il faut par exemple l'interfacer avec un [MCP time](https://mcpservers.org/servers/modelcontextprotocol/time). De même, pour qu'il soit en mesure de lire une page, il faut par exemple l'interfacer un [MCP fetch](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch#readme).
+
+En matière de données géographique, si un utilisateur pose une question impliquant que l'assistant soit en mesure de [connaître la position d'une adresse, il y a de bonne chance que la réponse soit plausible mais fausse](https://github.com/mborne/llm-experimentations/tree/main/chatgpt-geocodage-limites#readme).
+
+S'il est techniquement possible de brancher des API REST/GeoJSON telle APICARTO, la conception de ces dernières n'est pas adaptée (5000 résultat par défaut, grosse géométrie dans les réponses, géométries complexes à fournir,...).
+
+L'idée est ici d'**expérimenter la conception d'un MCP rendant les données et les services de la Géoplateforme accessibles par un LLM**.
+
+## Mises en garde
+
+- Ce développement est un POC en incubation avec IgnFab (migration en cours de `mborne/geocontext` en `ignfab/geocontext`)
+- S'il s'avère utile de l'industrialiser, le dépôt sera migré sous responsabilité IGN et l'outil sera renommé (ex : `IGNF/mcp-gpf-server`)
+- Plusieurs problèmes et améliorations possibles ont été identifiés et sont en cours de mitigation/résolution (c.f. [issues](https://github.com/ignfab/geocontext/issues?q=is%3Aissue%20state%3Aopen%20label%3Ametadata)).
+- Cet outil n'est pas magique (voir [Fonctionnalités](#fonctionnalités) pour avoir une idée de ses capacités)
+
+## Principes de conception
+
+- **Ne pas copier les données de la Géoplateforme** (but : identifier les améliorations possibles sur le services plutôt que les doublonner)
+- **Limiter au maximum la taille des réponses** (but : optimiser le nombre de jeton / éviter les hallucinations / pouvoir utiliser des modèles locaux)
+- ...
+
+## Utilisation
+
+### Utilisation de la version publiée
+
+Par exemple, avec "Cursor Settings / MCP / Add server" :
+
+```json
+{
+  "mcpServers": {
+    "geocontext": {
+      "command": "npx",
+      "args": ["-y", "@ignfab/geocontext"]
+    }
+  }
+}
+```
+
+### Utilisation avec Docker
+
+```bash
+docker compose build
+docker compose up -d
+```
+
+Ensuite :
+
+```json
+{
+  "mcpServers": {
+    "geocontext": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+```
+
+## Développement
+
+### Construction de la version locale
+
+```bash
+git clone https://github.com/ignfab/geocontext
+cd geocontext
+npm install
+npm run build
+```
+
+### Utilisation de la version locale
+
+```json
+{
+  "mcpServers": {
+    "mcp-helloworld": {
+      "command": "node",
+      "args":["/chemin/absolu/vers/geocontext/dist/index.js"]
+    }
+  }
+}
+```
+
+### Debug de la version locale
+
+```bash
+npx -y @modelcontextprotocol/inspector node dist/index.js
+```
+
+## Paramétrage
+
+Pour une utilisation avancée :
+
+| Nom              | Description                                                                                                          | Valeur par défaut |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------- |
+| `TRANSPORT_TYPE` | [Transport](https://mcp-framework.com/docs/Transports/transports-overview) permet de choisir entre "stdio" et "http" | "stdio"           |
+
+## Fonctionnalités
+
+### Utiliser des services spatiaux
+
+Quelques services de la Géoplateforme :
+
+* [geocode(text)](src/tools/GeocodeTool.ts) s'appuie sur le [service d’autocomplétion de la Géoplateforme](https://geoservices.ign.fr/documentation/services/services-geoplateforme/autocompletion) pour **convertir un nom de lieu en position (lon,lat)**.
+
+> Ex : Quelle est la position (lon,lat) de la mairie de Vincennes?
+
+* [altitude(lon,lat)](src/tools/AltitudeTool.ts) s'appuie sur le [service de calcul altimétrique de la Géoplateforme](https://geoservices.ign.fr/documentation/services/services-geoplateforme/altimetrie) pour **convertir une position en altitude**. 
+
+> Ex : Quelle est l'altitude de la mairie de Loray (25)?
+
+### Recherche d'informations pour un lieu
+
+L'idée est ici de répondre à des précises en traitant côté serveur les appels aux services WFS de la Géoplateforme :
+
+* [adminexpress(lon,lat)](src/tools/AdminexpressTool.ts) permet de **récupérer les informations administratives (commune, département, région,...)** pour un lieu donné par sa position.
+
+> Ex : Quelles sont les informations administrative pour la mairie de Vincennes?
+
+* [cadastre(lon,lat)](src/tools/CadastreTool.ts) permet de **récupérer les informations cadastrales (parcelle, feuille,...)**.
+
+> Ex : Quelles sont les informations du cadastre pour la mairie de Vincennes?
+
+* [urbanisme(lon,lat)](src/tools/UrbanismeTool.ts) permet de **récupérer les informations d'urbanisme (PLU,POS,CC,PSMV)**
+
+> Ex : Quel est le document PLU en vigueur pour le port de Marseille?
+
+* [assiette_sup(lon,lat)](src/tools/AssietteSupTool.ts) permet de **récupérer les Servitude d'Utilité Publiques (SUP)**
+
+### Explorer les données vecteurs
+
+#### Explorer les tables
+
+* [gpf_wfs_list_types()](src/tools/GpfWfsListTypesTool.ts) pour **lister les tables disponibles sur le WFS de la Géoplateforme** ([GetCapabilities](https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities)) - **déprécié (trop de résultats)** 
+* [gpf_wfs_search_types(keywords,max_results=10)](src/tools/GpfSearchFeatureTypes.ts) pour **rechercher les tables disponibles sur le WFS de la Géoplateforme** ([GetCapabilities](https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities))
+
+> - Quels sont les millésimes ADMINEXPRESS disponibles sur la Géoplateforme?
+> - Quelle est la table de la BDTOPO correspondant aux bâtiments?
+> - Dans quelle table de la BDTOPO peut-on trouver les ponts?
+
+#### Explorer la structure des tables
+
+* [gpf_wfs_describe_type(typename)](src/tools/GpfWfsDescribeTypeTool.ts) pour récupérer le **schéma d'une table** ([DescribeFeatureType](https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=DescribeFeatureType&typename=ADMINEXPRESS-COG.LATEST:commune&outputFormat=application/json))
+
+> - Quelles sont les informations disponibles pour les communes avec ADMINEXPRESS-COG.LATEST?
+> - Compare le modèle des communes entre ADMINEXPRESS-COG:2024 et ADMINEXPRESS-COG.LATEST
+
+#### Explorer les données des tables
+
+* [gpf_wfs_get_features(typename,...)](src/tools/GpfWfsGetFeaturesTool.ts) pour **récupérer les données d'une table** ([GetFeature](https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetFeature&typename=ADMINEXPRESS-COG.LATEST:commune&outputFormat=application/json&count=1))
+
+> - Quelles sont les 5 communes les plus peuplées du Doubs (25)?
+> - Combien y-a-t'il de bâtiments à moins de 5 km de la tour Eiffel?
+
+## Contribution
+
+### Problèmes et demandes d'évolutions
+
+N'hésitez pas à [créer une issue](https://github.com/ignfab/geocontext/issues) si vous rencontrez un problème! Merci de fournir :
+
+- L'assistant et le modèle utilisé
+- La demande que vous faite à l'assistant (ex : "Combien y a-t'il de pont franchissant la seine?")
+
+### Proposer une nouvelle fonctionnalité
+
+N'hésitez pas :
+
+- Forker le dépôt
+- Créer un nouveau tool
+- Tester de votre côté
+- Faire une pull-request
+
+
+
+## Crédits
+
+* [mcp-framework](https://mcp-framework.com) fournit le **cadre de développement du MCP** :
+
+```bash
+# Par exemple, pour exposer la liste des couches WMTS
+mcp add tool gpf_wmts_layers
+```
+
+* [@camptocamp/ogc-client](https://camptocamp.github.io/ogc-client/#/) pour la **lecture des réponses XML des services WFS, WMTS,...**
+* [MiniSearch](https://github.com/lucaong/minisearch) pour la **recherche par mot clé**.
+* [jsts](https://bjornharrtell.github.io/jsts/) pour les **traitements géométriques** (ex : tri des réponses par distance au point recherché).
+
+## Licence
+
+[MIT](LICENSE)
+

package/dist/gpf/adminexpress.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get administrative units (commune, departement,...) intersecting a given location
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns {object[]}
+ */
+export function getAdminUnits(lon: number, lat: number): object[];
+/**
+ * ADMINEXPRESS-COG.LATEST:{type}
+ *
+ * https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities
+ */
+export const ADMINEXPRESS_SOURCE: "G\u00E9oplateforme (WFS, ADMINEXPRESS-COG.LATEST)";
+export const ADMINEXPRESS_TYPES: string[];

package/dist/gpf/adminexpress.js

@@ -0,0 +1,50 @@
+import { fetchJSON } from '../helpers/http.js';
+import logger from '../logger.js';
+import _ from 'lodash';
+/**
+ * ADMINEXPRESS-COG.LATEST:{type}
+ *
+ * https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities
+ */
+export const ADMINEXPRESS_SOURCE = "Géoplateforme (WFS, ADMINEXPRESS-COG.LATEST)";
+export const ADMINEXPRESS_TYPES = [
+    'commune',
+    'canton',
+    'collectivite_territoriale',
+    'epci',
+    'departement',
+    'region',
+    'arrondissement'
+];
+/**
+ * Get administrative units (commune, departement,...) intersecting a given location
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns {object[]}
+ */
+export async function getAdminUnits(lon, lat) {
+    logger.info(`[adminexpress] getAdminUnits(${lon},${lat})...`);
+    // note that EPSG:4326 means lat,lon order for GeoServer -> flipped coordinates...
+    const cql_filter = `INTERSECTS(geometrie,Point(${lat} ${lon}))`;
+    // TODO : avoid useless geometry retrieval at WFS level
+    const url = 'https://data.geopf.fr/wfs?' + new URLSearchParams({
+        service: 'WFS',
+        request: 'GetFeature',
+        typeName: ADMINEXPRESS_TYPES.map((type) => { return `ADMINEXPRESS-COG.LATEST:${type}`; }).join(','),
+        outputFormat: 'application/json',
+        cql_filter: cql_filter
+    }).toString();
+    const featureCollection = await fetchJSON(url);
+    return featureCollection.features.map((feature) => {
+        // parse type from id (ex: "commune.3837")
+        const type = feature.id.split('.')[0];
+        // ignore geometry and extend properties
+        return Object.assign({
+            type: type,
+            id: feature.id,
+            bbox: feature.bbox
+        }, feature.properties);
+    });
+}
+//# sourceMappingURL=adminexpress.js.map

package/dist/gpf/adminexpress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adminexpress.js","sourceRoot":"","sources":["../../src/gpf/adminexpress.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,8CAA8C,CAAC;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,SAAS;IACT,QAAQ;IACR,2BAA2B;IAC3B,MAAM;IACN,aAAa;IACb,QAAQ;IACR,gBAAgB;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAG,EAAE,GAAG;IACxC,MAAM,CAAC,IAAI,CAAC,gCAAgC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC;IAE9D,kFAAkF;IAClF,MAAM,UAAU,GAAG,8BAA8B,GAAG,IAAI,GAAG,IAAI,CAAC;IAEhE,uDAAuD;IACvD,MAAM,GAAG,GAAG,4BAA4B,GAAG,IAAI,eAAe,CAAC;QAC3D,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,2BAA2B,IAAI,EAAE,CAAA,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAClG,YAAY,EAAE,kBAAkB;QAChC,UAAU,EAAE,UAAU;KACzB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEd,MAAM,iBAAiB,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9C,0CAA0C;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,wCAAwC;QACxC,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;SACrB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/gpf/altitude.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Get altitude for a given location.
+ *
+ * @see https://geoservices.ign.fr/documentation/services/services-deprecies/calcul-altimetrique-rest#1872
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export function getAltitudeByLocation(lon: number, lat: number): Promise<{
+    lon: number;
+    lat: number;
+    altitude: any;
+    accuracy: any;
+}>;
+export const ALTITUDE_SOURCE: "G\u00E9oplateforme (altim\u00E9trie)";

package/dist/gpf/altitude.js

@@ -0,0 +1,35 @@
+import logger from "../logger.js";
+import { fetchJSON } from "../helpers/http.js";
+export const ALTITUDE_SOURCE = "Géoplateforme (altimétrie)";
+/**
+ * Get altitude for a given location.
+ *
+ * @see https://geoservices.ign.fr/documentation/services/services-deprecies/calcul-altimetrique-rest#1872
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export async function getAltitudeByLocation(lon, lat) {
+    logger.info(`getAltitudeByLocation(${lon},${lat})...`);
+    const url = `https://data.geopf.fr/altimetrie/1.0/calcul/alti/rest/elevation.json?lon=${lon}&lat=${lat}&resource=ign_rge_alti_wld`;
+    try {
+        const json = await fetchJSON(url);
+        const elevation = json.elevations[0];
+        return {
+            lon: lon,
+            lat: lat,
+            altitude: elevation.z,
+            accuracy: elevation.acc,
+        };
+    }
+    catch (e) {
+        return {
+            lon: lon,
+            lat: lat,
+            altitude: null,
+            accuracy: 'No data',
+        };
+    }
+}
+//# sourceMappingURL=altitude.js.map

package/dist/gpf/altitude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"altitude.js","sourceRoot":"","sources":["../../src/gpf/altitude.js"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAG,EAAE,GAAG;IAChD,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC;IAEvD,MAAM,GAAG,GAAG,4EAA4E,GAAG,QAAQ,GAAG,4BAA4B,CAAC;IACnI,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAE;QACtC,OAAO;YACH,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,GAAG;YACR,QAAQ,EAAE,SAAS,CAAC,CAAC;YACrB,QAAQ,EAAE,SAAS,CAAC,GAAG;SAC1B,CAAC;IACN,CAAC;IAAA,OAAM,CAAC,EAAC,CAAC;QACN,OAAO;YACH,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,GAAG;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,SAAS;SACtB,CAAC;IACN,CAAC;AAGL,CAAC"}

package/dist/gpf/geocode.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get coordinates for a given location
+ *
+ * @see https://geoservices.ign.fr/documentation/services/services-geoplateforme/autocompletion
+ *
+ * @param {string} text
+ * @returns
+ */
+export function geocode(text: string): Promise<any>;
+export const GEOCODE_SOURCE: "G\u00E9oplateforme (service d'autocompl\u00E9tion)";

package/dist/gpf/geocode.js

@@ -0,0 +1,27 @@
+import logger from "../logger.js";
+import { fetchJSON } from "../helpers/http.js";
+export const GEOCODE_SOURCE = "Géoplateforme (service d'autocomplétion)";
+/**
+ * Get coordinates for a given location
+ *
+ * @see https://geoservices.ign.fr/documentation/services/services-geoplateforme/autocompletion
+ *
+ * @param {string} text
+ * @returns
+ */
+export async function geocode(text) {
+    logger.info(`geocode(${JSON.stringify(text)})...`);
+    const url = 'https://data.geopf.fr/geocodage/completion/?' + new URLSearchParams({
+        text: text,
+        maximumResponses: 3
+    }).toString();
+    const json = await fetchJSON(url);
+    return json.results.map((item) => {
+        return {
+            lon: item.x,
+            lat: item.y,
+            fulltext: item.fulltext
+        };
+    });
+}
+//# sourceMappingURL=geocode.js.map

package/dist/gpf/geocode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocode.js","sourceRoot":"","sources":["../../src/gpf/geocode.js"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,0CAA0C,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAI;IAC9B,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnD,MAAM,GAAG,GAAG,8CAA8C,GAAG,IAAI,eAAe,CAAC;QAC/E,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,CAAC;KACpB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEd,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAC,EAAE;QAAC,OAAO;YACtC,GAAG,EAAE,IAAI,CAAC,CAAC;YACX,GAAG,EAAE,IAAI,CAAC,CAAC;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAA;IAAA,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/gpf/parcellaire-express.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Get items from CADASTRALPARCELS.PARCELLAIRE_EXPRESS near of a given location.
+ *
+ * @see https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export function getParcellaireExpress(lon: number, lat: number): Promise<array<object>>;
+export const PARCELLAIRE_EXPRESS_SOURCE: "G\u00E9oplateforme (WFS, CADASTRALPARCELS.PARCELLAIRE_EXPRESS)";
+export const PARCELLAIRE_EXPRESS_TYPES: string[];

package/dist/gpf/parcellaire-express.js

@@ -0,0 +1,74 @@
+import logger from '../logger.js';
+import distance from '../helpers/distance.js';
+import _ from 'lodash';
+import { fetchJSON } from '../helpers/http.js';
+// CADASTRALPARCELS.PARCELLAIRE_EXPRESS:
+// https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities
+export const PARCELLAIRE_EXPRESS_SOURCE = "Géoplateforme (WFS, CADASTRALPARCELS.PARCELLAIRE_EXPRESS)";
+export const PARCELLAIRE_EXPRESS_TYPES = [
+    'arrondissement',
+    'commune',
+    'feuille',
+    'parcelle',
+    'subdivision_fiscale',
+    'localisant'
+];
+/**
+ * Filter items by distance keeping the nearest for each type.
+ *
+ * @param {array<object>} items
+ * @returns {array<object>}
+ */
+function filterByDistance(items) {
+    const sortedItems = _.orderBy(items, ['type', 'distance'], ['asc', 'asc']);
+    const result = [];
+    let lastType = null;
+    for (const item of sortedItems) {
+        if (lastType == item.type) {
+            continue;
+        }
+        result.push(item);
+        lastType = item.type;
+    }
+    return result;
+}
+/**
+ * Get items from CADASTRALPARCELS.PARCELLAIRE_EXPRESS near of a given location.
+ *
+ * @see https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export async function getParcellaireExpress(lon, lat) {
+    logger.info(`getParcellaireExpress(${lon},${lat}) ...`);
+    // note that EPSG:4326 means lat,lon order for GeoServer -> flipped coordinates...
+    const cql_filter = `DWITHIN(geom,Point(${lat} ${lon}),10,meters)`;
+    const sourceGeom = {
+        "type": "Point",
+        "coordinates": [lon, lat]
+    };
+    // TODO : avoid useless geometry retrieval at WFS level
+    const url = 'https://data.geopf.fr/wfs?' + new URLSearchParams({
+        service: 'WFS',
+        request: 'GetFeature',
+        typeName: PARCELLAIRE_EXPRESS_TYPES.map((type) => { return `CADASTRALPARCELS.PARCELLAIRE_EXPRESS:${type}`; }).join(','),
+        outputFormat: 'application/json',
+        cql_filter: cql_filter
+    }).toString();
+    const featureCollection = await fetchJSON(url);
+    return filterByDistance(featureCollection.features.map((feature) => {
+        // parse type from id (ex: "commune.3837")
+        const type = feature.id.split('.')[0];
+        // ignore geometry and extend properties
+        return Object.assign({
+            type: type,
+            id: feature.id,
+            bbox: feature.bbox,
+            distance: distance(sourceGeom, feature.geometry),
+            source: PARCELLAIRE_EXPRESS_SOURCE,
+        }, feature.properties);
+    }));
+}
+//# sourceMappingURL=parcellaire-express.js.map

package/dist/gpf/parcellaire-express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parcellaire-express.js","sourceRoot":"","sources":["../../src/gpf/parcellaire-express.js"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAE9C,OAAO,CAAC,MAAM,QAAQ,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,wCAAwC;AACxC,kFAAkF;AAElF,MAAM,CAAC,MAAM,0BAA0B,GAAG,2DAA2D,CAAC;AACtG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,gBAAgB;IAChB,SAAS;IACT,SAAS;IACT,UAAU;IACV,qBAAqB;IACrB,YAAY;CACf,CAAC;AAEF;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,KAAK;IAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAM,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,SAAS;QACb,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAGD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAG,EAAE,GAAG;IAChD,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC;IACxD,kFAAkF;IAClF,MAAM,UAAU,GAAG,sBAAsB,GAAG,IAAI,GAAG,cAAc,CAAC;IAElE,MAAM,UAAU,GAAG;QACf,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,CAAC,GAAG,EAAC,GAAG,CAAC;KAC3B,CAAC;IAEF,uDAAuD;IACvD,MAAM,GAAG,GAAG,4BAA4B,GAAG,IAAI,eAAe,CAAC;QAC3D,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,yBAAyB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,wCAAwC,IAAI,EAAE,CAAA,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACtH,YAAY,EAAE,kBAAkB;QAChC,UAAU,EAAE,UAAU;KACzB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEd,MAAM,iBAAiB,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,gBAAgB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/D,0CAA0C;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,wCAAwC;QACxC,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,QAAQ,CACd,UAAU,EACV,OAAO,CAAC,QAAQ,CACnB;YACD,MAAM,EAAE,0BAA0B;SACrC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/gpf/urbanisme.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Get urbanism infos for a given location
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export function getUrbanisme(lon: number, lat: number): Promise<any>;
+/**
+ * Get SUP infos for a given location
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export function getAssiettesServitudes(lon: number, lat: number): Promise<any>;
+export const URBANISME_TYPES: string[];
+export const URBANISME_SOURCE: "G\u00E9oplateforme - (WFS G\u00E9oportail de l'Urbanisme)";

package/dist/gpf/urbanisme.js

@@ -0,0 +1,95 @@
+import distance from "../helpers/distance.js";
+import { fetchJSON } from "../helpers/http.js";
+import logger from "../logger.js";
+// https://data.geopf.fr/wfs/ows?service=WFS&version=2.0.0&request=GetCapabilities
+export const URBANISME_TYPES = [
+    'wfs_scot:scot',
+    'wfs_du:document',
+    'wfs_du:zone_urba',
+    'wfs_du:secteur_cc',
+    'wfs_du:info_pct',
+    'wfs_du:info_lin',
+    'wfs_du:info_surf',
+    'wfs_du:prescription_pct',
+    'wfs_du:prescription_lin',
+    'wfs_du:prescription_surf'
+];
+export const URBANISME_SOURCE = "Géoplateforme - (WFS Géoportail de l'Urbanisme)";
+/**
+ * Get urbanism infos for a given location
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export async function getUrbanisme(lon, lat) {
+    logger.info(`getUrbanisme(${lon},${lat})...`);
+    // note that EPSG:4326 means lat,lon order for GeoServer -> flipped coordinates...
+    const cql_filter = `DWITHIN(the_geom,Point(${lat} ${lon}),30,meters)`;
+    const sourceGeom = {
+        "type": "Point",
+        "coordinates": [lon, lat]
+    };
+    // TODO : avoid useless geometry retrieval at WFS level
+    const url = 'https://data.geopf.fr/wfs?' + new URLSearchParams({
+        service: 'WFS',
+        request: 'GetFeature',
+        typeName: URBANISME_TYPES.join(','),
+        outputFormat: 'application/json',
+        cql_filter: cql_filter
+    }).toString();
+    const featureCollection = await fetchJSON(url);
+    return featureCollection.features.map((feature) => {
+        // parse type from id (ex: "commune.3837")
+        const type = feature.id.split('.')[0];
+        // ignore geometry and extend properties
+        return Object.assign({
+            type: type,
+            id: feature.id,
+            bbox: feature.bbox,
+            distance: (distance(sourceGeom, feature.geometry) * 1000.0)
+        }, feature.properties);
+    });
+}
+const ASSIETTES_SUP_TYPES = [
+    'wfs_sup:assiette_sup_p',
+    'wfs_sup:assiette_sup_l',
+    'wfs_sup:assiette_sup_s',
+];
+/**
+ * Get SUP infos for a given location
+ *
+ * @param {number} lon
+ * @param {number} lat
+ * @returns
+ */
+export async function getAssiettesServitudes(lon, lat) {
+    logger.info(`getAssiettesServitudes(${lon},${lat})...`);
+    // note that EPSG:4326 means lat,lon order for GeoServer -> flipped coordinates...
+    const cql_filter = `DWITHIN(the_geom,Point(${lat} ${lon}),30,meters)`;
+    const sourceGeom = {
+        "type": "Point",
+        "coordinates": [lon, lat]
+    };
+    // TODO : avoid useless geometry retrieval at WFS level
+    const url = 'https://data.geopf.fr/wfs?' + new URLSearchParams({
+        service: 'WFS',
+        request: 'GetFeature',
+        typeName: ASSIETTES_SUP_TYPES.join(','),
+        outputFormat: 'application/json',
+        cql_filter: cql_filter
+    }).toString();
+    const featureCollection = await fetchJSON(url);
+    return featureCollection.features.map((feature) => {
+        // parse type from id (ex: "commune.3837")
+        const type = feature.id.split('.')[0];
+        // ignore geometry and extend properties
+        return Object.assign({
+            type: type,
+            id: feature.id,
+            bbox: feature.bbox,
+            distance: (distance(sourceGeom, feature.geometry) * 1000.0)
+        }, feature.properties);
+    });
+}
+//# sourceMappingURL=urbanisme.js.map

package/dist/gpf/urbanisme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urbanisme.js","sourceRoot":"","sources":["../../src/gpf/urbanisme.js"],"names":[],"mappings":"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"}

package/dist/gpf/wfs.d.ts

@@ -0,0 +1,22 @@
+export declare const GPF_WFS_URL = "https://data.geopf.fr/wfs";
+import { WfsFeatureTypeBrief, WfsFeatureTypeFull } from "@camptocamp/ogc-client";
+export declare class FeatureTypeNotFoundError extends Error {
+    constructor(name: string);
+}
+export declare class FeatureTypeSearch {
+    private featureTypes;
+    private miniSearch;
+    constructor(featureTypes: WfsFeatureTypeBrief[]);
+    search(query: string): import("minisearch").SearchResult[];
+}
+export declare class WfsClient {
+    baseUrl: string;
+    private endpoint;
+    private featureTypes;
+    private featureTypeSearch;
+    constructor(baseUrl?: string);
+    getFeatureTypes(): Promise<WfsFeatureTypeBrief[]>;
+    searchFeatureTypes(query: string, maxResults?: number): Promise<WfsFeatureTypeBrief[]>;
+    getFeatureType(name: string): Promise<WfsFeatureTypeFull>;
+}
+export declare const wfsClient: WfsClient;