Skip to content

Address validation and standardisation

Corrects errors and brings addresses into a standard form. For each address it finds, it tells you what it found and how certain the match is.

szegedkarasz9

Bp., V. ker. Váci u. 12.

bphegedusgyula4 1051

Example

example
bphegedusgyula4 1051
SettlementBudapest
StreetHegedűs Gyula utca
House number4
Postal code 1136

Flag: the 1051 you entered does not belong to this address. We flag the discrepancy; we do not silently overwrite it.

Match levelhouse level

What it standardises

Addresses

Splits them into fields and returns them with accents and the full street type. Adds the postal code, county and coordinates where the source contains them.

Restoring accents

“hegedus gyula u” becomes Hegedűs Gyula utca — including the double acute accent (ű).

Expanding abbreviations

The abbreviations “bp”, “ker” and “u” are expanded to their full, standard form.

Marking contradictions

If the postal code entered does not fit the street, we say so on a separate line. A silent correction is worse than the error: the person using the data does not know about it.

How to call it

A simple REST API with JSON responses. A uniform address object on every endpoint.

The details of the call — parameters, fields, error codes and examples — are in the API documentation. You can also view the raw response in the live demo with the “API response (JSON)” button.

GET /suggest?q=bp+hegedus+gyula+u+4

→ { query, suggestions: [ { settlement, street,
    house_number, postal_code, admin{ city_district },
    meta{ match_level } } ] }

In development

These functions are not currently part of the live service; the exception is batch address validation in the API (/clean, up to 1,000 rows per call).