Service de géolocalisation

Note : Veuillez noter que le service est également accessible via le protocole https.

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 feuillets cartographiques correspondant au système national de référence cartographique (SNRC)

Exemples de requêtes

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.

• Adresse complète (sans le code postal) : http://geogratis.gc.ca/services/geolocation/en/locate?q=2144%20King%20We...
• Nom de rue : http://geogratis.gc.ca/services/geolocation/en/locate?q=King%20West%20St...
• Intersection : http://geogratis.gc.ca/services/geolocation/en/locate?q=King%20West%20St...
• Nom de lieu : http://geogratis.gc.ca/services/geolocation/en/locate?q=Sherbrooke,%20QC
• Code postal : http://geogratis.gc.ca/services/geolocation/en/locate?q=J1J
• Numéro SNRC : http://geogratis.gc.ca/services/geolocation/en/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.

Paramètre	Description
q	Terme de recherche.
expand	Liste des propriétés supplémentaires à inclure dans la réponse. Les propriétés disponibles sont score et component.
callback	Nom de la fonction de rappel utilisée pour le formatage en mode JSONP (JSON with padding) permettant l'invocation asynchrone du service à partir d’applications hébergées sur des domaines distincts.

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/en/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 (City)",
"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": "Ottawa Avenue, Brandon, Manitoba",
"qualifier": "INTERPOLATED_CENTROID",
"type": "ca.gc.nrcan.geoloc.data.model.Street",
"geometry": {"type":"Point","coordinates":[-99.9691476,49.8254685]}
},
...
]

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 correspond exactement à un terme de l'index, ce terme sera suggéré en premier lieu.

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