Input Fields

For Canada, GeocodeAddressCAN takes a street address , PO Box or intersection as input. To obtain the best performance and the most possible matches, your input address lists should be as complete as possible, free of misspellings and incomplete addresses, and as close to postal authority standards as possible. Most postal authorities have websites that contain information about address standards for their particular country.

This table lists the input fields used for geocoding locations in Canada.

AddressLine1

For most countries, the AddressLine1 field should contain the address line that has the street name and building number and/or PO Box in it.

This field can also contain the full address. For more information, see Single Line Input.

Addresses in CAN, FRA and GBR containing PO Box information in place of, or in addition to, street address can be geocoded.

For all countries except Argentina, Great Britain, and Japan, this field can contain a street intersection. To specify a street intersection, use double ampersand (&&) to separate the streets. For more information, see Street Intersection Input.

This table lists the Input Fields for Canada.

Parameter

Format

Description

Option.AddressLine1

String [50]
  • The address line containing the street name and building number or PO Box, or both.

    330 Main St

    Toronto ON M1B 3V4

  • This field can also contain the full address. For more information, see Single Line Input
  • For all countries except Argentina, Great Britain, and Japan, this field can contain a street intersection. To specify a street intersection, use double ampersand (&&) to separate the streets. For more information, see Street Intersection Input.

Option.AddressLine2

String [50]

The second address line of a two-line address. For example:

26 WELLINGTON ST E

SUITE 500
TORONTO ON M5E 1S2

This field is not used in this country.

Option.FirmName

String [50]

Company or place name. For example:

Toronto Star Building

1 Yonge St
Toronto ON M5E 1E5

Option.Locality

String [50]

If you do not require exact matches on locality, the geocoder searches on the street address matched to the particular postal code, and considers other localities that do not match the name, but do match the postal code.

CAN (Canada) - Dissemination Area and Enumeration Area (DA and EA)

Option.County

String [50]

Specifies whether candidates must match the county (or equivalent) to be considered a close match. The meaning of county varies for different countries.

CAN (Canada) - Not used

Option.City

String [50]

The city or town name. For most countries, your input address should use the official city name or alias.

Option.StateProvince

String [50]

Specifies whether candidates must match the state or province (or equivalent) to be considered a close match.

CAN (Canada) - Province

Option.PostalCode

String [10]

The postal code in the appropriate format for the country.

Canada has a six-character postal code. The first three characters are typically separated from the second three with a space. The first three characters are the FSA, the second three are the LDU. Street address geocoding only requires the FSA while postal code geocoding requires the full postal code (FSALDU). Choose whether you wish to have a space between the first three and last three characters of the postal code. Keeping these consistent speeds up the geocoding process.

Option.LastLine

String [50]

The last line of the address.

330 Main St

Toronto ON M1B 3V4