POST Request Parameters

The POST request (timezoneAddressRequest) comprises the following input parameters:
  • addressTime - Request object which takes the following attributes. Required.
  • preferences - The option to set preferences. Optional.

    These objects and their elements are defined in the following table:

Parameter Description Usage
objectId Uniquely identifies address. If provided, the associated objectId with each address is returned in the response for reference. It should be a valid positive integer. If not provided, then the objectId is generated starting '1' and auto incremented. Optional
timestamp Specifies UTC time in milliseconds. The value is time elapsed since January 1, 1970 UTC. The input can contain negative and positive values, where the positive values express time after January 1, 1970 UTC, and negative values express time before January 1, 1970 UTC. Required
matchMode

Exact

Requires exact match. This mode generates the fewest match candidates, which decreases the processing time. When using this mode, ensure that your input is accurate with correct spellings and complete addresses.

Standard (Default value)

Requires a close match and generates a moderate number of match candidates.

Relaxed

Allows a loose match and generates the most match candidates, which increases the processing time and results in more multiple matches. Use this mode if the exact input is not known completely such as incomplete addresses and incorrect spellings. This is the only mode that does not respect the street parity when making an address match.

Optional
mainAddressLine Main address line of the address. Required
addressLastLine Last line part of the address Optional
placeName Name of the place of the address Optional
areaName1 State/Province Optional
areaName2 County/Region Optional
areaName3 City/Town Optional
areaName4 Suburb/Village Optional
postCode Zip code of the site address Optional
postCodeExt Extended Zip code part of the site address Optional
country Country part of the site address Optional
addressNumber Address number part of the site address Optional
streetName Street Name code part of the site address Optional
unitType Type of address(Apartment/house) part of the site address Optional
unitValue Apartment/House number part of the site address Optional