FAQ

Frequently Asked Questions (FAQ)

Home > Support > FAQ

Frequently Asked Questions (FAQ)

In the FAQ section you can find answers to frequently asked questions. If your questions aren't answered here feel free to contact our Opens internal link in current windowsales department or Opens internal link in current windowsupport team.

/

How can I decide in which character set or language my address is returned?

Starting with Version 5.5.0, you can choose to preserve the input script of addresses from Belarus, China, Greece, Japan, Kazakhstan, Macedonia, Russia and Ukraine. To retain the input script in the output, you must set the PreferredScript parameter in parameter.xml to PRESERVE_INPUT.

If the input contains more than one script, AddressDoctor returns the address in the default script in the reference database.

If the input contains address elements that are not in the corresponding database, AddressDoctor copies such elements to the output in the same script the address was input.

When does AddressDoctor preserve locality aliases and vanity names?

Starting with Version 5.5.0, you can choose to retain locality aliases, also known as vanity names, in the validated output. You can set AliasStreet and AliasLocality values in the parameter.xml to define the handling of aliases for streets and localities.

If you want AddressDoctor to preserve the vanity name in the validated output, you must set the respective parameters to PRESERVE. If you want AddressDoctor to return the postal name in the validated output, set the respective parameters to OFF.

If you want to validated addresses in the Certified mode and generate output that conforms to the postal regulations of the country, you must ensure that the parameters are set to the default value OFFICIAL.

Why does AddressDoctor not validate my land lot-based South Korean addresses?

AddressDoctor version 5.5.0 and later supports only the new format of South Korean addresses. Similarly, the address data for South Korea has been migrated to the new format and is not compatible with previous versions of AddressDoctor.

However, AddressDoctor provides a database that matches land lot-based South Korean addresses with new formatted South Korean addresses. This translation has to be done on customer side and is not included in the validation progress.

This is an address example of the new South Korean address system:

Deongneung-ro 59-gil 4 (Street Name and House Number)
Dobong-gu, Seoul 132-919 (Locality 2 and Locality 1 and Postal Code)
Republic of Korea (Country)

Category: Cloud, Software Library
Why does AddressDoctor not validate my Taiwanese addresses?

Currently AddressDoctor supports only Taiwanese addresses that are in the Latin Script. For example:

Xue Li (Recipient Name)
Alley 1 Lane 170 (Dependent Street)
12 Dali St. (House Number and Major Street)
Wanhua Dist. (Locality 2 and District)
Taipei City 10856 (City and Locality 1 and Postal Code)

To enable support for Taiwanese addresses, you must get the unlock code for the Taiwan database from the AddressDoctor sales team. 

How should address elements be entered in single-line address validation?

AddressDoctor identifies address elements in a single-line address input based on their position in the sequence the elements are entered. So, it is imperative that you follow the correct order when you enter single-line addresses. When you enter an address in single-line, ensure that you do not mix Delivery address Line elements and Country Specific Locality Line elements. It is not necessary that you add delimiters such as commas or semicolons between address elements in a single-line address entry. However, a comma or semicolon-separated entry might get better results than the results for entries without commas or semicolons.


For Australia: Sub-building, House Number, Street, Main Locality, Province, Postal Code
For Canada: Sub-building, House Number, Street, Delivery Service, Main Locality, Province, Postal Code
For Germany: Street, House Number, Postal Code, Locality, Province
For Great Britain: Sub-building, House Number, Street, Main Locality, Sub Locality, Postal Code
For New Zealand: Sub-building, House Number, Street, Delivery Service, Locality, Postal Code
For United States: Sub-building, House Number, Street, Locality, Province, Postal Code

Category: Software Library
Why does single-line address validation not work even though I use Fast Completion mode?

Single-line Address Validation requires a separate unlock code. Please contact your sales representative for more information about obtaining the unlock codes.

Category: Software Library
For which country is single-line address validation available?

Single line address validation currently supports Australia, Canada, Germany, New Zealand, United Kingdom and United States using the AddressDoctor Software Library.

Category: Software Library
To what detail level does AddressDoctor Cloud geocode addresses?

Where possible, addresses are geocoded to building level. If this is not possible, they may be geocoded to the street, next fallback is center of a zip code or a locality. The detail level is written to the field OUT_GEOAccuracy. Possible values are:

The address was geocoded

BLDG
The reference position of the building was geocoded

STR
The Center of the street was geocoded

ZIPCD
The Center of a suburb within the postcode was geocoded

ZIPC
The Center of the locality within the postcode was geocoded

ZIP
The Center of the postcode was geocoded

Category: Cloud
AddressDoctor Cloud is not returning a GeoCode even though a delivery was requested. What is the reason?

There are a number of possible reasons, why an address was not geocoded. A value written into the field OUT_GEOStatus will provide more information.
0:    Geo coordinates are not provided, because you have no more
       geocoding transactions left.
1:    Geo coordinates are not provided, because geo coding is not
       available for this country.
2:    Geo coordinates are not provided, because the Validation Status
       was not V or C.
3:    Geo coordinates are not provided, because geo coding
       reported a no match.
4:    Geo coordinates are provided. The field OUT_GEOAccuracy
       describes the accuracy of the coordinates.

Category: Cloud
How long does it take to get access to AddressDoctor Cloud?

Access to AddressDoctor Cloud is available within minutes. Simply create a user account yourself and you can start right away.

Category: Cloud
What is the expected availability of AddressDoctor Cloud?

AddressDoctor Cloud provides over 99.9% availability.

Category: Cloud
What character set does AddressDoctor Cloud use?

AddressDoctor Cloud accepts requests in the UTF-8 character set.

Category: Cloud
AddressDoctor Cloud returns some of my data in uppercase letters. Why does this happen?

AddressDoctor Cloud will always return the data in a casing as described by the postal organizations of the destination country (unless the Capitalization parameter is set). So data for the UK or the US for instance, is always returned in upper case.

Category: Cloud
I receive a server error 500 using AddressDoctor Cloud. What is the cause?

AddressDoctor Cloud will return an error 500 (server error) if the request is malformed. Most common reasons are wrong casing (all tags are case sensitive), incorrect casing of the URL embedded in the request or missing or incomplete tags such as a missing department (must be set to 0). Please make sure that your request is compatible with the WSDL available at validator5.addressdoctor.com/webservice5/v1/addressvalidation.asmx

Category: Cloud
I am submitting data with accents (e. g. é) or umlauts (e. g. ü) and do not receive a meaningful response. What is wrong?

Most likely your request is improperly encoded. AD cloud requires UTF-8 encoding. If you are not using a SOAP toolkit, please make sure that you are using the correct HTTP header (Content-Type: text/xml; charset=utf-8) and that the encoding of your data is proper.

