Input Fields

For New Zealand, GeocodeAddressGlobal takes a street address 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.

The following table lists the input fields used for geocoding locations in New Zealand.

AddressLine1

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

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.

Table 1. Input Fields for New Zealand

Parameter

Description

AddressLine1

One of the following:

  • The address line containing the street name and building number. For example:

    Flat 2/31 Kings Road
    Mount Roskill
    Auckland 1041

  • 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.

AddressLine2

This field is not used in this country.

City

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

County

The meaning of county varies by country.

  • NZL (New Zealand)—Region

The region name.

FirmName

Company or place name. For example:

Pitney Bowes
72 Apollo Drive
Rosedale
North Shore City 0632
Auckland

HouseNumber

The building number. You may get better parsing results for some countries if you put the house number in this field instead of AddressLine1. Not every country includes house number data.

Note: The house number specified in the HouseNumber field takes precedence over any house number specified in the AddressLine1 field.

LastLine

The last line of the address.

  • Flat 2/31 Kings Road
    Mount Roskill
    Auckland 1041

Locality

The meaning of locality varies by country. Generally a locality is a village in rural areas or it may be a suburb in urban areas. When used, a locality typically appears on the last line of the address with the postcode.

  • NZL (New Zealand)—Suburb

PostalCode

The postal code in the appropriate format for the country.

New Zealand has a four-digit postal code. The first digit represents the geographic region. The second and third digits represent the postal sort area. The last digit represents a specific urban area, rural delivery or PO box lobby.

StateProvince

The meaning of State/Province varies by country.

  • NZL (New Zealand)—Region