Canada (CAN)

This chapter defines the supported Geocode datasets, operations, and input and output field information for Canada.

Supported Geocode Datasets

The following table lists the supported Geocode dataset(s) with the available geocoding levels for Canada.

Supported Operations

The following operations are supported for Canada:

Input Fields

Canadian addresses may contain some or all of the following address elements.

Address Guidelines for Canada

Follow these suggestions to ensure that your street input data is in the best format possible for optimum matching and geocoding.

• Post Office Box numbers—P.O. Boxes and Rural Route addresses are not geocodable. This user input will be honored and an attempt is made to output Boxes and Rural Route information, but it will not be used for geocoding purposes.
• Highway addresses—Highway addresses (such as Hwy 401) are geocoded.
• House numbers and apartment letters—Remove spaces between house number and apartment letter. 123 A Main Street does not geocode correctly because the geocoder assumes that the name of the street is A. Two workaround options are available: either do not include the apartment letter or delete the space between the house number and apartment letter.
• House numbers and unit information—The house number pinpoints the location of the address. Unit input can be in one of two formats, as shown in the following examples:

  - 99-123 Main St, where 99 is the unit number. In this format, do not specify the unit type. The number 99 could be a suite, apartment, unit, floor or any valid unit type.
  - 123 Main St. Apt 99, where Apt is the unit type and 99 is the unit number. In this format, you must specify a valid unit type (such as Apt or Suite), otherwise the address will not be geocoded correctly.

• Directional suffixes—Use directional suffixes wherever possible. This is especially true in towns and cities, such as Calgary, which consist mainly of numbered streets. These streets can only be distinguished by their directional suffixes and street types. They also distinguish addresses on streets that change direction. For example: 123 Main St W and 123 Main St E have very different coordinates.
• Street types—These distinguish different streets of the same name. For example, Main Avenue and Main Street are two entirely different entities. Using types is not essential, but it adds precision to your data. For a list of valid street types see www.canadapost.com.
• City name—Do not abbreviate city names. If the city is unknown, you may leave it blank, although this may affect the accuracy of the geocode.
• Province name—You may use the full province name (for example, Ontario), but using the two-character abbreviation (ON) is recommended to reduce the likelihood of input errors. Without a postcode, you must enter both the province and city in order to geocode.

Single Line Input

Instead of entering each address component in separate fields, you can enter the entire address in the mainAddress input field with the address elements ordered as follows:

[address_number][street_info][area_name_3][area_name_1][post_code_1][post_code_2]

For best results, put a comma between street information and the lastline (e.g. city and postal) information.

Custom Options

The following table lists the options that are unique to Canada. These custom options are optional input parameters, and unless otherwise noted, they are available for both Geocoding and Reverse Geocoding.

Parsed Address Output Fields

The following table lists the parsed address fields returned for a candidate located in Canada.

Custom Output Fields

The following table lists the output fields that are unique for Canada. Unless otherwise noted, these fields can be returned for both forward and reverse geocoding.