Category: Cloud
AddressDoctor Cloud returns the error message: "The string was not recognized as a valid Boolean value"

AD cloud is case-sensitive. You need to deliver all Boolean values in all lower case like "false" or "true".

Category: Cloud
Will Web Service 4 be switched off by AddressDoctor?

AddressDoctor will continue to support Web Service 4 after the launch of AddressDoctor Cloud. In order to allow flexible migration to AddressDoctor Cloud, AddressDoctor will continue to support Web Service 4 until June 30th 2015.

Category: Cloud
What is the pricing for AddressDoctor Cloud?

Pricing for AddressDoctor Cloud will remain the same as for the existing Web Service 4, current terms and conditions of Web Service 4 will remain valid for AddressDoctor Cloud as well. Purchased transactions for Web Service 4 can be used for AddressDoctor Cloud after the transition.

Category: Cloud
I would like to switch from Web Service 4 to AddressDoctor Cloud. What do I need to do?

Using AddressDoctor Cloud requires the integration of new objects by the customer/partner. The documentation of AddressDoctor Cloud (shortly available) will contain all relevant object information. In order to simplify the transition from Web Service 4 to AddressDoctor Cloud, AddressDoctor will provide test accounts with free test transactions upon request. If you wish to work with a test account and to get access to the AddressDoctor Cloud testing environment, please contact your sales representative.

Category: Cloud
Does AddressDoctor sort order for House Numbers?

Yes, AddressDoctor returns a list of house numbers in logical order instead of alphabetical order. For example, AddressDoctor now sorts and returns numbers in the following logical order:
1, 2, 3, 11, 12, 13, 14, 21, 22

Does AddressDoctor provide Locality and Street Address Codes for Germany?

Yes, AddressDoctor now provides the following enrichment output fields for German addresses:
- DEU_AGS. The Amtliche Gemeindeschlüssel (AGS) is a variable length code that uniquely identifies a locality in Germany. There may be more than one locality for a given AGS code.
- DEU_LOCALITY_ID. The Locality ID is a variable length code that uniquely identifies a German locality.
- DEU_STREET_ID. The Street ID is a variable length code that uniquely identifies a German street address.

You must have the new supplementary databases for Germany as well as at least version 5.4.1 of the software library in order to leverage this functionality.

For example, if you enter the following address:
Röntgenstr. 9
67133 Maxdorf
Germany

AddressDoctor returns the following enrichment outputs:
DEU_AGS: 07338018
DEU_LOCALITY_ID: 68015519
DEU_STREET_ID: 100560690

Is IBGE Code for Brazil available?

Yes, AddressDoctor provides the Brazilian Institute of Geography and Statistics (IBGE) code as an enrichment output field for Brazilian addresses. For ecommerce, a government agency in Brazil publishes a list of cities/states and their official numeric seven digit code called the IBGE code. This code is used for taxation and auditing purposes. Every order that gets placed is eventually cross-referenced with the city and state to get the associated IBGE code.


You must have the new supplementary data for Brazil, BRA5E1.MD, as well as at least version 5.4.1 of the software library in order to leverage this functionality.


For example, if you enter the following address:
Rua da Matriz 9
Centro
Glória do Goitá-pe
55620-000
Brazil


AddressDoctor returns the following enrichment output:
IBGE_CODE: 2606101

Does AddressDoctor provide the National Address database ID for South Africa?

Yes, AddressDoctor provides the National Address Database (NAD) ID as an enrichment output field for South African addresses. The NAD ID is a unique numeric ID assigned to each street address. You must have the supplementary database for South Africa as well as at least version 5.4.1 of the software library in order to leverage this functionality.


For example, if you enter the following address:
4 Balfour Road
Vincent
East London
5247
South Africa


AddressDoctor returns the following enrichment output:
NAD_ID: 2153781

For which countries, Address Code Lookup is available?

With Address Code Lookup, you can enter a country specific address code and retrieve the complete or partial address for the code. Address Code Lookup is currently available for the following countries:

  • Germany: Amtlicher Gemeindeschlüssel (AGS)
  • Great Britain: Unique Delivery Point Reference Number (UDPRN)
  • Japan: Choumei Aza code
  • South Africa: National Address Database (NAD) ID
  • Serbia: Postal Address Code (PAK)
What is the difference between the geocoding databases that are available for download?

AddressDoctor provides three different databases to perform Geocoding Enrichments. The following table describes the point address geocoding databases.

<XYZ>5GC.MD

The Standard Geocode database that is used by customers today containing the following geo coordinates for locations:

EGC4: Geocode with partial postal code level accuracy (e.g. 795xx)

EGC5: Geocode with postal code level accuracy

EGC6: Geocode with locality level accuracy

EGC7: Geocode with street level accuracy

EGC8: Geocode with house number level accuracy (interpolated approximation).

 

<XYZ>5GCAP.MD

The High Precision Arrival Point database that calculates the geo coordinates for a point that is placed in the center of a street segment in front of the house.

 

<XYZ>5GCPC.MD

The Parcel Centroid database that calculates the geo coordinates for a point that is at the geographic center of the parcel of land.

 

Note: <XYZ> is the ISO-3 alphacode (ISO 3166) of the country.

In case no <XYZ>5GCPC.MD or <XYZ>5GCAP.MD database is available for a country or if the database contains only partial information, the standard Geocode database <XYZ>5GC.MD data will be used.

Category: Geocoding
What is Point Address Geocoding?

The point address geocoding process enables more reliable and precise “to the premise” geocoding points for properties and premises to help businesses analyze and assess location data for risk assessment, location analysis and direct marketing.   Point Address Geocoding uses techniques to precisely calculate the point based on the geographical center of the parcel of land.  AddressDoctor’s Point Address Geocoding offering is based on premium Navteq data and includes the following two types of point geo coordinates:

  • Arrival Point Geo coordinates - The geo coordinates are calculated for a point that is placed in the center of a street segment in front of the house.
  • Parcel Centroid Geo coordinates - The geo coordinates are calculated for a point that is at the geographic center of the parcel of land.

Point Address Geocoding is currently available for USA and Canada with AddressDoctor's Software Library.

Category: Geocoding
What does interpolated Geocoding mean?

Standard interpolated geocoding is a method of constructing new data points within the range of a discrete set of known data points.  For example, if you know the geo coordinates of the first and last houses on a street, you can interpolate the geo coordinates for a house in the middle of the street.

Category: Geocoding
Does AddressDoctor add the rural route information for Canadian addresses?

The AddressDoctor Software Library adds the rural route information to the address verification results. This means that the rural route is returned as part of the formatted address for rural addresses in Canada. This is available for the Batch, Interactive and Fast Completion modes. It should be noted that this functionality is not available for the Certified mode due to SERP rules and regulations.

Example:

