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

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

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

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.

What character set does the AddressDoctor Web Service use?

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

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.

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

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.

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

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?

AddressDoctor geocodes addresses for the following countries:

• Andorra
• Australia
• Austria
• Belgium
• Brazil
• Canada
• Croatia
• Czech Republic
• Denmark
• Estonia
• Finland
• France
• Germany
• Gibraltar
• Greece
• Holy See
• Hungary
• Iceland
• Italy
• Latvia
• Liechtenstein
• Luxembourg
• Malta
• Mexico
• Monaco
• Netherlands
• New Zealand
• Norway
• Poland
• Portugal
• San Marino
• Singapore
• Slovakia
• Slovenia
• Spain
• Sweden
• Switzerland
• Turkey
• United Kingdom
• United States

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.