A szolgáltatás az alábbi címen érhető el.
http://www.animare.hu/AnimareWebService/IRSZ.asmx
A Web Service eléréséhez hozzunk létre egy új alkalmazást, majd válasszuk a Project – Add Web Reference menüpontot. A megjelenő ablakban adjuk meg a szolgáltatás címét.
A szolgáltatás kereső függvényei DataSet típusú értéket adnak vissza. Amikor keresünk az adatbázisban, kétfajta eredménytáblát kaphatunk. A kisebb települések esetén csak a települések neve és a hozzájuk tartozó irányítószám van nyilvántartva. Ilyenkor a következő szerkezetű eredménytáblát kapjuk:
| Mezőnév |
Típus |
Megjegyzés |
| CityID |
int |
A település azonosító kódja |
| CountyName |
string(40) |
Megye neve |
| PostCode |
string(4) |
Irányítószám |
| CityName |
string(40) |
Település neve |
| CityNameExt |
string(20) |
Kiegészítő adat a településről |
A nagyobb települések esetén az irányítószámok utcákhoz vannak rendelve. Előfordul az is, hogy egy utca is részekre van osztva, és a részek más irányítószámmal rendelkeznek. Ez a felosztás történhet házszám vagy betű szerint. A következő településeken található utca szintű nyilvántartás: Budapest, Debrecen, Győr, Miskolc, Pécs és Szeged. Ha a keresésben olyan település is részt vesz, amely utcákra van bontva, akkor a következő eredménytáblát kapjuk:
| Mezőnév |
Típus |
Megjegyzés |
| CityID |
int |
A település azonosító kódja |
| CountyName |
string(40) |
Megye neve |
| PostCode |
string(4) |
Irányítószám |
| CityName |
string(40) |
Település neve |
| CityNameExt |
string(20) |
Kiegészítő adat a településről |
| StreetName |
string(60) |
Utca neve |
| StreetNameExt |
string(40) |
Kiegészítő adat az utcáról |
| Area |
string(10) |
Kerület |
| NumFrom |
int |
Részekre osztott utcák esetén a kezdő házszám |
| NumTo |
int |
Részekre osztott utcák esetén az utolsó házszám |
| NumFromChar |
string(2) |
Részekre osztott utcák esetén az első betű pl.: d |
| NumToChar |
string(2) |
Részekre osztott utcák esetén az utolsó betű pl.: e |
A lekérdezéshez két függvényt használhatunk. A SearchByPostCode segítségével egy megadott irányítószámhoz tartozó települések és utcák listáját kérhetjük le a szerverről.
public DataSet SearchByPostCode(int code)
A code paraméterben kell megadnunk az irányítószámot.
Ha település és utcanév szerint akarunk keresni, akkor a SearchByCity függvényt használhatjuk.
public DataSet SearchByCity(string city, string street)
A city paraméterben kell megadnunk a település nevét, a street-ben pedig az utca nevét. Bármelyik paraméterben megadhatunk üres sztringet, a szerver csak azt a paramétert veszi figyelembe, amely adatot tartalmaz. Amikor megadunk egy szöveget, akkor a keresés minden olyan találatot visszaad, amelynek elején a megadott szó szerepel. Például ha a településnévhez azt írjuk be, hogy ’békés’, akkor a találati listában Békés, Békéscsaba, Békéssámson, stb. is szerepelni fog.
Ha azt akarjuk, hogy a keresés csak azt adja vissza amit megadtunk, akkor a keresett szót idézőjelekben adjuk meg.