Input:
4370 Lorimer Rd
Whistler V0N 1B4

Output:
4370 Lorimer Rd

RR 4

Whistler BC V0N 1B4

Process Status = C4
Address Type =”R”

What is the Extended Element Result Status (EERS)?

The Extended Element Result Status (EERS) code is a twenty character output string similar to the existing Element Result Status field for all valid or corrected addresses.  The EERS informs the user that additional information may be available in the reference database for the given address. 

Does AddressDoctor support Postal Address Code (PAK) for Serbia?

Post Serbia has introduced an additional six-digit Postal Address Code (PAK) which goes down to the street level. The PAK ensures that mail is delivered correctly and promptly to recipients in Serbia.  For items that are addressed to a P.O. Box, “poste restante” or to a military address, the PAK is not needed in the address.  AddressDoctor offers the PAK as an enrichment to Serbian addresses.

Example of an Address containing the PAK:

Mr. Petar Petrovic
Beogradska 3
BAJMOK

24210 BAJMOK

PAK 456769

SERBIA

www.posta.rs/struktura/eng/posalji/pismo-adresovanje.asp

What is the UK UDPRN (Unique Delivery Point Reference Number)?

The Unique Delivery Point Reference Number, or UDPRN, is an eight character code that uniquely identifies each postal address of the Royal Mail PAF database.  The UDPRN allows to keep a constant reference that remains uniquely tied to the physical delivery point regardless of any changes in the address.  Wit AddressDoctor Version 5.3.1., the UDPRN is available as an enrichment in the UK Supplementary database.

Does AddressDoctor provide the Japanese Address Code (Choumei Aza)?

AddressDoctor version 5.3.1 is providing the Japanese Address Code (Choumei Aza) as an enrichment to Japanese Addresses. The Choumei Aza code is an eleven digit code defining an unique delivery point for Japanese addresses.

Does AddressDoctor provide CEDEX information for French addresses?

With AddressDoctor's Software Library Version 5.3.1, customers can process CEDEX (Large Volume Receiver) types of addresses for France.

Example:

Sinopia Financial Services
Immeuble Ile de France
4 Place De La Pyramide
Puteaux
92912 Paris La Defense CEDEX
France

Category: Software Library
Does AddressDoctor support thirteen character abbreviation for Canadian localities?

With version 5.3.1 of AddressDoctor's Software Library, customers can use the thirteen character Canada Post locality abbreviations for Canadian address validation.  It should be noted that some municipalities in Canada have names which are 14 or more characters in length and the particular municipality does not see the need to abbreviate the names of these localities.  In such cases, the official name of the municipality will be output.

Does AddressDoctor offer Multi-Language Support for Canada?

Yes, with AddressDoctor Software Library 5.3.1, AddressDoctor offers Multi-Language Support for Canada. Customers in Canada can specify the language of the output or preserve the language of the input address.  This implies that customers can output an English address in French in Québec for example.  Please note that only Street Descriptors and Provinces are available in multiple languages in version 5.3.1.

For which countries does AddressDoctor provide National Change Of Address (NCOA)?

AddressDoctor currently offers NCOA for Germany, Austria and Switzerland using the AddressDoctor Data Quality Center or Web Services.

More information in National Change of Address.

Why is it important that an address validation software is certified by postal organizations?

Postal certifications serve as a standard for address data quality measurement and allow customers to benefit of postage discounts. They are an absolute necessity if you plan to post bulk mail at discounted rates within specific countries. Customers like direct marketing agencies or online shops benefit from accurate addresses which culminates in more efficient and timely mail delivery.

Main benefits:

  • Mailing discounts for mass mailings in specific countries
  • Punctual and correct mail delivery thanks to valid addresses
  • Reduced costs, caused by inaccurate addresses and non-deliverable mail
  • Improved effectiveness of direct marketing activities
  • Strengthened customer retention with timely and accurate correspondence
Does AddressDoctor validate Irish postal addresses?

Yes. 

Due to popular customer demand, AddressDoctor has introduced support for Ireland in version 5.3.0. In Ireland, postal addresses do not use a postal code system. Rural addresses are specified by the county, nearest post town and the townland. Urban addresses are specified by county, city or town name, street name, house number, and apartment or flat number where relevant. A house name may be used instead of a number.

AddressDoctor’s new address validation software for Ireland is able to verify and correct those addresses built on a database containing almost 59,000 locality names and more than one million addresses. This enhancement will help customers ensure that mailings and shipments are correctly addressed in order to reach their destination in Ireland.

Irish mailing addresses are composed of the following elements:

  • Company or individual's name
  • House name (where applicable)
  • Street Address (including house number where applicable)
  • Town (prefix the town with "IE" if item is mailed within Europe)
  • County (not required for cities or county towns)
  • IRELAND (not required where town name is prefixed with "IE" and item is mailed within Europe)

Example of an Irish Address Format:
The Avalon Hotel
223 BURLINGTON ROAD
IE DUBLIN 4 -> Dublin and Cork use a 1 or 2 digit zone number.

Does AddressDoctor's Software Library support the British Forces Postal File (BFPO)?

Yes.

British Forces working abroad can take advantage of ordering goods online or via telephone. AddressDoctor has implemented the Royal Mail British Forces Post Office (BFPO) data into the Software Library Version 5.3.0. This information is available in the Royal Mail Postal Address File. Customers can ensure that goods ordered by Military personnel stationed abroad do not go astray.

An example of a BFPO address:

BFPO 802 -> Thoroughfare/Street
BFPO -> Post Town
BF1 1AB -> Postal Code
GBR

What does SNA certified mean?

Since July 2nd, 2012, AddressDoctor's Software Library is officially certified by the French postal organization La Poste. The SNA certification confirms that AddressDoctor complies with the high standards set by La Poste.

French Postal Organizations require French addresses to conform to certain rules and standards. Below is a summary of the most important rules for French addresses. For more information, contact the French Postal organization "La Poste" at www.laposte.com.

A certified address consists of 6 Formatted Address Lines (FALs)

If FALs are used for input they must follow this format as well

The FAL contains the following information:

  • Line 1 – Contact
  • Line 2 – Organization / Sub Building
  • Line 3 – Building Name
  • Line 4 – Street with House Number
  • Line 5 – PO Box / BP / Locality 2
  • Line 6 - CSLLN (Locality 1, postal code)

Additional localities identified, that are not associated to Locality 1, must be eliminated from the address

All other data must remain inside the address

Unidentified input must not appear in lines 4-6. It must be moved into lines 1 - 3

Every SNA address must contain a FAL 6 and a FAL 4

CEDEX postal codes must not be changed

Non-CEDEX postal codes may be changed, but not to a CEDEX postal code

What does HNO mean?

HNO is the abbreviation for house number, for example:

