This is the basic operation for finding the latitude/longitude coordinates of an address. This operation takes a standard Canadian address (Address, Municipality, Province, Postal Code) and will try to find the exact street location’s coordinates. It cannot always find the location, especially when it comes to empty lots or new construction areas.
First, DOTS Address Geocode – CA will attempt to correct and normalize the address to make it more likely to geocode properly. You don’t need to worry about fixing the address before sending it to DOTS Address Geocode – CA, unless you want to filter out invalid or non-existent addresses beforehand.
This operation requires the Address value, and either Municipality and Province, or the Zip code. Providing all inputs is recommended.
URL Endpoints
- JSON:
- XML:
GetGeoLocation Inputs
| Name | Type | Description |
|---|---|---|
| Address | String | Address line of the address to geocode. For example, “123 Main Street”. |
| Municipality | String | The municipality of the address to geocode. For example, “Cayuga”. The municipality isn’t required, but if one is not provided, the postal code is required. |
| Province | String | The province of the address to geocode. For example, “ON”. This does not need to be contracted, full province names will work as well.The province isn’t required, but if one is not provided, the postal code is required. |
| Postal Code | String | The postal code of the address to geocode. A postal code isn’t required, but if one is not provided, the municipality and province are required. |
| License Key | String | Your license key to use the service. Sign up for a free trial key at https://www.serviceobjects.com/address-geocode/ |
GetGeoLocation Outputs
| Name | Type | Values | Description |
|---|---|---|---|
| Latitude | String | Number | The latitude of the given address. |
| Longitude | String | Number | The longitude of the given address. |
| Postal Code | String | Number | Postal code of given address. |
| Match Code | String | Property, PostalCode or Municipality | A string indicating what to what level the input coordinates could be geocoded . |
| Error | Error | Varies | Error object indicating why the service could not return a result. |