Service de géolocalisation

Description

Le service de géolocalisation permet aux utilisateurs d’obtenir la position géographique d’un lieu nommé. Le présent service permet de localiser les éléments suivants:

• des adresses complètes
• des noms de rue
• des intersections
• des lieux situés au Canada tels que les villes, villages, municipalités, parcs, mais aussi des entités géographiques naturelles telles que les lacs, îles, rivières, montagnes, etc.
• des codes postaux (code RTA seulement - 3 premiers caractères d'un code postal)
• des feuillets cartographiques correspondant au système national de référence cartographique (SNRC)

Exemples de requêtes

Le service accepte uniquement un paramètre nommé q correspondant au terme à localiser. Voici des exemples de requête pour chacun des types de données.

• Adresse complète (sans le code postal) : http://geogratis.gc.ca/services/geolocation/fr/locate?q=2144%20rue%20King%20Ouest,%20Sherbrooke,%20QC
• Nom de rue : http://geogratis.gc.ca/services/geolocation/fr/locate?q=rue%20King%20Ouest,%20Sherbrooke,%20QC
• Intersection : http://geogratis.gc.ca/services/geolocation/fr/locate?q=rue%20King%20Ouest,%20rue%20Farwell,%20Sherbrooke,%20QC
• Nom de lieu : http://geogratis.gc.ca/services/geolocation/fr/locate?q=Sherbrooke,%20QC
• Code postal : http://geogratis.gc.ca/services/geolocation/fr/locate?q=J1J
• Numéro SNRC : http://geogratis.gc.ca/services/geolocation/fr/locate?q=021e

Paramètres de requête

Les paramètres de requête sont résumés dans le tableau suivant. Toutes les valeurs des paramètres doivent être encodées sous forme d'URL.

Recherche générique

Le paramètre associé au terme de recherche q supporte les astérisques (*) permettant de rechercher tous les termes débutant par les caractères fournis.

http://geogratis.gc.ca/services/geolocation/fr/locate?q=Otta*

Exemples de réponses

Le service retourne une liste des localisations correspondant au terme demandé, incluant notamment le type de localisation ainsi qu’une géométrie de type ponctuel dont les coordonnées sont exprimées en longitude et latitude. Dans certains cas, une propriété bbox est également incluse et contient les coordonnées géographiques du rectangle englobant (bounding box) de la géométrie correspondant à l’entité nommée. Les résultats sont triés par ordre de pertinence.

La réponse est en format JSON, il est également possible de fournir une valeur au paramètre callback afin d’obtenir une réponse encadrée dans un appel de fonction permettant l'invocation asynchrone du service à partir d’applications hébergées sur des domaines distincts.

[
...
{
    "title": "Ottawa, Carleton; Russell, Ontario (Ville)", 
    "qualifier": "LOCATION",
    "type": "ca.gc.nrcan.geoloc.data.model.Geoname",
    "bbox": [-76.3555857, 44.9617738, -75.2465783, 45.5376514],
    "geometry": {"type":"Point","coordinates":[-75.58429,45.333389]}
},
...
{
    "title": "031G05 OTTAWA", 
    "qualifier": "LOCATION",
    "type": "ca.gc.nrcan.geoloc.data.model.NTS",
    "bbox": [-76.0, 45.25, -75.5, 45.5],
    "geometry": {"type":"Point","coordinates":[-75.75,45.375]}
},
...
{
    "title": "Rue Ottawa, Montréal, Québec", 
    "qualifier": "INTERPOLATED_CENTROID",
    "type": "ca.gc.nrcan.geoloc.data.model.Street",
    "geometry": {"type":"Point","coordinates":[-73.5602104,45.492978]}
},
...
]

Fonctionnalités additionnelles

De façon expérimentale, le service propose deux fonctionnalités supplémentaires permettant la suggestion de termes similaires ou le complètement automatique. Ces deux fonctions acceptent uniquement un seul terme à la fois.

Suggestion de termes similaires

La fonctionnalité de suggestion de termes similaires offre la possibilité de rechercher des termes possédant des similitudes phonétiques ou orthographiques avec un terme donné. Les termes retournés sont ordonnés selon la fréquence d'apparition du terme dans l'index. Cependant si le terme recherché existe, il sera suggéré en premier lieu.

http://geogratis.gc.ca/services/geolocation/fr/suggest?q=Sherbrooke

Complètement automatique

La fonctionnalité de complètement automatique offre la possibilité de rechercher des termes débutant par les caractères fournis. Les termes retournés sont ordonnés selon la fréquence d'apparition du terme dans l'index. Cependant si la chaîne de caractères correspondent exactement à un temre de l'index, ce terme sera suggéré en premier lieu.

http://geogratis.gc.ca/services/geolocation/fr/autocomplete?q=Sherb