Kevesebb visszaküldött csomag: címellenőrzés a pénztárban
A vásárló gépel, mi javaslunk: irányítószámból települést, településből utcát. Kijavítjuk az elgépelést, és szólunk, ha az irányítószám nem illik a címhez vagy az utca nem létezik — még a fizetés előtt, nem a futárnál.
Írjon be egy címet úgy, ahogy egy siető vásárló tenné
Ez ugyanaz a modul, amit a webshopba beépítünk. Gépelés közben javaslatot ad, a mezőből kilépve ellenőriz. Próbálja ki a lenti mintákkal is — ékezet nélkül, rövidítve, rossz irányítószámmal.
Mit lát a webshop?
Írjon be egy címet balra, vagy válasszon egy mintát fent.
Legközelebbi csomagpontok
- Az ellenőrzött cím után jelennek meg.
A teljes API-válasz (JSON)
—
Valódi bemenetek, valódi válaszok
Az alábbi táblázatot a lap építésekor az élő API-ból kértük le (2026-10-07), semmit nem írtunk át benne.
| Amit a vásárló beírt | Eredmény | Amit visszaadunk |
|---|---|---|
1117 bp irinyi 7rövidítés, kerület az irányítószámból | ✓ rendben | 1117 Budapest, XI. kerület, Irinyi József utca 7.az utca létezik, a házszám nem ellenőrizhető |
Szged, Karasz u 5elgépelt település és utca, hiányzó irányítószám | ! javítva | 6720 Szeged, Kárász utca 5.A település helyesen: Szeged. Az irányítószám: 6720. |
1133 Budapest, Váci út 12rossz irányítószám | ! javítva | 1132 Budapest, XIII. kerület, Váci út 12.Ehhez a címhez a(z) 1132 irányítószám tartozik, nem a(z) 1133. |
Budapest, Váci út 12négy kerületben is van Váci út | ? ellenőrizendő | Budapest, XIII. kerület, Váci út 12.Váci út 3 kerületben is van — kérjük, adja meg az irányítószámot. |
Mezokovesd, Mátyás kir. út 2ékezet nélkül, rövidítve | ! javítva | 3400 Mezőkövesd, Mátyás király út 2.Az utca helyesen: Mátyás király út. Az utca létezik; ezt a házszámot nem tudtuk ellenőrizni, mert nincs az adatbázisunkban. Az irányítószám: 3400. |
Kecskemét, Rákóczi u. 999nem létező házszám | ? ellenőrizendő | 6000 Kecskemét, Rákóczi út 999.Az utca helyesen: Rákóczi út. A(z) Rákóczi út házszámai nálunk 1–32 között vannak; ellenőrizze a(z) 999 számot. Az irányítószám: 6000. |
8600 Siofok, petofi setany 3kisbetű, ékezet nélkül | ✓ rendben | 8600 Siófok, Petőfi sétány 3. |
1054 Budapest, Szabadság tér 7. 3. em. 2.emelet és ajtó a címben | ✓ rendben | 1054 Budapest, V. kerület, Szabadság tér 7. 3. em. 2. |
Az eredmény négy állapota
| Állapot | Mit jelent | Mit tesz a pénztár |
|---|---|---|
| ✓ rendben | A cím létezik, az irányítószám illik hozzá. Ha a házszámot nem ismerjük, de az utca létezik, ezt külön jelezzük (hazszamEllenorizve: false). | Semmit, a vásárló megy tovább. |
| ! javítva | Egyértelmű javítás: elgépelés, rövidítés, rossz vagy hiányzó irányítószám. | Mutatja a javasolt címet „Elfogadom" gombbal; az üres irányítószámot magától kitölti. |
| ? ellenőrizendő | Több lehetőség van (pl. több kerületben azonos utcanév), vagy a házszám gyanúsan nagy. | Megkérdezi a vásárlót, választhat a javaslatok közül. |
| ✕ nem található | Nem találjuk a települést vagy az utcát. | Figyelmeztet; tiltani csak akkor tilt, ha a beállításban kéri. |
Négy ellenőrzés, egy kérés
Elgépelést tűr („Szged" → Szeged), Budapesten a kerületet is felismeri („bp xi. ker.", „1117").
A településen belül keres; a rövidítést kibontja („Mátyás kir. út"), a közterület-jelleget egyezteti („Rákóczi u." ↔ „Rákóczi út").
1 322 233 ismert házszám között; a „12/A", „5-7" alakot is érti, a túl nagy számot jelzi.
Összeveti a házszám vagy az utca irányítószámával; ha hiányzik, kitölti, ha rossz, javítja.
Adat: OpenStreetMap (ODbL), saját feldolgozásban; állapot: 2026-10-06, havonta frissül. Az OpenStreetMap nem ismer minden magyar házszámot (Budapesten 208 400, országosan 1 322 233 címet), ezért a házszám hiánya önmagában nem hiba — az utca és az irányítószám ellenőrzése így is kiszűri a gyakori tévedéseket.
WooCommerce-ben öt perc, máshol egy szkript
WooCommerce
- Töltse le a bővítményt (zip).
- Bővítmények → Új hozzáadása → Feltöltés.
- Beállítások → Tilezza címellenőrzés: kulcs beillesztése.
Klasszikus és blokkos pénztár, számlázási és szállítási cím, HPOS. A rendeléshez elmenti az eredményt és a koordinátát; a rendelés oldalán térképlink jelenik meg.
Bármely űrlap
Két sor a <head>-be, egy hívás az űrlap után. Nincs külső függőség, szigorú CSP mellett is működik.
Shopify: a pénztár csak Plus csomagban szabható; a modul a pénztár előtti címlapokra (fiók, kosár-űrlap) beépíthető.
REST API
Szerveroldalról is hívható: rendelés-importnál, futárcímke nyomtatása előtt, CRM-ben, ügyfélszolgálati felületen.
JSON-válasz, mezőnkénti állapottal, javasolt címmel és koordinátával.
JavaScript-modul
<link rel="stylesheet" href="https://tilezza.eu/lib/tilezza-cim-1.0.0.css">
<script src="https://tilezza.eu/lib/tilezza-cim-1.0.0.js"></script>
<script>
TilezzaCim.attach({
key: 'tlz_…', // a webshop domainjére zárt kulcs
irsz: '#billing_postcode',
telepules: '#billing_city',
utca: '#billing_address_1', // „utca + házszám" egy mezőben is lehet
kieg: '#billing_address_2',
onResult: function (v) { console.log(v.statusz, v.cim.egysoros); }
});
</script>REST API
| Kérés | Paraméterek | Mire való |
|---|---|---|
GET /geocode/okos?mode=cim | irsz, telepules, utca, hazszam, kieg — vagy egyben: cim= | Ellenőrzés: állapot, javasolt cím, koordináta |
…&kerdes=irsz | irsz | Mely település(ek), kerület tartozik hozzá |
…&kerdes=telepules | q, opcionálisan irsz | Településjavaslat gépelés közben |
…&kerdes=utca | telepules, q, opcionálisan irsz | Utcajavaslat a településen belül |
…&kerdes=hazszam | telepules, utca | Az utca ismert házszámai |
Alap-URL: https://tilezza.eu/geocode/okos · hitelesítés: &key=tlz_… (a kulcsot a vezérlőpulton a saját domainjére zárja) · egy kérés 2 egység.
Példa: rossz irányítószám
curl "https://tilezza.eu/geocode/okos?mode=cim&irsz=1116&telepules=Budapest&utca=Irinyi%20J%C3%B3zsef%20utca&hazszam=7&key=tlz_…"
{
"statusz": "javitva",
"cim": {
"irsz": "1117",
"telepules": "Budapest",
"kerulet": "XI. kerület",
"megye": "Budapest",
"utca": "Irinyi József utca",
"hazszam": "7",
"kieg": null,
"egysoros": "1117 Budapest, XI. kerület, Irinyi József utca 7."
},
"koordinata": [
47.476358,
19.056999
],
"pontossag": "kozeli-hazszam",
"hazszamEllenorizve": false,
"mezok": {
"irsz": {
"ertek": "1116",
"statusz": "javitva",
"javasolt": "1117"
},
"telepules": {
"ertek": "Budapest",
"javasolt": "Budapest",
"megye": "Budapest",
"statusz": "rendben"
},
"utca": {
"ertek": "Irinyi József utca",
"statusz": "rendben",
"javasolt": "Irinyi József utca"
},
"hazszam": {
"ertek": "7",
"statusz": "nem_ismert"
}
},
"uzenetek": [
"Az utca létezik; ezt a házszámot nem tudtuk ellenőrizni, mert nincs az adatbázisunkban.",
"Ehhez a címhez a(z) 1117 irányítószám tartozik, nem a(z) 1116."
]
}Példa: utcajavaslat
curl "https://tilezza.eu/geocode/okos?mode=cim&kerdes=utca&telepules=Szeged&q=kar&limit=3&key=tlz_…"
{
"telepules": "Szeged",
"kerulet": null,
"javaslatok": [
{
"nev": "Kárász utca",
"kerulet": null,
"irszek": [
"6720"
],
"hazszamok": 25,
"hazszamTartomany": [
1,
17
],
"pontos": false
},
{
"nev": "Károly híd",
"kerulet": null,
"irszek": [],
"hazszamok": 0,
"hazszamTartomany": null,
"pontos": false
},
{
"nev": "Károlyi utca",
"kerulet": null,
"irszek": [
"6720"
],
"hazszamok": 1,
"hazszamTartomany": [
4,
4
],
"pontos": false
}
]
}A Tilezza közös keretéből, rendelésenként kb. 16 egység
Egy címkérés 2 egység. Egy rendelés a gépelés közbeni javaslatokkal és a végső ellenőrzéssel együtt átlagosan kb. 8 kérés, azaz 16 egység. A keret ugyanaz, mint a térképé: ha a webshopban térkép is van, abból is ez fogy.
| Csomag | Ár | Egység / hó | Elég kb. |
|---|---|---|---|
| Starter | €8 / hó | 150 000 | ~9 300 rendelés / hó |
| Pro | €19 / hó | 500 000 | ~31 200 rendelés / hó |
| Scale | €79 / hó | 5 000 000 | ~312 500 rendelés / hó |
Az ingyenes csomag nem tartalmaz címkeresést. A fizetős csomagok indulásáig próbakulcsot adunk: info@digitaldynamics.hu. Nagyobb forgalomra, saját szerződéssel: Enterprise.
Miért nem a Google címkiegészítője?
| Tilezza címellenőrzés | Google Places Autocomplete | |
|---|---|---|
| Hol fut | Saját szerver az EU-ban | Amerikai cég globális infrastruktúrája |
| Mit csinál | Javasol és ellenőriz: irányítószám–település–utca–házszám egyezés, mezőnkénti állapot | Javasol; azt, hogy az irányítószám illik-e a címhez, külön kell megoldani |
| Magyar sajátosságok | Budapesti kerület, „bp", „u.", „krt.", ékezet nélküli bevitel | Általános, nemzetközi címkezelés |
| Az eredmény tárolása | A rendeléshez mentheti, a koordinátával együtt | A Google Maps Platform feltételei korlátozzák a találatok tárolását |
| Díjazás | Havi keret, előre ismert ár, nincs meglepetésszámla | Használat alapú |
| Lefedettség | Magyarország (Ausztria címtára előkészítve) | Az egész világ |
Ha a webshop külföldre is szállít, a modul csak a magyar címeknél kapcsol be; a többi országnál a mezők változatlanok maradnak.
Gyakori kérdések
Honnan jönnek a címadatok?
Az OpenStreetMap magyar címadataiból (ODbL licenc), amelyekből saját címtárat építünk: 1 322 233 házszám, 126 683 közterület, 3 156 település, 3 222 irányítószám. A címtárat havonta frissítjük az OpenStreetMap legújabb állapotából.
Mi történik, ha egy házszámot nem ismerünk?
Ha az utca létezik, de a házszám nincs az adatbázisunkban, a választ „rendben"-nek adjuk, és jelezzük, hogy a házszámot nem tudtuk ellenőrizni. A vásárlót ilyenkor nem akasztjuk meg: az OpenStreetMap nem ismer minden házszámot, de az utca és az irányítószám ellenőrzése így is kiszűri a legtöbb hibát.
Megakaszthatja a vásárlást?
Nem. Ha a szolgáltatás nem érhető el, a cím változatlanul megy tovább. Hibás címnél a bővítmény alapból csak figyelmeztet; tiltani csak akkor tilt, ha ezt a beállításokban bekapcsolja, és akkor is csak akkor, ha a települést vagy az utcát nem találjuk.
Felismeri a budapesti kerületeket?
Igen. Az irányítószám 2–3. számjegyéből (1117 → XI. kerület), a „bp xi. ker." alakból, illetve abból, hogy melyik kerületben van az utca. Ha egy utcanév több kerületben is előfordul (a Váci út például négyben), és a kerület nem derül ki, irányítószámot kérünk.
Hol fut a szolgáltatás, és mit tárolunk?
Saját szerveren, az EU-ban (Digital Dynamics Kft.). A beküldött címeket nem tároljuk tartósan és nem adjuk tovább; a forgalmat IP-cím nélkül, összesítve mérjük. Harmadik félhez, például a Google-hoz, semmilyen adat nem kerül.
Csak WooCommerce-szel működik?
Nem. A JavaScript-modul bármely űrlapra ráköthető (Shopify-témákban a pénztár előtti címlapokra, egyedi webshopokba, CRM-ekbe), a REST API-t pedig szerveroldalról is hívhatja, például rendelés-importnál vagy futárcímke előtt.
Mennyibe kerül?
A kérések a Tilezza közös keretéből fogynak: egy címkérés 2 egység. Egy rendelés a gépelés közbeni javaslatokkal együtt átlagosan kb. 16 egység, így a Starter csomag (€8/hó) kb. 9 300 rendelésre elég havonta. A fizetős csomagok indulásáig próbakulcsot e-mailben adunk.