208 S Wilmington St
Raleigh NC 27601
USA

The house number (HNO) is “208”

What does SendRight mean?

Since 2008, the New Zealand postal authority offers a certification program to decrease the number of incorrectly addressed pieces of mail through the SendRight™ Address Accuracy Program. This program requires bulk mail customers to validate their postal addresses against New Zealand Post’s Postal Address File (PAF), and obtain a Statement of Accuracy (SOA). To obtain the certification which allows for a postal discount, an SOA percentage of 85% must be achieved. The portion of mail pieces with inaccurate addresses below this will be charged at the full standard mail rate. SendRight™ certification provides a process for address validation software to be tested for accuracy and quality address standards, and recognized as suitable to issue SOAs. AddressDoctor’s Software Library Version 5.3.0 has passed the certification program and was approved by New Zealand Post.

What is the Residential Delivery Indicator (RDI)?

The United States Postal Service (USPS) developed the Residential Delivery Indicator (RDI) product to provide shipping companies the information required to make informed shipping decisions.  AddressDoctor utilizes the RDI data during CASS certified processing to indicate if an address is classified as residential or business.

What is an Early Warning System (EWS)?

The United States Postal Service (USPS) developed the Early Warning System (EWS) as a way to increase address quality. The system is used to identify new construction addresses that have not been added to the USPS ZIP+4 database. These addresses are valid addresses and should not be changed as the USPS is in the process of assigning ZIP+4 codes.  AddressDoctor utilizes the EWS data during the CASS certified processing of addresses to inform customers that an address that isn’t currently in the ZIP+4 database we be added in the next database release.

Some of my addresses were not geocoded. What is the reason?

There are a number of possible reasons, why an address was not geocoded. They are written into the field OUT_GEOStatus. Possible values are:
0:    Geo coordinates are not provided, because you have no more
       geocoding transactions left.
1:    Geo coordinates are not provided, because geo coding is not
       available for this country.
2:    Geo coordinates are not provided, because the Validation Status
       was not V or C.
3:    Geo coordinates are not provided, because geo coding
       reported a no match.
4:    Geo coordinates are provided. The field OUT_GEOAccuracy
       describes the accuracy of the coordinates.

How can I remove the AddressDoctor Excel® Add-in?

To remove the AddressDoctor Excel® Add-in, you need to perform two steps:

  1. Disable the Excel® Add-in.
    To do this, start your Excel® and select "Tools" - "Add-ins" from the menu. This will show you the list of all available Add-ins, disable the check box for AddressDoctor.
  2. Delete the "AddressDoctor.xla" file from your hard drive
Category: Excel-Add-in
How many addresses can the Excel® Add-In process in an hour?

Depending on your Internet connection speed, approximately 60,000 to 100,000 addresses can be processed per hour.

Category: Excel-Add-in
Is AddressDoctor for Excel® able to process a list without country information?

With multi-country lists you have to indicate the country for each address. But there is the possibility of processing lists without any country specification, if all addresses are from the same country.

Category: Excel-Add-in
The Web Service returns the error message: "The string was not recognized as a valid Boolean value"

The AddressDoctor web service is case-sensitive. You need to deliver all Boolean values in all lower case like "false" or "true".

Category: Web Service
I am submitting data with accents (e. g. é) or umlauts (e. g. ü) and do not receive a meaningful response. What is wrong?

Most likely your request is improperly encoded. The AddressDoctor Web Service requires UTF-8 encoding. If you are not using a SOAP toolkit, please make sure that you are using the correct HTTP header (Content-Type: text/xml; charset=utf-8) and that the encoding of your data is proper. You can find an article about character encoding at http://msdn.microsoft.com/en-us/library/aa468560.aspx

Category: Web Service
I receive a server error 500. What is the cause?

The AddressDoctor Web Service will return an error 500 (server error) if the request is malformed. Most common reasons are wrong casing (all tags are case sensitive), incorrect casing of the URL embedded in the request or missing or incomplete tags such as a missing department (must be set to 0). Please make sure that your request is compatible with the WSDL available at http://validator2.addressdoctor.com

Category: Web Service
The Web Service returns some of my data in uppercase letters. Why does this happen?

The AddressDoctor Web Service will always return the data in a casing as described by the postal organizations of the destination country (unless the Capitalization parameter is set). So data for the UK or the US for instance, is always returned in upper case.

Category: Web Service
What character set does the AddressDoctor Web Service use?

 The AddressDoctor Web Service accepts requests in the UTF-8 character set.

Category: Web Service
What are the average processing time of the system?

The processing time for a single address without enrichments by the AddressDoctor web services is within 100ms to 2500ms.  Including transport time most USA users should expect a response within 1000ms (average).  Submitting additional addresses within a request or providing enrichments will increase this time.

Category: Web Service
What is the expected availability of the AddressDoctor web services?

AddressDoctor’s web services have provided over 99.9% availability since 2005.  Checks are made from servers in Dusseldorf, Germany and Washington, USA; availability can always be checked at:

www.websitepulse.com/publish/s0e0i4t8q.html

Category: Web Service
How long does it take to get access to the AddressDoctor system?

Access to the AddressDoctor web services is available within minutes. Simply create a user account yourself and you can start right away.

Category: Web Service
Understanding SERP Status Values
  • ESE0: SERP output not available (for this address)
    • You will receive this for addresses not within the CAN databases
  • ESE1: SERP attributes provided
    • You will receive this for addresses within the CAN databases
    This does not necessarily mean that the address is a valid address, just that the address was processed using the SERP processing
Understanding CASS Status Values
  • ECA0: CASS output not available (for this address)
    • You will receive this for addresses not within the USA databases
  • ECA1: CASS attributes only partially provided (some databases are missing)
    • You will receive this when processing and a database is missing during initialization of the AddressDoctor software library
  • ECA2..4: Reserved for future use
  • ECA5: CASS attributes provided
    • You will receive this for addresses within the USA databases
    • This does not necessarily mean that the address is a valid address, just that the address was processed using the CASS processing
Understanding Geocoding Status Values
  • EGCU: Geocoding database not unlocked
  • EGCN: Geocoding database not found
  • EGCC: Geocoding database corrupt
  • EGC0: No Geocode available
  • EGC1..4: Reserved for future use
  • EGC5: Geocode with postal code level accuracy
  • EGC6: Geocode with locality level accuracy
  • EGC7: Geocode with street level accuracy
  • EGC8: Geocode with house number level accuracy (interpolated approximation)
  • EGC9: Geo coordinates were calculated using arrival point geocoding without interpolation
  • EGCA: Geo coordinates were calculated using parcel centroid geocoding
Understanding Mailability Scores
  • 5: completely confident
  • 4: almost certain
  • 3: should be fine
  • 2: fair chance
  • 1: risky
  • 0: futile
