Page tree
Skip to end of metadata
Go to start of metadata



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: 

https://trial.serviceobjects.com/GCC/api.svc/json/GetGeoLocation?Address={ADDRESS}&Municipality={MUNICIPALITY}&Province={PROVINCE}&PostalCode={POSTALCODE}&LicenseKey={LICENSEKEY}

XML: 

https://trial.serviceobjects.com/GCC/api.svc/xml/GetGeoLocation?Address={ADDRESS}&Municipality={MUNICIPALITY}&Province={PROVINCE}&PostalCode={POSTALCODE}&LicenseKey={LICENSEKEY}

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/products/address-geocoding/address-geocode-canada


 

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 .

ErrorErrorVariesError object indicating why the service could not return a result.


References




  • No labels