Appliquer un filtre géographique
Dans Isogeo, les métadonnées peuvent contenir une enveloppe géographique (mais ça n'est pas systématique).
Elle est alors décrite comme un GeoJSON inclus dans le JSON renvoyé :
"envelope": {
"bbox": [
1.53421117608959,
47.4932915310182,
3.12437082073202,
48.3342563074165
],
"coordinates": [
[
[
1.53878873538249,
47.8421564892245
],
[
1.56189864932977,
47.7901519658336
],
[...]
]
],
"type": "Polygon"
},
L'API permet de filtrer directement les résultats en tenant compte de cette enveloppe.
Par emprise
Paramètre : box
Description
Renvoie les ressources dont l’enveloppe possède la relation géographique spécifiée avec l’emprise envoyée. Si la ressource ne possède pas d’enveloppe, elle n’est pas remontée. Les coordonnées de l’emprise sont en WGS84 (EPSG 4326) et respecte les spécifications d’OpenSearch.
Exemples
/resources/search?box=-4.970,30.69418,8.258,51.237
Par enveloppe
Paramètre : geo
Description
Renvoie les ressources dont l’enveloppe possède la relation géographique spécifiée avec l’enveloppe envoyée. Si la ressource ne possède pas d’enveloppe, elle n’est pas remontée. L’enveloppe doit être décrite au format WKT.
Exemples
/resources/search?geo=POLYGON((0.582%2040.496%2C%200.231%2040.737%2C%200.736%2042.869%2C%203.351%2042.386%2C%203.263%2041.814%2C%202.164%2041.265%2C%200.978%20%20%2040.957%2C%200.802%2040.781%2C%200.978%2040.649%2C%200.582%2040.496))
Opérateurs spatiaux
Paramètre : rel
Description
Permet de spécifier la requête spatiale appliquée pour filtrer les résultats dans une emprise ou une enveloppe polygonale.
Uniquement interprété si l'un des paramètres box ou geo est passé.
Valeurs possibles
Les valeurs possibles sont basées sur les relations standard définies par l’OGC dans OGC 06-103r4 §6.1.15.
| Valeur | Opération appliquée |
|---|---|
| contains | les métadonnées renvoyées sont celles dont l'enveloppe contient complètement l’enveloppe envoyée |
| disjoint | les métadonnées renvoyées sont celles dont l'enveloppe n'intersecte pas l’enveloppe envoyée |
| equals | les métadonnées renvoyées sont celles dont l'enveloppe est exactement celle de l’enveloppe envoyée |
| intersects | les métadonnées renvoyées sont celles dont l'enveloppe croise l’enveloppe envoyée - VALEUR PAR DEFAUT |
| overlaps | les métadonnées renvoyées sont celles dont l'enveloppe englobe l'enveloppe envoyée |
| within | les métadonnées renvoyées sont celles dont l'enveloppe est entièrement contenue dans l’enveloppe envoyée |
En pratique, les valeurs les plus couramment utilisées sont :
- intersects
- within
- contains
Exemples
/resources/search?geo=POLYGON((0.582%2040.496%2C%200.231%2040.737%2C%200.736%2042.869%2C%203.351%2042.386%2C%203.263%2041.814%2C%202.164%2041.265%2C%200.978%20%20%2040.957%2C%200.802%2040.781%2C%200.978%2040.649%2C%200.582%2040.496))&rel=within
Cas particuliers
Les paramètres box et geo sont tous les deux passés
Si les 2 paramètres sont présents dans la même requête, l'opérateur géométrique est forcément une intersection et le paramètre georel est ignoré.
Sens de numérisation des enveloppes
A DOCUMENTER