Algolytics DQ – online API 

Algolytics Technologies Sp. z o.o.
DQ-online v1.0  

Table of Contents 

For more Algolytics products visit us at https://algolytics.com/. 

Overview 

API for online and automatic address data cleaning. 

User operations 

Clean rows 

Method  POST 
Path  /api/scenario/code/remote/score?name=dqonline_auth&key=31b1108c-c2b3-4b7d-99f1-6b83def1c6a0 

A method for cleaning given rows of raw data. The order of the input rows is preserved in the output array. There are restrictions on combining address data properties, see Restrictions on combining address data properties for more details. All fields in the output structure are optional and depend on the process parameters. 

HTTP status codes

Status code  Usage 
200 OK  The request completed successfully. 
207 Multi-Status  There were errors cleansing some records. Records for which processing error has occurred may be partially cleansed. Such records will contain the [error] object in the resulting JSON object. 
401 Unauthorized  The request has not been applied because it lacks valid authentication credentials for the target resource. 
400 Bad Request  The request was malformed. The response body will include an error providing further information. 
415 Unsupported Media Type  The request entity has a media type which the server does not support. 
503 Service Unavailable  The request was well-formed but data cleansing is currently unavailable due to maintenance. 
5xx Unexpected Server Error  The server failed to fulfill an apparently valid request. If an unspecified error in range 500-599 occurred contact our support at support@algolytics.pl. 

Request structure 

Table 13. Request headers 
Name  Description 
Accept:  application/json;charset=UTF-8 
Content-Type  application/json;charset=UTF-8 

 