Category: Software Library
Understanding Process Status Values
  • V4 Verified – Input data correct - all (postally relevant) elements were checked and input matched perfectly
  • V3 Verified – Input data correct on input but some or all elements were standardized or input contains outdated names or exonyms
  • V2 Verified – Input data correct but some elements could not be verified because of incomplete reference data
  • V1 Verified – Input data correct but the user standardization has deteriorated deliverability (wrong element user standardization – for example, postcode length chosen is too short). Not set by validation.
  • C4 Corrected – all (postally relevant) elements have been checked
  • C3 Corrected – but some elements could not be checked
  • C2 Corrected – but delivery status unclear (lack of reference data)
  • C1 Corrected – but delivery status unclear because user standardization was wrong. Not set by validation.
  • I4 Data could not be corrected completely, but is very likely to be deliverable – single match (e.g. HNO is wrong but only 1 HNO is found in reference data)
  • I3 Data could not be corrected completely, but is very likely to be deliverable – multiple matches (e.g. HNO is wrong but more than 1 HNO is found in reference data)
  • I2 Data could not be corrected, but there is a slim chance that the address is deliverable
  • I1 Data could not be corrected and is precodey unlikely to be delivered.
  • Q3 FastCompletion Status – Suggestions are available – complete address
  • Q2 FastCompletion Status – Suggested address is complete but combined with elements from the input (added or deleted)
  • Q1 FastCompletion Status – Suggested address is not complete (enter more information)
  • Q0 FastCompletion Status – Insufficient information provided to generate suggestions
  • RA Country recognized from ForceCountryISO3 Secodeing
  • R9 Country recognized from DefaultCountryISO3 Secodeing
  • R8 Country recognized from name without errors
  • R7 Country recognized from name with errors
  • R6 Country recognized from territory
  • R5 Country recognized from province
  • R4 Country recognized from major town
  • R3 Country recognized from format
  • R2 Country recognized from script
  • R1 Country not recognized - multiple matches
  • R0 Country not recognized
  • S4 Parsed perfectly
  • S3 Parsed with multiple results
  • S2 Parsed with Errors – Elements change position
  • S1 Parse Error – Input Format Mismatch
  • N1 Validation Error: No validation performed because country was not recognized
  • N2 Validation Error: No validation performed because required reference database is not available
  • N3 Validation Error: No validation performed because country could not be unlocked
  • N4 Validation Error: No validation performed because reference database is corrupt or in wrong format
  • N5 Validation Error: No validation performed because reference database is too old – please contact AddressDoctor to obtain updated reference data

Please note that for BATCH processing it is strictly recommended to only accept records with Vx or Cx status for automated data updates. Ix records need to be reviewed manually before using these results for any data update whatsoever.

Category: Software Library
What does "locality level data" mean?

Reference databases used by AddressDoctor can vary greatly in terms of data depth. Street and house number level data for numerous countries is available to AddressDoctor. This means that AddressDoctor verifies and - if necessary – corrects - street and house number data in an address. In ambiguous cases, for example an incorrect postal code or a locality name, the right address can be determined by means of the street information.

Some countries do not provide detailed address information because of their delivery system or internal structure. In these cases, AddressDoctor can still check addresses by locality and, if applicable, by postal codes. Elements for those addresses, where no reference file is available, are provided with the output-file.
In some countries, like in Kenya or the United Arab Emirates, mail is only delivered to post boxes. In these cases, there is no greater data depth necessary for standard delivery.

Independent from the reference data, AddressDoctor can always check input files with respect to their address format. By parsing an address, individual parts are identified in order to place them in the right place in the output file.

Our Opens internal link in current window country list shows the reference data depth for every country supported by AddressDoctor.

Where does the AddressDoctor reference data come from?

In most cases the reference data comes directly from the postal organizations of a country. If this isn't possible, other data suppliers like telecommunication organizations, direct marketing companies, or cartographic offices are consulted.

How do I obtain new databases?

Registered customers may download updated databases in our Opens internal link in current windowdownload section.

What does CASS, SERP, SNA, SendRight or AMAS Certified mean?

Five postal organizations worldwide offer an official certification process for address validation software: USPS, Canada Post, La Poste in France, New Zealand Post and Australia Post. AddressDoctor's Software Library has achieved their stringent address data cleansing and validation criteria and received all of the five following certifications:

  1. SendRight (New Zealand Post)

  2. SNA (La Poste France)

  3. CASS (USPS - Unites States Postal Service)

  4. AMAS (Australia Post)

    5. SERP (Canada Post)

How does AddressDoctor make sure the system is always available?

AddressDoctor employs the most recent technology in order to assure optimal system availability at all times. As a matter of course, the system is checked constantly and hosted on a highly available cluster.  An uptime report is available at: www.websitepulse.com/publish/s0e0i4t8q.html

Category: General Questions
I receive bad results when validating my addresses. What can be the reason for this?

Unfortunately, it may happen that the result of address cleaning is not satisfactory. The five most common reasons for this are

  • Incorrect Field assignment
  • Input data is missing too much information
  • Necessary fields have not been assigned
  • Too many unnecessary fields have been assigned
  • Corrupt input data
Category: General Questions
Is the province information returned by AddressDoctor using the ISO standard?

Province information (defined as State, Kanton, Prefecture, Province, Bundesland or County depending on the country) is returned as typically used by the postal operator in the respective country. In most cases postal administrations define a complete list of abbreviations to be used for addressing.

Category: General Questions
Which alphabets does AddressDoctor support?

AddressDoctor supports the following alphabets:

  • Transliteration of various Latin code page characters ISO 8859-X to Latin (Eastern and Northern European alphabets)
  • Greek (BGN/PCGN 1962, ISO 843 – 1997)
  • Cyrillic (BGN/PCGN 1947, ISO 9 – 1995)
  • Japanese Kana and Kanji
  • Chinese Pinyin transliteration (Mandarin, Cantonese) for both Simplified and Traditional Chinese
  • Korean Hangul
Category: General Questions
How are PO Boxes returned from AddressDoctor?

PO Boxes (along with other delivery service items) are returned in a discrete field, or as part of an address line.

How can I determine if a postal code is valid for a country?

Use the FastCompletion mode of the Web Service or of the AddressDoctor Software Library and pass the postal code as well as the country. You may then check the ElementMatchStatus value for the postal code (first position) to determine if the postal code exists in that country. If the code exists the first position of the ElementMatchStatus will contain a value of 4.

Category: General Questions
Is AddressDoctor able to guess the right country?

Even though our engine has some built-in features to detect a country, it will not always succeed in doing this and in some cases the country recognition may even fail. The only way to prevent this to always supply country information in a separate country field.

Category: General Questions
Does AddressDoctor parse out street directionals or street designators?

