Standardised Address
Standardised address is a service that parses and structures address information into a predefined data model. The service accepts an address as input, typically provided as free text and returns the identified address components in separate fields in a structured JSON response.
Address data is often delivered as a single unstructured string where elements such as street name, street number, apartment, entrance, floor, postal code, city and country appear in different formats and in varying order. The purpose of the service is to interpret this input and map the detected elements to a consistent schema. Each identified component is returned as an individual field, for example: streetName, streetNumber, buildingName, entrance, floor, apartment, postalCode, city and countryCode.
Service must be called at least with addressLine -attribute, but you may choose to call the service with supplementary attributes: countryCode, city and postalCode which may increase the output quality of the service.
If additional geographical information can be derived from the input, the response may also include municipalityCode, municipalityName, districtCode, districtName, countyCode and countyName. These data points UC derives based on local authorities official reference data for addresses. Fields that cannot be identified from the input are returned as null.
The service processes one address per request and is available through the endpoint: POST /business-insight/address/standardize