2.16.5

Recherche par territoire

Retourne la liste des territoires de type {type} intersectant l'élément {code} de type {source} 

GET https://terrapi.geo.msp.gouv.qc.ca/{source}/{code}/{type}
Paramètre d'url Type Description Valeurs possibles
source Territoire Type de territoires à intersecter adresses, agglomeration, anciennes-adresses, arrondissements, bassins-versants, bornes-cn, bornes-gcc, bornes-km, bornes-sumi, bureaux-reg-msp, c911, circ-fed, circ-prov, clsc, codes-postaux, cs, dir-reg, entreprises, intersections, mrc, municipalites, province, regadmin, regmsp, rls, routes, rss, rts, ruis, seg-routes, sorties-autoroute, tours, tourisme, tssi, unites, zones-postales, mern.zones-chasse, mern.sous-zones-chasse, lieux.aleas.stations-hydro-publique, lieux.education.service-garde, lieux.education.public, lieux.education.prive, lieux.education.gouvernemental, lieux.education.colleges, lieux.education.universites, lieux.historique.niveau-eau-publique, lieux.historique.reperes-crue, lieux.historique.observation-embacles, lieux.sante.aine, lieux.sante.ambulance, lieux.sante.clinique, lieux.sante.etabl, lieux.sante.gmf, lieux.sante.naissance, lieux.sante.pharmacie, lieux.securite.casernes, lieux.securite.correctionnel, lieux.securite.organisme, lieux.securite.palais-justice, lieux.securite.penitencier-fed, lieux.securite.penitencier-prov, lieux.securite.polices, lieux.sepaq.batiment, lieux.sepaq.camping, lieux.sepaq.equipement, lieux.toponyme.bati, lieux.toponyme.geographie, lieux.toponyme.hydro, lieux.toponyme.parc, lieux.toponyme.secteur, lieux.toponyme.localite, lieux.transport.commun
code [texte] Identifiant du territoire source. Il est possible d'indiquer plusieurs identifiants séparés par une virgule. Il est également permis d'utiliser un sous-type comme 'education' ou 'service-garde'.
type [Territoire] Type de territoires recherchés. Il est possible d'indiquer plusieurs territoires séparés par une virgule. adresses, agglomeration, anciennes-adresses, arrondissements, bassins-versants, bornes-cn, bornes-gcc, bornes-km, bornes-sumi, bureaux-reg-msp, c911, circ-fed, circ-prov, clsc, codes-postaux, cs, dir-reg, entreprises, intersections, mrc, municipalites, province, regadmin, regmsp, rls, routes, rss, rts, ruis, seg-routes, sorties-autoroute, tours, tourisme, tssi, unites, zones-postales, mern.zones-chasse, mern.sous-zones-chasse, lieux.aleas.stations-hydro-publique, lieux.education.service-garde, lieux.education.public, lieux.education.prive, lieux.education.gouvernemental, lieux.education.colleges, lieux.education.universites, lieux.historique.niveau-eau-publique, lieux.historique.reperes-crue, lieux.historique.observation-embacles, lieux.sante.aine, lieux.sante.ambulance, lieux.sante.clinique, lieux.sante.etabl, lieux.sante.gmf, lieux.sante.naissance, lieux.sante.pharmacie, lieux.securite.casernes, lieux.securite.correctionnel, lieux.securite.organisme, lieux.securite.palais-justice, lieux.securite.penitencier-fed, lieux.securite.penitencier-prov, lieux.securite.polices, lieux.sepaq.batiment, lieux.sepaq.camping, lieux.sepaq.equipement, lieux.toponyme.bati, lieux.toponyme.geographie, lieux.toponyme.hydro, lieux.toponyme.parc, lieux.toponyme.secteur, lieux.toponyme.localite, lieux.transport.commun

Une recherche 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, type, -type, distance, -distance
field [propriété] Retourne les propriétés optionnelles demandées
limit Nombre Limite le nombre de territoires retournés par type. 0 - 1000 (défaut)
simplified Précision (mètres) Indique si on utilise une géométrie simplifiée pour faire l'intersection. Utiliser une géométrie simplifiée permet d'améliorer le temps de réponse au détriment de la précision. 0 - 10 - 25 - 100
bufferInput Nombre (mètres) Ajoute un buffer (en mètres) autour du territoire source. Avec un buffer, à moins d'indication contraire, la précision utilisée sera de 100 mètres. 0-100000
bufferOutput Nombre (mètres) Ajoute un buffer (en mètres) autour des territoires retournés. 0-100000
minIntersectionWithin Pourcentage Indique le pourcentage minimun de chevauchement désiré avec le territoire retourné.
(% du territoire qui est dedans la 'source')
La propriété 'percentageWithin' sera retournée. 		0 (défaut) - 100
minIntersectionContains Pourcentage Indique le pourcentage minimun de chevauchement désiré avec le territoire source.
(Le territoire contient % de la 'source')
La propriété 'percentageContains' sera retournée. 		0 (défaut) - 100
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
[propriété] Filtrer selon une propriété filtrable. Utiliser != pour inverser le filtre.

Exemple de requête

# Requete pour obtenir les municipalites intersectant la région administrative 01.
  https://terrapi.geo.msp.gouv.qc.ca/regadmin/01/municipalites

Réponse

feature
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 les cliniques médicales intersectant l'arrondissement REQ01 (La Cité-Limoilou)
https://terrapi.geo.msp.gouv.qc.ca/arrondissements/REQ01/lieux.sante.clinique

# Requête pour obtenir les rivières contenues à 90% dans le bassin versant 18203 (Rivière Matane)
https://terrapi.geo.msp.gouv.qc.ca/bassins-versants/18203/hydro?q=Rivière&minIntersectionWithin=90

# Requete pour identifer à quelle municipalité apartien l'unite.
  https://terrapi.geo.msp.gouv.qc.ca/unites/ed5a8647bcb94ae17bad9471efc4c400/municipalites

# Requête pour obtenir l'arrondissement d'une adresse
https://terrapi.geo.msp.gouv.qc.ca/adresses/1cbe225a8fda36bee05358f2298ed5feG1V2L2/arrondissements

# Requêtes en 2 étapes pour déterminer la circonscription provinciale d'une adresse (la première requête fait référence au service de géocodage iCherche)
1- https://terrapi.geo.msp.gouv.qc.ca/icherche/geocode?type=adresses&q=2525 laurier québec&limit=1
2- https://terrapi.geo.msp.gouv.qc.ca/adresses/1cbe225a8fda36bee05358f2298ed5feG1V2L2/circ-prov