The AddressDoctor v5 Software Libraries (API) will return street pre/post directional and / or designators.  However at this time the AddressDoctor Web Services do not have the capability to return this information.

Category: General Questions
How does AddressDoctor correct / standardize an address?

The process of address validation / standardization can be divided into two actions:
Identifying the address element and comparing the data against reference tables.

In the first step, AddressDoctor tries to identify address elements and assigns them to the correct fields, this is called PARSING.
The identified address elements which are truncated or shortened will be changed to the proper form before the comparison takes place.

Address validation is the second step, in which the pre-structured address data is compared against reference tables supplied by postal organizations.
All relevant data will be used in this matching process. This differs from country to country, because some countries need address parts that are not existing or not relevant in other countries (e.g. post codes or province names), and the detail level supplied for this country. Some countries supply house number or building information, while others only give post codes for town parts. If all relevant input address parts create a single match, the address will be selected as result. This match does not need to be a complete match for all address parts - it can be a partial match for some.
If some of the components create a no match, AddressDoctor will check the addresses that created a match on the most address parts and will try to select the best of these addresses as the result. In many cases it is not possible to fully validate an address, because the matching will end in multi match or no match situation, where many address parts did or did not create a partial match. In these cases, AddressDoctor has a unique deliverability assessment feature that classifies addresses according to their probable deliverability.

Category: General Questions
Is there a different interface for each country?

All countries can be accessed through the same interface. This is what makes AddressDoctor so unique. Simply learn one interface and process data from the entire world.

Category: General Questions
What is the size of the AddressDoctor reference database?

The total size of the reference database (world coverage for address validation and geo-coding) is currently approximately32 GB (as of October 2013). This size is for the more than 240 supported countries and territories, including any CERTIFIED data, supplementary data, and geo-coding databases. As we continuously improve our database this size is likely to grow over time.

Can we extract the postal reference data from the databases?

The postal reference data cannot be extracted from AddressDoctor's reference database, this is due to licensing restrictions with our postal carriers.

How often is the AddressDoctor database updated?

Updates are available bi-annually, quarterly and monthly. The update frequency depends on the product purchased.  Update frequencies can be found on our Opens internal link in current windowcountries & data page.

Which Microsoft® Office versions are currently supported?

Version 2003 and 2007 have been successfully tested.
Version 2007 should work under normal conditions, unless Visual Basic® was not part of the Office 2007 installation.

In this case the following error message will most likely occur during the installation of the Excel® Add-In:
<q>This workbook has lost its VBA project, ActiveX controls and any other programmability-related features. Errors were detected in file "PATHNAME\AddressDoctor.xla"</q>

This happens because Visual Basic® is an optional Microsoft® Office component but is needed to run macros necessary for the AddressDoctor Excel® AddIn.
You can check if Visual Basic® was installed by taking a look at the Developer tab within Excel® 2007. Click the Office button, select Excel® Options and ensure that Show Developer tab in the Ribbon is ticked in the Popular set and then click OK.
A greyed-out Visual Basic® button indicates that it was not installed when Excel® (or Office) 2007 was installed. To install Visual Basic®, you need the original installation medium (DVD or downloaded file) for Excel® 2007 (or Office 2007) and use the customize option to select and install Visual Basic® for Applications which is located within Office Shared Features (see diagram).

Thus the AddressDoctor Excel® Add-In should function problem-free.

Category: Excel-Add-in
How do I import my processed data into Microsoft Excel®?

Start Excel.
Now select in the "Data" menu the option "Import External Data".

Select the file type of the file you want to import: "Text Files (*.txt;*.csv;*.tab;*.asc)".
Select the file you want to import.

Continue with "Import".

In the next step, select how the fields of your file are separated.Usually the software automatically detects the format and suggests the correct separator, in this example "Delimited".

Continue with "Next".

In the next step, state the field delimiter and the text qualifier.Here in the example we select as field delimiter "Comma" and as Text Qualifier quotation mark "{none}".

Continue with "Next".

In the next step you have the option to rename fields and to change data types.Set the field, which contains only numbers (e.g. ID or cluster sizes) to an appropriate data type, e.g. integer or double.Please note: Never set the data type of fields which contain postal codes to number! This would remove the leading 0-characters. The postal code 01438 would become 1438. This field, as the "OUT_PostalCode" field, should be declared as text.

Confirm your settings with "Next".

In the last step, select if you want to create a new worksheet or if you want to add the data to an existing worksheet.Click on "OK" to complete the export.

I did not receive my activation Email. What can I do to let the system send the Email again?

Add Opens window for sending emailservice(at)addressdoctor(dot)com to your list of authorized or safe senders. Log into the Data Quality Center, from the "Manage Jobs" menu select "List of Jobs" .Click the "Job ID", verify that e-mail address is correct. If necessary, update the e-mail address and press save, reclick the Job ID. On the bottom of the window click the word "ok" under "Field Assignments", click "Next" until you reach the Summary screen. Verify the information on the Summary screen and click "Finish". Upon clicking finish the system will regenerate the validation preview and send the activation e-mail.

 

Category: General Questions
How long does it take for my data to be processed?

The AddressDoctor Data Quality Center analyses your address data immediately after the file upload is completed. After the analysis, you will receive an email with instructions on how to confirm the job and start the processing. As soon as the Link contained in the e-mail has been clicked, the processing will start. Smaller files of less than 100.000 records are often finished in less than one hour. Larger files, especially those containing additional services, might take longer. However, in most cases these files will be ready within 24 hours. After processing is finished, you will receive an email with download Instructions.

Is it possible to upload my file via FTP?

No, at this time only the browser-based upload is available.

Which file formats can be processed in the DQC?

The DQC can currently process text files with separators and delimiters. Text files with fixed field length or other file formats, for instance Excel, have to be converted before upload.

I would like to have a change of address check (NCOA) performed on my address data. How can I do that?

NCOA processing is available in the AddressDoctor DQC. Please create an account if you do not already have one and fill out the required statement regarding the ownership of the address file. Once you have sent this agreement to our contracts department, the NCOA will be enabled for your DQC account. NCOA is available for Austria, Germany, and Switzerland.

I selected the country-specific Casing and English locality name in the DQC for German addresses. Why do I receive the corrected addresses in capital letters only, although the data records should actually be present in upper and lower case?

So that umlauts or other special characters can be converted into the English language, the transliteration algorithm is automatically called in the background. This requires the return of capital letters only.

What happens to non-assigned input fields?

The DQC output file contains all input fields, regardless if they were assigned or not. Following those are the output fields, which start with "OUT_". Non-assigned fields are not considered for address verification.

How long does AddressDoctor save data that has been uploaded in the AddressDoctor DQC?