Table 14. Request fields 
Path  Type  Description 
secret_key  String  An authorization token obtained by the registration e-mail 
query.inputRows  Array  An array of input rows to be processed 
query.processParameters  Object  Parameters configuring the data cleansing process 
query.inputRows[].postalCode  String  [OptionalPostal code 
query.inputRows[].cityName  String  [Optional] City name 
query.inputRows[].streetName  String  [OptionalStreet name 
query.inputRows[].streetNumber  String  [OptionalStreet number 
query.inputRows[].apartmentNumber  String  [OptionalApartment number 
query.inputRows[].streetNumberAndApartmentNumber  String  [Optional] Concatenation of the street number and apartment number (alternative to separate fields: streetNumberapartmentNumber) 
query.inputRows[].streetNameAndStreetNumberAndApartmentNumber  String  [Optional] Concatenation of the street name, street number and apartment number (alternative to separate fields: streetNamestreetNumberapartmentNumber) 
query.inputRows[].voivodeshipName  String  [OptionalVoivodeship name 
query.inputRows[].countyName  String  [OptionalCounty name 
query.inputRows[].communeName  String  [OptionalCommune name 
query.inputRows[].generalData  String  [Optional] Concatenation of all address information available 
query.processParameters.activeModules  Array  Modules that will be used to process input data. Available values are: 

“ADDRESSES” (enables address processing)

“FINANCES” (enables finance scoring)

query.processParameters.includeSymbolicNames  Boolean  Enabling this option includes symbolic names (GUS TERYT identifiers) for cities, streets and communes on the output 
query.processParameters.includeGusZones  Boolean  Enabling this option includes GUS statistical region and census circuit information on the output, required by [FINANCES] module
query.processParameters.includeGeographicCoordinates  Boolean  Enabling this option includes geographic coordinates (latitude and longitude) on the output 
query.processParameters.includeBuildingsInfo  Boolean  Enabling this option includes number of flats and residents of the buildings on the output 
query.processParameters.includeDiagnosticInfo  Boolean  Enabling this option includes detailed information about the status of matching and geocoding on the output 

Response structure 

Table 15. Response headers 
Name  Description 
Content-Type  application/json;charset=UTF-8 

 

Table 16. Response fields 
Path  Type  Description 
result.response  Array  An array of output rows containing the cleansed data 
result.response[].cityName  String  Cleaned city name. 

Requires [ADDRESSES] module 

result.response[].cityDistrictName  String  Cleaned city district name. 

Requires [ADDRESSES] module 

result.response[].streetAttribute  String  Street attribute (e.g. ul., al., pl.). 

Requires [ADDRESSES] module 

result.response[].streetName  String  Cleaned street name (without street attribute). 

Requires [ADDRESSES] module 

result.response[].streetNameMajorPart  String  The main part of the street name (e.g. the surname of the patron). 

Requires [ADDRESSES] module 

result.response[].streetNameMinorPart  String  A less important part of the street name (does not always exist, e.g. the first name of the patron). 

Requires [ADDRESSES] module 

result.response[].streetNumber  String  Cleaned street number. 

Requires [ADDRESSES] module 

result.response[].apartmentNumber  String  Cleaned apartment number. 

Requires [ADDRESSES] module 

result.response[].addressId  String  Unique address identifier, constant in time. 

Requires [ADDRESSES] module 

result.response[].numberOfApartments  Number  Number of apartments according to the GUS. 

Requires [ADDRESSES] module 

result.response[].numberOfJuridicalPersons  Number  Number of juridical persons and organizational units located in a given building according to the REGON register. 

Requires [ADDRESSES] module 

result.response[].postalCode  String  Cleaned postal code with NN-NNN format where N is a digit (0-9). 

Requires [ADDRESSES] module 

result.response[].communeName  String  Cleaned commune name. 

Requires [ADDRESSES] module 

result.response[].countyName  String  Cleaned county name. 

Requires [ADDRESSES] module 

result.response[].voivodeshipName  String  Cleaned voivodeship name. 

Requires [ADDRESSES] module 

result.response[].citySymbol  String  Symbolic name for city (GUS TERYT identifier). 

Requires [ADDRESSES] module and [includeSymbolicNames] option enabled 

result.response[].cityDistrictSymbol  String  Symbolic name for city district (GUS TERYT identifier). 

Requires [ADDRESSES] module and [includeSymbolicNames] option enabled 

result.response[].streetSymbol  String  Symbolic name for street (GUS TERYT identifier). 

Requires [ADDRESSES] module and [includeSymbolicNames] option enabled 

result.response[].communeSymbol  String  Commune code with XXYYZZ format where XX is voivodship code, YY is county within voivodship code, ZZ is commune within county code. 

Requires [ADDRESSES] module and [includeSymbolicNames] option enabled 

result.response[].communeTypeName  String  Name of the commune type, one of: “gmina miejska”, “gmina wiejska”, “część miejska gminy miejsko-wiejskiej”, “część wiejska gminy miejsko-wiejskiej”. 

Requires [ADDRESSES] module and [includeSymbolicNames] option enabled 

result.response[].communeTypeSymbol  Number  Numeric symbol of the commune type, one of: 1 (for gmina miejska), 2 (for gmina wiejska), 4 (for część miejska gminy miejsko-wiejskiej), 5 (for część wiejska gminy miejsko-wiejskiej). 

Requires [ADDRESSES] module and [includeSymbolicNames] option enabled 

result.response[].statisticalRegionSymbol  String  Commune code, along with its type and statistical region in the given format: XXYYZZTRRRRRRRR where XXYYZZ is [communeSymbol], T is [communeTypeSymbol], RRRRRRRR is 8-digit statistical region code (GUS TERYT identifier). 

Requires [ADDRESSES] module and [includeGusZones] option enabled 

result.response[].censusCircuitSymbol  String  Commune code, along with its type, statistical region and census circuit within this region in the given format: XXYYZZTRRRRRRRRC where XXYYZZTRRRRRRRR is [statisticalRegionSymbol], C is census circuit within statistical region code (GUS TERYT identifier). 

Requires [ADDRESSES] module and [includeGusZones] option enabled 

result.response[].numberOfInhabitedApartmentsByGUS  Number  Number of inhabited apartments according to the GUS. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfInhabitantsByGUS  Number  Number of inhabitants according to the GUS. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfInhabitedApartmentsByPESEL  Number  Number of inhabited apartments according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfInhabitantsByPESEL  Number  Number of inhabitants according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomen  Number  Number of female inhabitants according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMen  Number  Number of male inhabitants according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_0_4_yearsOld  Number  Number of female inhabitants between 0 and 4 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_5_9_yearsOld  Number  Number of female inhabitants between 5 and 9 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_10_14_yearsOld  Number  Number of female inhabitants between 10 and 14 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_15_19_yearsOld  Number  Number of female inhabitants between 15 and 19 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_20_24_yearsOld  Number  Number of female inhabitants between 20 and 24 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_25_29_yearsOld  Number  Number of female inhabitants between 25 and 29 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_30_34_yearsOld  Number  Number of female inhabitants between 30 and 34 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_35_39_yearsOld  Number  Number of female inhabitants between 35 and 39 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_40_44_yearsOld  Number  Number of female inhabitants between 40 and 44 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_45_49_yearsOld  Number  Number of female inhabitants between 45 and 49 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_50_54_yearsOld  Number  Number of female inhabitants between 50 and 54 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_55_59_yearsOld  Number  Number of female inhabitants between 55 and 59 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenBetween_60_64_yearsOld  Number  Number of female inhabitants between 60 and 64 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfWomenOver_65_yearsOld  Number  Number of female inhabitants over 65 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_0_4_yearsOld  Number  Number of male inhabitants between 0 and 4 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_5_9_yearsOld  Number  Number of male inhabitants between 5 and 9 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_10_14_yearsOld  Number  Number of male inhabitants between 10 and 14 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_15_19_yearsOld  Number  Number of male inhabitants between 15 and 19 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_20_24_yearsOld  Number  Number of male inhabitants between 20 and 24 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_25_29_yearsOld  Number  Number of male inhabitants between 25 and 29 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_30_34_yearsOld  Number  Number of male inhabitants between 30 and 34 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_35_39_yearsOld  Number  Number of male inhabitants between 35 and 39 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_40_44_yearsOld  Number  Number of male inhabitants between 40 and 44 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_45_49_yearsOld  Number  Number of male inhabitants between 45 and 49 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_50_54_yearsOld  Number  Number of male inhabitants between 50 and 54 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_55_59_yearsOld  Number  Number of male inhabitants between 55 and 59 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenBetween_60_64_yearsOld  Number  Number of male inhabitants between 60 and 64 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMenOver_65_yearsOld  Number  Number of male inhabitants over 65 years old according to the PESEL register provided by the Ministry of Digitization. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].numberOfMicroEntrepreneurs  Number  Number of entrepreneurs located in a given building according to the REGON register. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].taxationAuthority  Number  Name of the tax authority competent for the address. 

Requires [ADDRESSES] module and [includeBuildingsInfo] option enabled 

result.response[].individualClientFraudStatistic  Number  PF statistic calculated according to the building’s location for individual clients. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].individualClientFraudScore  Number  PF score calculated according to the building’s location and its features for individual clients.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].individualClientDefaultStatistic  Number  PD statistic calculated according to the building’s location for individual clients.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].individualClientDefaultScore  Number  PD score calculated according to the building’s location and its features for individual clients.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].businessClientFraudStatistic Number  PF statistic calculated according to the building’s location for business clients. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].businessClientFraudScore  Number  PF score calculated according to the building’s location and its features for business clients. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].businessClientDefaultStatistic Number  PD statistic calculated according to the building’s location for business clients.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].businessClientDefaultScore Number  PD score calculated according to the building’s location and its features for business clients. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].entrepreneurFraudStatistic Number  PF statistic calculated according to the building’s location for entrepreneurs. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].entrepreneurDefaultStatistic Number  PD statistic calculated according to the building’s location for entrepreneurs.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].entrepreneurDefaultScore  Number  PD score calculated according to the building’s location and its features for entrepreneurs. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].averageIncome Number  Average estimated income index of people living in the micro-market. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].incomePercentile5  Number  5th percentile of the estimated income for people living in the micro-market. 

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].incomePercentile25  Number  25th quantile of the estimated income for people living in the micro-market.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].incomePercentile50  Number  Median of the estimated income for people living in the micro-market.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].incomePercentile75  Number  75th quantile of the estimated income for people living in the micro-market.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].incomePercentile95  Number  95th percentile of the estimated income for people living in the micro-market.

