2.16.5

Rechercher par code - Général

Retourne le territoire ayant le bon identifiant (code).

GET https://terrapi.geo.msp.gouv.qc.ca/{type}/{code}
Paramètre d'url Type Description Valeurs possibles
type Territoire Type de territoires recherchés 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 recherché

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

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