When the time indicated below has elapsed, the input file (file that the user has uploaded), the corresponding processed data in the database and, if still available, the result file, and the report are deleted.

 

  • Deleted, non-confirmed orders or orders with processing errors: 30 days
  • Orders with generated Audit Report, but not yet downloaded: 180 days
  • Downloaded Orders: 270 days
How do I export my data from Microsoft Access in order to process them in the DQC?

Start Access and open the file, through the menu "File" -> "Open" or double-click on the Access file. Now you should see a picture similar to this:

Now click the right mouse button on the table which you want to export and select "Export" in the context menu.

In the next step, select the file type of the exported data. Select here "Text Files (*.txt;*.csv;*.tab;*.asc)". You can enter any name or, as in the example, keep the name which is suggested by the export wizard.

Continue with "Export".

In the export wizard you can set the properties of the CSV file. Select "Delimited".

Select "Advanced" to specify more detailed settings.

Code Page "Unicode UTF-8" is selected here in order to maintain the Japanese characters.

Confirm your settings with "OK".

Select as field delimiter "Semicolon" and as Text Qualifier quotation mark """. It's often helpful to select "Include Field Names on First Row".

Continue with "Next".

Click on "Finish" to complete the export.

When you open the exported file in an editor, it should have the following format:

How do I export my data from Microsoft Excel® in order to process them in the DQC?

Start Excel® and open the Excel® file, through the menu "File" -> "Open"or double-click on the Excel® file.

Now you should see a picture similar to this:

Now select from the "File" menu the option "Save As".

In the next step, select the file type of the exported data.

Select "CSV (Comma delimited) (*.csv)".

Continue with "Save".

When you open the exported file in an editor, it should have the following format:

Please note that you might have to change your "List separator" in Windows from comma to semicolon to obtain the same result - this isstrongly recommended as your data might well contain commas inside the actual Excel columns:

  1. Click the Windows Start menu.
  2. Click Control Panel.
  3. Open the Regional and Language Options dialog box.
  4. Click the Regional Options Tab.
  5. Click Customize.
  6. Type a new separator in the List separator box.
  7. Click OK twice.

You can also select as file type "Text (Tab delimited) (*.txt)" instead of CSV.

When you open the exported file in an editor, it should have the following format:

For comparison, the two output files, formatted from Excel® by default:

CSV, semicolon delimited:

TXT, tab delimited:

How do I import my processed data into Microsoft Access?

Start Access.

Create a new Database.

Click the right mouse button in the blank space and select "Import" from the context menu.

Select the file type of the file you want to import: "Text Files (*.txt;*.csv;*.tab;*.asc)". Select the file you want to import.

Continue with "Import".

In the next step, select how the fields of your file are separated.Usually, the software automatically detects the format and suggests the correct separator, in this example "Delimited".

Continue with "Next".

If the file contains characters which can't be displayed in the default selected encoding, select "Advanced"to specify more detailed settings.

In this example Code Page "Unicode (UTF-8)" is selected.

Confirm your settings with "OK".

The preview is adjusted instantly: Here you can see the Japanese characters.

Continue with "Next".

In the next step, state the field delimiter and the text qualifier.Here in the example we select as field delimiter "Semicolon" and as Text Qualifier quotation mark """.

If the file contains the field names in the first row, select "First Row Contains Field Names".

Continue with "Next".

Next you can select if you want to create a new table or if you want to add the data to an existing table.Here in this example we create a new table. Since we created a new database in the beginning, there isn't a table to which we can add the data.


Continue with "Next".

In the next step you have the option to rename fields and to change data types.Set the field, which contains only numbers (e.g. ID or cluster sizes) to an appropriate data type, e.g. integer or double.Plase note: Never set the data type of fields which contain postal codes to number! This would remove the leading 0-characters. The postal code 01438 would become 1438. This field, just as the "OUT_PostalCode" field, should be declared as text.

Confirm your settings with "Next".

In the next step you can set the primary key.

This is only necessary if the data sets are not numbered.

Continue with "Next".

In the last step you have to enter the name of the new table.

Click on "Finish" to complete the export.

How can I calculate the distance between two geo-coordinates?
Calculation of a distance between two geographical points in WGS84

It is very complicated to calculate the exact distance between two geographical coordinates since different projections as well as the oblateness of the earth has to be considered. But in most cases a simple formula will help as long as the distance is not too small and the points are not too close to the poles.

You will need WGS84 geo-coordinates in decimal degree (not in degree-minutes-seconds like N 49° 29.296 E 008° 27.722). All geo-coordinates provided by AdressDoctor are in decimal degree.

At first your geo-coordinates need to be transformed into a radian measure. To do this simply multiply the latitudes and longitudes by ?/180 or use in Excel =radiant(X) and =radiant(Y).

You will get the approximate air-line distance with following formula:

d = R * arccos(sin(X2) * sin(X1) + cos(X2) * cos(X1) * cos(Y2 – Y1))

Earth radius R = 6378 k

Example:

Lisbon, Portugal:

x-coord: 9.136523757581143
y-coord: 38.744916875859985

Arnheim, Netherlands:

x-coord: 5.962115675929862
y-coord: 51.98395045710915

Longitude/Latidude

Decimal Degree

Radiant

X1

9.136523757581

0.15946242

Y1

38.744916875860

0.67622637

X2

5.962115675930

0.10405855

Y2

51.983950457109

0.907291

Distance:

d = R * arccos(sin(X2) * sin(X1) + cos(X2) * cos(X1) * cos(Y2 – Y1))
d = R * arccos(sin(0.10405855) * sin(0.15946242) + cos(0.10405855) * cos(0.15946242) * cos(0.90729109 – 0.67622637))
d = 1503 km

What is the meaning of the field OUT_GEOAccuracy?

The field OUT_GEOAccuracy describes the accuracy of the coordinates.

To what detail level are addresses geocoded?

Where possible, addresses are geocoded to rooftop level. If this is not possible, they may be geocoded to the street, next fallback is center of a zip code or a locality. The detail level is written to the field OUT_GEOAccuracy. Possible values are:

The address was geocoded

STR

The Center of the street was geocoded

ZIPCD

The Center of a suburb within the postcode was geocoded

ZIPC

The Center of the locality within the postcode was geocoded

ZIP

The Center of the postcode was geocoded

What is the meaning of the field OUT_GEOStatus?

The field OUT_GEOStatus describes the possible reasons, why an address was not geocoded. 

Is the geocode set on the middle of the streets or is it offset?

If an address is geocoded to rooftop, it is offset from the center axis of the street.

Is the AddressDoctor Software Library USPS CASS (Coding Accuracy Support System) certified?

AddressDoctor 5 has been first certified by the United States Postal Service in March 2010.  As of July 2011, AddressDoctor v5.2.7 is CASS Cycle N certified.

