2.16.5

Recherche spatiale

Retourne la liste des territoires intersectant un point ou un geojson (Géocodage inversé) 

GET https://terrapi.geo.msp.gouv.qc.ca/locate

Cette recherche accepte les options suivantes:

Option Type Description Valeurs possibles
type [Territoire] Obligatoire Type de territoire recherché. Possible de séparer plusieurs types par une virgule. Il est également permis d'utiliser un sous-type comme 'education' ou 'service-garde'. 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
loc x,y / geojson Obligatoire 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.
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é. code, -code, name, -name, 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)
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
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

Exemple de requête

# Requete pour obtenir les régions administratives et les municipalites intersectant le point -73.584532,45.566145.
  https://terrapi.geo.msp.gouv.qc.ca/locate?type=regadmin,municipalites&loc=-73.584532,45.566145

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

Exemple de réponse

{
      "features": [
          {
              "properties": {
                  "code": "25213",
                  "nom": "Lévis",
                  "type": "municipalites",
                  "distance": 0
              },
              "bbox": [
                  -71.52010938,
                  46.57301462,
                  -70.99443656,
                  46.8425893
              ],
              "type": "Feature"
          }
      ],
      "type": "FeatureCollection"
    }

Liste d'exemples

# Requête pour obtenir les établissements de santé localisés dans un rayon de 5km autour d'un point
https://terrapi.geo.msp.gouv.qc.ca/locate?type=lieux.sante.etabl&loc=-73.5,45.5&bufferInput=5000

# Recherche spatiale pour trouver les unités dans un rayon de 100 mètres organisé par code Postal
  https://terrapi.geo.msp.gouv.qc.ca/locate?type=unites&loc=-73.571440,45.495532&bufferInput=100&sort=codePostal

# Requête pour obtenir les commissions scolaires triées par nom comprises dans un certain polygone
https://terrapi.geo.msp.gouv.qc.ca/locate?type=cs&loc=-70,46.5;-73,46.5;-73,46;-70,46&sort=nom