Liste de territoires - Général
Retourne tous les territoires correspondant à un type.
GET https://terrapi.geo.msp.gouv.qc.ca/{type}Une recherche de type accepte les options suivantes:
| Option | Type | Description | Valeurs possibles |
|---|---|---|---|
| q | Texte |
Recherche textuelle dans la propriété 'nom'. La recherche est insensible aux accents et aux majuscules. | |
| sort | [propriété] |
Tri les résultats selon une ou plusieurs propriétés. Pour inverser
le tri, ajouter - devant le nom de la propriété.
|
q, -q, distance, -distance |
| field | [propriété] |
Retourne les propriétés optionnelles demandées | |
| limit | Nombre |
Limite le nombre de territoires retournés | 0 - 1000 (défaut) |
| geometry | Booléen / précision / string |
Indique si la géométrie est retournée et la précision (en mètres) de celle-ci. |
0 (false): ne renvoie rien 1 (true): renvoie la géométrie complète 10: renvoie la géométrie simplifiée ayant une précision de 10 mètres 25: renvoie la géométrie simplifiée ayant une précision de 25 mètres 100: renvoie la géométrie simplifiée ayant une précision de 100 mètres null: renvoie null center: renvoie le centre du BBOX centroid: renvoie le centroïde de l'entité pointOnFeature: renvoie un point à l'intérieur du polygone |
| bbox | Booléen |
Indique si le bbox est retourné | 0 (false), 1 (true) |
| crs | EPSG:#### |
Indique dans quelle projection, les géométries sont retournées | EPSG:4326 (défaut), EPSG:3857, EPSG:32198 |
| loc | x,y / geojson |
Retourne seulement les territoires intersectant les coordonnées passées en paramètre. La projection des coordonnées doit être la même que celle passée par le paramètre 'crs'. Seule la section 'geometry' d'un geojson est acceptée. La propriété 'distance' sera retournée. | |
| bufferInput | Nombre (mètres) |
Ajoute un buffer (en mètres) autour de la géométrie passée par le paramètre 'loc'. | 0-100000 |
| bufferOutput | Nombre (mètres) |
Ajoute un buffer (en mètres) autour des territoires retournés. | 0-100000 |
| [propriété] |
Filtrer selon une propriété filtrable.
Utiliser != pour inverser le filtre.
|
Exemple de requête
# Requête pour obtenir les municipalites comprenant 'lev' et trier.
https://terrapi.geo.msp.gouv.qc.ca/municipalites?q=lev&sort=q&bbox
Réponse
-
features: Une liste d’objets feature
feature
-
properties: Les propriétés associées au territoire. Chaque type de territoire aura des propriétés différentes.
-
bbox: Contiendra un objet bbox. Cette section n’est présente que lorsque le paramètre bbox est défini -
geometry: Contiendra un objet geometry. Cette section n’est présente que lorsque le paramètre geometry est défini
bbox
[ xmin, ymin, xmax, ymax ]
geometry
Cette section de la réponse est conforme au Geometry Objects du standard
geojson.
http://geojson.org/geojson-spec.html#geometry-objects
properties
Voir les sections de chaque type de territoire pour le détail.
Exemple de réponse
{
"features": [
{
"properties": {
"code": "25213",
"nom": "Lévis"
},
"bbox": [
-71.52010938,
46.57301462,
-70.99443656,
46.8425893
],
"type": "Feature"
}
],
"type": "FeatureCollection"
}
Liste d'exemples
# Requête pour obtenir la liste des arrondissements de la municipalité de Montréal https://terrapi.geo.msp.gouv.qc.ca/arrondissements?municipalite=Montréal # Requête pour obtenir la liste d'unites dont le mot clé cartier fait parti du contenu du nom. https://terrapi.geo.msp.gouv.qc.ca/unites?q=cartier # Requête pour obtenir la liste des 20 premiers résultats des services de garde compris dans un certain polygone https://terrapi.geo.msp.gouv.qc.ca/lieux.education.service-garde?loc=-71.3,46.2;-71.9,46.2;-71.9,46.1;-71.3,46.1&limit=20