Category: Software Library
Is the AddressDoctor Software Library Canada Post SERP (Software Evaluation and Recognition Program) certified?

Yes, AddressDoctor has achieved certification by Canada Post in March 2010. AddressDoctor completed certification for the SERP 2011 standard powered by the new Point of Call Address Data (PoCAD) from Canada Post.

Category: Software Library
What kind of information do I need to provide when contacting the AddressDoctor Support Team?

You may contact Informatica Global Customer Support at: http://www.informatica.com/us/services-and-training/support-services/global-support-centers/ 
When doing so, please make sure to provide the following XML files in a ZIP archive, after having run them through the ConsoleDemo application provided by AddressDoctor to check for reproducibility of your issue:

  • SetConfig.xml - may be retrieved using AD_GetConfigSecodeingsXML() (in Java: getConfigXML())
  • Parameters.xml - may be retrieved using AD_GetParametersXML() (in Java: getParametersXML())
  • InputData.xml - may be retrieved using AD_GetInputDataXML()(in Java: getInputDataXML())
  • Result.xml - may be retrieved using AD_GetResultXML()(in Java: getResultXML())
Category: Software Library
How do I analyze error conditions?

For C, AD_GetLastError() provides you with the last error return code and AD_GetExtendedErrorMsg() allows access to extended information pertaining to the last error. Error messages often point to configuration issues that are best analyzed by referring to GetConfig.xml or Parameters.xml.

For Java you use

AddressDoctorException.getExtendedMessage() for that same purpose. Please make sure to wrap AddressDoctor and AddressObject calls with try/catch blocks for proper exception handling – for a more detailed example see the code in the documentation:

try

{   

AddressDoctor.process(m_oAO);   

iLastError = AddressDoctor.getLastError();   

System.out.println("Process returned " + iLastError);

} catch (AddressDoctorException ex)

{   

System.out.println("Exception during process: " + ex.toString());

}

The ConsoleDemo test application in C and Java provided by AddressDoctor may prove helpful in analyzing error conditions.

Category: Software Library
How do I produce valid AddressDoctor XML?

Any XML input to the AddressDoctor Engine should always be well-formed and validated against the DTDs provided for that purpose by AddressDoctor. Please do note that the sequence of the XML elements does matter (but not that of their attributes), which can be checked through DTD validation as well.

Refer to wikipedia.org/wiki/XML for an introduction to XML. Apart from XML functionality being an integral part of most modern Integrated Development Environments (IDEs), there is a diverse choice of free validating XML editors, like WMHelp XMLPad or XML Copy Editor from SourceForge.net.

When dealing with XML files produced on different platforms, please note that end-of-line (EOL) characters differ between Windows (CR+LF) and UNIX (LF), see wikipedia.org/wiki/Linebreak.

Category: Software Library
How can I determine when the unlock code will expire?

Calling AD_GetConfigSecodeingsXML() will return a GetConfig.xml with the engine configuration, including unlock code information.

 

Category: Software Library
How often is the AddressDoctor Software Library updated?

A new software library is released several times a year. These libraries contain functional enhancements and bug fixes. Registered customers can download these libraries from our servers. Additional update information can be found Opens internal link in current windowhere.

Category: Software Library
Is AddressDoctor 5 multithreaded?

AddressDoctor 5 provides optimized multi-threading support presenting you with the ability to harness the power of current multi-core hardware architectures. Using multiple threads, you can scale your address processing throughput efficiently by processing multiple addresses in parallel on multiple processor cores.

Category: Software Library
Can one key unlock multiple countries or do I need one key per country?

One key can unlock multiple countries. More than one key is only required when the durations of the licenses differ.

Category: Software Library
How frequently is the reference database updated?

The reference data for geocoding is updated twice a year.This also applies for point address geocoding.

Category: Geocoding
What happens when we try to validate an address that is in a country that AddressDoctor is not able to process? Is an error returned?

AddressDoctor can process and cleanse data from more than 240 countries and territories. There are only few countries for which addresses cannot be processed. Currently (as of Fall 2011), addresses from Ireland, for example, cannot be validated. AddressDoctor marks Irish addresses with N2 (N2 = No validation because there is no reference data available).

Which platforms are supported?

The AddressDoctor software library is developed using the C++ programming language. The resulting API is available for C and Java, provided by a single combined AddressDoctor software library.

While the primary development platform is Windows and Microsoft Visual Studio 2005, the library is available for numerous hardware and software platforms. AddressDoctor 5 library packages are available for Windows, AIX, Solaris and Linux.

For more Information please click here.

Category: Software Library
What are the system requirements?

AddressDoctor has been designed to achieve the best possible performance while being highly efficient in its memory and resource usage. In order to ensure best possible performance, a fast I/O system and sufficient memory is recommended. As with most applications, the engine will perform better if more memory and a faster processor are installed. The minimum requirements are 512 MB of memory for validation operations and 128 MB of memory if parsing-only is required. In October 2011, the entire worldwide postal reference database requires around 15 to 20 GB of disk space. To optimize performance, the most commonly used databases should reside in memory. Thus it is recommended to have at least 1GB RAM available, up to several GB are needed for loading the full reference database set into memory. As this might well exceed the maximum amount of memory a 32 Bit operating system can access, AddressDoctor strongly recommends using 64 Bit operating systems in production.

Category: Software Library
For what countries does AddressDoctor supply Geocodes?

Please go to Country List and select "Geocoding" to get a current list of all countries supporting Geocoding of addresses.

Are addresses interpolated or referenced exactly to rooftop?

If a geocoded address contains the value ADD in the field OUT_GEOAccuracy, it is an interpolated house number. This means, the exact coordinates for the address are not contained in the reference database. Instead, the position of a street and the range of house numbers of this street are known. Then, the address is interpolated and offset to the proper side of the street.

What am I allowed to use the geocodes provided by AddressDoctor for?

You may use the geocoded addresses for internal applications only. It is not allowed to use the data for internet applications or to redistribute them to third parties. If you plan to do so, please Opens internal link in current windowcontact us.

Category: Web Service
What Coordinate System are the coordinates in?

Addresses delivered by AddressDoctor are assigned coordinates of the World Geodetic Coordinate System of 1984 (WGS84). These coordinates are in decimal degrees.

Category: Web Service, Geocoding
Are the reference data bases for address cleansing and geocoding identical?

No, the reference databases are not identical. The reference databases are designed for their specific purposes and thus are provided by different organizations; they differ in their design, data format and contents.

Which AddressDoctor products provide geocoding functionality?

At present, the AddressDoctor batch and interactive Web Services provide geocoding functionality. You may geocode your addresses using the Data Quality Center, AddressDoctor for Excel or by creating your own application to access the web services. The AddressDoctor 5 Software Library introduces built in geocode enrichment as well.

Category: Web Service, Geocoding