FAQ

Frequently Asked Questions (FAQ)

Home > Support > FAQ > Web Service

FAQ - Web Service

/

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.

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.

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

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