Rechercher par code - Général
Retourne le territoire ayant le bon identifiant (code).
GET https://terrapi.geo.msp.gouv.qc.ca/{type}/{code}
Une recherche accepte les options suivantes:
| Option | Type | Description | Valeurs possibles |
|---|---|---|---|
| field | [propriété] |
Retourne les propriétés optionnelles demandées | |
| 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 la distance avec 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 du territoire retourné. | 0-100000 |
Exemple de requête
# Requête pour obtenir la région administrative ayant le code 01
https://terrapi.geo.msp.gouv.qc.ca/regadmin/01?bbox
Réponse
-
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
{
"properties": {
"code": "25213",
"nom": "Lévis"
},
"bbox": [
-71.52010938,
46.57301462,
-70.99443656,
46.8425893
],
"type": "Feature"
}
}
Liste d'exemples
# Requête pour obtenir la municipalité de Québec https://terrapi.geo.msp.gouv.qc.ca/municipalites/23027 # Requête pour obtenir l'adresse de l'unité à partir du code https://terrapi.geo.msp.gouv.qc.ca/unites/416b1119ddb01308478975ac658fdc17 # Requête pour obtenir l'Université Laval ainsi que sa distance par rapport à un point https://terrapi.geo.msp.gouv.qc.ca/lieux.education.universites/975000?loc=-71.3,46.2