Vyhledání adresy na základě textu

HTTP

GET https://free.asapi.eu/address/search

Parametry requestu

Parametr	Typ/Hodnota	Popis
key	uuid	Přístupový klíč
country	cz \| sk	Země kde se bude vyhledávat (podle nastavení konkrétního uživatele, pro bezplatné použití je možné zvolit jen jeden jazyk)
pageSize	číslo	Omezení počtu výsledků, které budou vráceny (maximální počet je dle nastavení konkrétního uživatele, pro bezplatné použití je maximum 10 vrácených záznamů)
wkt	true \| false	Určuje zda ve výsledku mají být obsaženy geografické informace
additional	true \| false	Určuje zda ve výsledku mají být obsaženy dodatečné informace k adresním místům
text		Text na základě kterého budou vyhledány adresní místa

Příklad volání

HTTP

GET 'https://free.asapi.eu/address/search?key=5017ee7c-9411-5514-b287-09ff57a387b6&country=cz&country=sk&pageSize=5&wkt=true&additional=true&text=us pr'  HTTP/1.1

Příklad výsledku

JSON

[
    {
        "Code": "CZ.17790689",
        "Country": "CZ",
        "City": "Ústí nad Labem",
        "District": "Ústí nad Labem-město",
        "Area": "Předlice",
        "Street": "náměstí Prokopa Velikého",
        "HouseNumber": "12",
        "OrientationNumber": "7",
        "Zip": "40001",
        "WKT": {
            "EPSG": 4326,
            "Location": "POINT (13.987411927764393 50.65818478569732)",
            "Parcel": "POLYGON ((13.987266829831881 50.65807755114704, 13.987299951036299 50.6581175362508, 13.987313356862343 50.658132200503054, 13.987359968781687 50.65818204410691, 13.987459488149517 50.658286755678915, 13.987560871551555 50.65824650667104, 13.987711153430912 50.658189011925565, 13.987544965992617 50.65796887193111, 13.98745976884525 50.65800387667302, 13.987481977756827 50.65803587316624, 13.987387467591542 50.65806339848552, 13.987371763526774 50.65804688983626, 13.98736692851567 50.65804172614442, 13.987339738064309 50.658051415746876, 13.987266829831881 50.65807755114704))"
        },
        "AdditionalInfo": {
            "StavebniObjekt": {
                "Id": "SO.17662460",
                "PocetBytu": 3,
                "PocetPodlazi": 2,
                "ZastavenaPlocha": 226,
                "DruhKonstrukceKod": 10,
                "Dokonceni": "2000-12-31T00:00:00"
            },
            "Parcela": {
                "Id": "PA.1301025510",
                "DruhCislovaniKod": "2",
                "KmenoveCislo ": "972",
                "PododdeleniCisla": "1",
                "VymeraParcely": "567",
                "DruhPozemkuKod": "13"
            }
        }
    },
    {
        "Code": "SK.10282481",
        "Country": "SK",
        "City": "Trstená",
        "Area": "Ústie nad Priehradou",
        "OrientationNumber": "379",
        "Zip": "02801",
        "WKT": {
            "EPSG": 4326,
            "Location": "POINT(19.5841173 49.3819712)"
        },
        "AdditionalInfo": {
            "buildingTypeCode": "10",
            "buildingTypeName": "Rodinný dom"
        }
    },
    {
        "Code": "CZ.17790697",
        "Country": "CZ",
        "City": "Ústí nad Labem",
        "District": "Ústí nad Labem-město",
        "Area": "Předlice",
        "Street": "náměstí Prokopa Velikého",
        "HouseNumber": "13",
        "OrientationNumber": "9",
        "Zip": "40001",
        "WKT": {
            "EPSG": 4326,
            "Location": "POINT (13.987058036837766 50.65832397221732)",
            "Parcel": "POLYGON ((13.986767596061217 50.65805616812266, 13.986858125707688 50.65814879857036, 13.986919200006076 50.65821621851199, 13.98704251215151 50.658368056938535, 13.987116486161527 50.658456815522065, 13.9871184642423 50.65845881236665, 13.987213126757718 50.65841985773929, 13.9872098906439 50.65841583891608, 13.987288753307002 50.6583759879015, 13.987287974886474 50.658374372952494, 13.987280547860765 50.65836107146745, 13.987225524464181 50.65830228673769, 13.987240629871815 50.65829739806112, 13.987213637373797 50.65826887042818, 13.987204599627745 50.65824624916991, 13.987169123717228 50.658200872495655, 13.98718968328396 50.65818195013598, 13.98717497928046 50.65816544186418, 13.987299951036299 50.6581175362508, 13.987266829831881 50.65807755114704, 13.987250325400243 50.65806142356936, 13.98722881215259 50.65803394066487, 13.987213890369254 50.658015232844654, 13.987199745740417 50.65799941133856, 13.987137743099069 50.65802027488261, 13.987064707850763 50.65791343784013, 13.986767596061217 50.65805616812266))"
        },
        "AdditionalInfo": {
            "StavebniObjekt": {
                "Id": "SO.17662478",
                "PocetBytu": 2,
                "PocetPodlazi": 1,
                "ZastavenaPlocha": 241,
                "DruhKonstrukceKod": 9
            },
            "Parcela": {
                "Id": "PA.1301029510",
                "DruhCislovaniKod": "2",
                "KmenoveCislo ": "974",
                "VymeraParcely": "1134",
                "DruhPozemkuKod": "13"
            }
        }
    },
    {
        "Code": "SK.6511006194",
        "Country": "SK",
        "City": "Trstená",
        "Area": "Ústie nad Priehradou",
        "OrientationNumber": "114",
        "Zip": "02801",
        "WKT": {
            "EPSG": 4326,
            "Location": "POINT(19.584692775843 49.3808200571238)"
        },
        "AdditionalInfo": {
            "buildingTypeCode": "10",
            "buildingTypeName": "Rodinný dom"
        }
    },
    {
        "Code": "CZ.17790701",
        "Country": "CZ",
        "City": "Ústí nad Labem",
        "District": "Ústí nad Labem-město",
        "Area": "Předlice",
        "Street": "náměstí Prokopa Velikého",
        "HouseNumber": "14",
        "OrientationNumber": "10",
        "Zip": "40001",
        "WKT": {
            "EPSG": 4326,
            "Location": "POINT (13.986872591277683 50.658482156818955)",
            "Parcel": "POLYGON ((13.986372249363384 50.658090397084415, 13.986548627109494 50.658295756914875, 13.98664479987192 50.65838554196472, 13.986842291440492 50.658580294025995, 13.987116486161527 50.658456815522065, 13.98704251215151 50.658368056938535, 13.986919200006076 50.65821621851199, 13.986858125707688 50.65814879857036, 13.986767596061217 50.65805616812266, 13.986677560690977 50.65796957679589, 13.986649328646749 50.65798071517259, 13.98655454792523 50.65801829622467, 13.986422290966706 50.65807062241871, 13.986372249363384 50.658090397084415))"
        },
        "AdditionalInfo": {
            "StavebniObjekt": {
                "Id": "SO.17662486",
                "PocetBytu": 6,
                "PocetPodlazi": 3,
                "ZastavenaPlocha": 444,
                "DruhKonstrukceKod": 10
            },
            "Parcela": {
                "Id": "PA.1301036510",
                "DruhCislovaniKod": "2",
                "KmenoveCislo ": "981",
                "VymeraParcely": "1629",
                "DruhPozemkuKod": "13"
            }
        }
    }
]

Popis parametrů výsledku

Parametr	Typ	Popis
Code	string	Jednoznačný kód adresního místa
Country	string	Kód země, ISO 3166-1
State	string	Stát
Province	string	Provincie
Region	string	Kraj nebo region
County	string	Okres
City	string	Město/obec
District	string	Městský obvod
Area	string	Část města/obce
Street	string	Ulice
BuildingName	string	Název budovy
HouseNumber	string	Číslo domovní
OrientationNumber	string	Číslo orientační
OrientationNumberSign	string	Znak čísla orientačního
HouseNumberType	string	Typ čísla, např. "č.p." nebo "č.ev."
Zip	string	PSČ
WKT	json	Geografické informace
{
EPSG	string	Standardizovaný systém kódů pro identifikaci geodetických dat a souřadnicových referenčních systémů
Location	string	Souřadnice
Parcel	string	Hranice parcely
}
AdditionalInfo	json	Doplňkové informace k adresnímu místu
{
	json	Doplňkové informace jsou pro každou zemi specifické ...
}