JavaScript is deactivated. Please activate JS for viewing this website.


FAQ - Web Service

Show all / Hide all

fold faq

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.

fold faq

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.

fold faq

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
fold faq

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 msdn.microsoft.com/en-us/library/aa468560.aspx

Category: Web Service
fold faq

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 validator2.addressdoctor.com

Category: Web Service
fold faq

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
fold faq

What character set does the AddressDoctor Web Service use?

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

Category: Web Service
fold faq

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
fold faq

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
fold faq

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
fold faq

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

fold faq

What is the meaning of the field OUT_GEOAccuracy?

The field OUT_GEOAccuracy describes the accuracy of the coordinates.

fold faq

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

fold faq

What is the meaning of the field OUT_GEOStatus?

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

fold faq

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.

fold faq

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.

fold faq

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.