Input Fields

GeocodeAddressNew Zealand takes an address or intersection as input. For New Zealand, GeocodeAddressGlobal takes an 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.

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: Ruta 125 40405 Santo Domingo

    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
  • VNM (Vietnam)—District

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
  • VNM (Vietnam)—Not used.

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