Requires [ADDRESSES]  and [FINANCES] modules and [includeGusZones] option enabled 

result.response[].statuses  String  Concatenation of matching and geocoding statuses in the given format: “<category:result>” or “<category>” where the category can take one of the values: “przypisanie niejednoznaczne“, “zmiana nazwy miejscowości“, “zmiana nazwy ulicy“, “dopasowanie“, “geokodowanie“. 

Requires [ADDRESSES] module and [includeDiagnosticInfo] option enabled 

result.response[].longitude  Number  East longitude degree value. 

Requires [ADDRESSES] module and [includeGeographicCoordinates] option enabled 

result.response[].latitude  Number  North latitude degree value. 

Requires [ADDRESSES] module and [includeGeographicCoordinates] option enabled 

result.response[].error  Object  Object indicating that an error occurred while processing the given row. Contains details about the error 
result.response[].error.message  String  An error message explaining that the input row was incorrect or an unexpected application error occurred 
result.response[].error.status  String  Numeric error representation. The following codes are provided: 

“001” – null input row, 

“002” – violation of Restrictions on combining address data properties, 

“500” – unexpected server error 

Example

curl -X POST   ‘https://server.address/api/scenario/code/remote/score?name=dqonline_auth&key=31b1108c-c2b3-4b7d-99f1-6b83def1c6a0′   -H ‘Accept: application/json;charset=UTF-8′   -H ‘Cache-Control: no-cache’   -H ‘Connection: keep-alive’   -H ‘Content-Type: application/json’   -d ‘{ 

    “query”: { 

        “inputRows“: [ 

            { 

                “cityName“: ” Warszawa  “, 

                “streetName“:”PRZESKOK”, 

                “streetNumber”:”2″, 

                “postalCode”:”00-031″ 

            }, 

            { 

               “generalData“: “spotkajmy się u mnie warszawa czerniakowska 36 m 38” 

            }, 

            { 

               “generalData“: “Piotrkowska Łódź“ 

            } 

        ], 

        “processParameters“: { 

            “activeModules“: [ 

                “ADDRESSES” 

            ], 

            “includeSymbolicNames“: true, 

            “includeGusZones“: true, 

            “includeGeographicCoordinates“: true, 

            “includeBuildingsInfo“: true, 

            “includeDiagnosticInfo“: true 

        } 

    }, 

    “secret_key“: “*****“ 

}’ 
{ 

    "name": "dqonline_auth", 

    "beginTime": "2019-07-12T10:53:27.429882Z", 

    "endTime": "2019-07-12T10:53:27.956312Z", 

    "result": { 

        "response": [ 

            { 
"statuses": "<dopasowanie: budynek, w którym nie ma mieszkań><geokodowanie: dopasowany budynek>", 
"addressId": "0919810_17763_2", 
"cityName": "Warszawa", 
"citySymbol": "0918123", 
"cityDistrictName": "Śródmieście", 
"cityDistrictSymbol": "0919810", 
"streetName": "Przeskok", 
"streetSymbol": "17763", 
"streetAttribute": "ul.", 
"streetNameMajorPart": "Przeskok", 
"postalCode": "00-032", 
"streetNumber": "2", 
"voivodeshipName": "mazowieckie", 
"countyName": "Warszawa", 
"communeName": "Warszawa", 
"communeSymbol": "146501", 
"communeTypeSymbol": 1, 
"communeTypeName": "gmina miejska", 
"statisticalRegionSymbol": "1465108007880", 
"censusCircuitSymbol": "14651080078803", 
"latitude": 52.2331780695409, 
"longitude": 21.0139327663374, 
"numberOfApartments": 0, 
"numberOfInhabitedApartmentsByGUS": 0, 
"numberOfInhabitedApartmentsByPESEL": 0, 
"numberOfInhabitantsByGUS": 0, 
"numberOfInhabitantsByPESEL": 0, 
"numberOfMen": 0, 
"numberOfMenBetween_0_4_yearsOld": 0, 
"numberOfMenBetween_5_9_yearsOld": 0, 
"numberOfMenBetween_10_14_yearsOld": 0, 
"numberOfMenBetween_15_19_yearsOld": 0, 
"numberOfMenBetween_20_24_yearsOld": 0, 
"numberOfMenBetween_25_29_yearsOld": 0, 
"numberOfMenBetween_30_34_yearsOld": 0, 
"numberOfMenBetween_35_39_yearsOld": 0, 
"numberOfMenBetween_40_44_yearsOld": 0, 
"numberOfMenBetween_45_49_yearsOld": 0, 
"numberOfMenBetween_50_54_yearsOld": 0, 
"numberOfMenBetween_55_59_yearsOld": 0, 
"numberOfMenBetween_60_64_yearsOld": 0, 
"numberOfMenOver_65_yearsOld": 0, 
"numberOfWomen": 0, 
"numberOfWomenBetween_0_4_yearsOld": 0, 
"numberOfWomenBetween_5_9_yearsOld": 0, 
"numberOfWomenBetween_10_14_yearsOld": 0, 
"numberOfWomenBetween_15_19_yearsOld": 0, 
"numberOfWomenBetween_20_24_yearsOld": 0, 
"numberOfWomenBetween_25_29_yearsOld": 0, 
"numberOfWomenBetween_30_34_yearsOld": 0, 
"numberOfWomenBetween_35_39_yearsOld": 0, 
"numberOfWomenBetween_40_44_yearsOld": 0, 
"numberOfWomenBetween_45_49_yearsOld": 0, 
"numberOfWomenBetween_50_54_yearsOld": 0, 
"numberOfWomenBetween_55_59_yearsOld": 0, 
"numberOfWomenBetween_60_64_yearsOld": 0, 
"numberOfWomenOver_65_yearsOld": 0, 
"numberOfJuridicalPersons": 158, 
"taxationAuthority": "Pierwszy Urząd Skarbowy Warszawa-Śródmieście"

            }, 

            { 
"statuses": "<dopasowanie: mieszkanie><geokodowanie: dopasowany budynek>", 
"addressId": "0918130_03385_36", 
"cityName": "Warszawa", 
"citySymbol": "0918123", 
"cityDistrictName": "Mokotów", 
"cityDistrictSymbol": "0918130", 
"streetName": "Czerniakowska", 
"streetSymbol": "03385", 
"streetAttribute": "ul.", 
"streetNameMajorPart": "Czerniakowska", 
"postalCode": "00-714", 
"streetNumber": "36", 
"voivodeshipName": "mazowieckie", 
"countyName": "Warszawa", 
"communeName": "Warszawa", 
"communeSymbol": "146501", 
"communeTypeSymbol": 1, 
"communeTypeName": "gmina miejska", 
"statisticalRegionSymbol": "1465058000722", 
"censusCircuitSymbol": "14650580007221", 
"latitude": 52.2045078912561, 
"longitude": 21.0501179239762, 
"numberOfApartments": 172, 
"numberOfInhabitedApartmentsByGUS": 70, 
"numberOfInhabitedApartmentsByPESEL": 96, 
"numberOfInhabitantsByGUS": 192, 
"numberOfInhabitantsByPESEL": 184, 
"numberOfMen": 76, 
"numberOfMenBetween_0_4_yearsOld": 5, 
"numberOfMenBetween_5_9_yearsOld": 3, 
"numberOfMenBetween_10_14_yearsOld": 4, 
"numberOfMenBetween_15_19_yearsOld": 4, 
"numberOfMenBetween_20_24_yearsOld": 5, 
"numberOfMenBetween_25_29_yearsOld": 2, 
"numberOfMenBetween_30_34_yearsOld": 6, 
"numberOfMenBetween_35_39_yearsOld": 4, 
"numberOfMenBetween_40_44_yearsOld": 3, 
"numberOfMenBetween_45_49_yearsOld": 7, 
"numberOfMenBetween_50_54_yearsOld": 5, 
"numberOfMenBetween_55_59_yearsOld": 5, 
"numberOfMenBetween_60_64_yearsOld": 1, 
"numberOfMenOver_65_yearsOld": 22, 
"numberOfWomen": 108, 
"numberOfWomenBetween_0_4_yearsOld": 3, 
"numberOfWomenBetween_5_9_yearsOld": 2, 
"numberOfWomenBetween_10_14_yearsOld": 4, 
"numberOfWomenBetween_15_19_yearsOld": 0, 
"numberOfWomenBetween_20_24_yearsOld": 3, 
"numberOfWomenBetween_25_29_yearsOld": 2, 
"numberOfWomenBetween_30_34_yearsOld": 10, 
"numberOfWomenBetween_35_39_yearsOld": 2, 
"numberOfWomenBetween_40_44_yearsOld": 7, 
"numberOfWomenBetween_45_49_yearsOld": 9, 
"numberOfWomenBetween_50_54_yearsOld": 6, 
"numberOfWomenBetween_55_59_yearsOld": 10, 
"numberOfWomenBetween_60_64_yearsOld": 5, 
"numberOfWomenOver_65_yearsOld": 45, 
"numberOfJuridicalPersons": 1,
"taxationAuthority": "Urząd Skarbowy Warszawa-Mokotów"

            }, 

            { 
"statuses": "<dopasowanie: ulica><geokodowanie: środek ulicy (50 i więcej budynków)>", 
"cityName": "Łódź", 
"citySymbol": "0957650", 
"streetName": "Piotrkowska", 
"streetSymbol": "16308", 
"streetAttribute": "ul.", 
"streetNameMajorPart": "Piotrkowska", 
"voivodeshipName": "łódzkie", 
"countyName": "Łódź", 
"communeName": "Łódź", 
"communeSymbol": "106101", 
"communeTypeSymbol": 1, 
"communeTypeName": "gmina miejska",
"latitude": 51.76038942579284, 
"longitude": 19.45830342478674

            }

        ] 

    }, 

    "error": null, 

    "sceuid": "4f63ab8f-bb0b-4131-bdfb-6a34e0a9d6ad" 

} 

Restrictions on combining address data properties 

It is forbidden to pass different properties, but with the same information (e.g. streetName and streetNameAndStreetNumberAndApartmentNumber both contain street name information). Therefore, the following groups of mutually exclusive properties can be distinguished: 

  • generalData | streetNameAndStreetNumberAndApartmentNumber | streetName 
  • generalData | streetNameAndStreetNumberAndApartmentNumber | streetNumberAndApartmentNumber | streetNumber 
  • generalData | streetNameAndStreetNumberAndApartmentNumber | streetNumberAndApartmentNumber | apartmentNumber 
  • generalData | postalCode 
  • generalData | cityName 
  • generalData | voivodeshipName 
  • generalData | countyName 
  • generalData | communeName 

Only one property from each group can be present at a time. Violation of these restrictions results in an 002 [error]. 

Additionals 

We can customize DQ to return additional information according to Your needs. For more information contact our support at support@algolytics.pl. 

Last updated 2019-04-08 07:39:06 PDT