API

Overview

Services

Locations API

A location can be an address, a monument, or an intersection.

Valid URL Parameters

x The UTM X coordinate of the point to find locations near. Use in conjunction with 'y' and 'distance'.
y The UTM Y coordinate of the point to find locations near. Use in conjunction with 'x' and 'distance'.
lat The latitude of the point to find locations near. Use in conjunction with 'lon' and 'distance'.
lon The longitude of the point to find locations near. Use in conjunction with 'lat' and 'distance'.
distance The distance in metres from the given point which returned locations must fall within. (default: 100)
max-results The number of locations to return -- closer locations will be prioritized. (default: 5)

Noteworthy Results

address A location identified by a numerical position on a street.
address/street-number The numerical position of the address on its street.
address/street The street which the address is found on. See the Streets service for more details.
intersection A location identified by the point where one street meets another.
intersection/(street|cross-street) The two streets whose convergence defines the intersection. See the Streets service for more details.
monument A location identified with by a proper noun name. Monuments contain an address.
monument/categories A monument can belong to many monument categories.
monument/address The address which the monument is found at.
//key A unique identifier for the location.
//name The location's name. See the usage parameter for formatting options.
//centre A geographical point describing the centre of the location. Both UTM and geographic coordinate systems are provided.

Examples

Login to see sample results.

Identity

  • locations/1234

Filter

  • locations?lon=-97.138&lat=49.895
  • locations?x=633861&y=5525798&max-results=1&distance=50
  • locations?x=633861&y=5525798&distance=50
  • locations?lon=-97.1372&x=633861
  • locations

Wildcard

  • locations:zoo
  • locations:budden
  • locations:414+osb