Sadržaj stranice
Tri ID-ja
| Naselje | Ulica | Adresa | |
|---|---|---|---|
code | 072150 | 0721501047 | - |
id | NA.0005007000 | UL.0002066154 | KB.0022075271 |
gmlId (zastarjelo) | AdminUnitName.2186933782 | ThoroughfareName.2092387772 | Address.2184673104 |
Primjer: Ilica 1, Zagreb.
Što smo izmjerili
DGU bazu pratimo stalno. Kao primjer, usporedba dvaju izvoza (13. rujna i 1. studenoga 2026.): za svaki izmijenjeni zapis provjerili smo koji se ID promijenio.
| Između dva izvoza | Izmijenjeno | Novi gmlId | Novi id | Novi code |
|---|---|---|---|---|
| Naselja (6.760) | 85 | 85 | 0 | 0 |
| Ulice (54.461) | 17 | 17 | 1 | 0 |
| Adrese (1,68 mil.) | 10.765 | 10.765 | 75 | - |
code - službena šifra
Šifra iz Registra prostornih jedinica, ista ona koju koriste državni sustavi. Naselje ima 6 znamenki, ulica 10: šifra naselja + 4 znamenke ulice (072150 + 1047). Ne mijenja se kad se ulica preimenuje. Ovo je najtrajniji ključ, a ako vaš sustav već koristi te šifre, odmah se uklapa.
U našim mjerenjima nije se promijenila nijedna šifra, ni kod preimenovanja ni kod dijeljenja ulice.
API vraća šifru s vodećim nulama, ali ih ne morate slati: 72150 i 072150 su isto.
id - INSPIRE identifikator
DGU-ov službeni INSPIRE identifikator: dva slova, točka i 10 znamenki. NA. je naselje, UL. ulica, KB. kućni broj.
Po standardu bi trebao biti trajan, ali standard ne definira precizno što je "promjena" koja zahtijeva novi ID. DGU to tumači na svoj način. Kad se ulica preimenuje, id ostaje isti, i za ulicu i za sve njezine kućne brojeve. Kad se od velike ulice odvoji dio u novu ulicu, standard bi tražio novi id samo za novu ulicu, ali DGU daje novi id i staroj. Službena šifra (code) stare ulice pritom je ostala ista.
Zato je za naselja i ulice code sigurniji izbor, a id je i dalje vrlo stabilan: između dva izvoza promijenio se za samo jednu ulicu od 54.461.
Zašto adresa nema code
Registar dodjeljuje šifre naseljima i ulicama, ali kućnim brojevima ne. Adresa zato ima samo id.
Taj id je trajan u velikoj većini slučajeva. Ponekad DGU kućni broj izbriše i upiše ponovno, pa on dobije novi id. Prema našim mjerenjima to se događa za nekoliko adresa na 100.000 mjesečno (između dva izvoza 75 od 1,68 milijuna adresa).
Što ako spremljeni ID vrati 404?
/api/search ili kroz popis kućnih brojeva ulice (/api/addresses?street_id=0721501047), i spremite novi id. Ako ste uz adresu spremili i code ulice, pronaći ćete je jednim pozivom.gmlId - zastarjelo
INSPIRE standard za gmlId ne propisuje stabilnost, nego je samo preporučuje. DGU ga mijenja pri svakoj izmjeni zapisa: kad se ulica preimenuje, kad se podijeli na dvije, kad se kućni broj pomakne na karti ili kad se ispravi bilo koji podatak. Između dva izvoza to se dogodilo za oko 10.900 zapisa, a svaki je dobio novi gmlId.
Zato ga ne preporučujemo spremati. API ga još vraća i prihvaća, ali će ga jedna od sljedećih verzija ukloniti. Ako ga već spremate, prijeđite na code i id: API prima gmlId pa ga možete jednokratno pretvoriti (dohvatite zapis po gmlId, spremite code/id).
API prima sva tri
Svaki endpoint koji traži ID (/api/settlements/{id}, /api/streets/{id}, /api/addresses/{id}, filteri settlement_id i street_id) prima code, id ili gmlId:
GET /api/streets/0721501047 GET /api/streets/UL.0002066154 GET /api/streets/ThoroughfareName.2092387772
Sva tri vraćaju istu ulicu, Ilicu u Zagrebu. Ako pošaljete ID druge vrste (npr. UL. na /api/settlements/), API vraća 400; ispravan oblik koji ne postoji vraća 404.
Bonus: općina i županija
Uz svako naselje dobivate općinu (ili grad) i županiju, također s id i code. Imena se ponavljaju (Otok, Privlaka i Sveta Nedelja postoje po dvaput), pa i ovdje kao ključ koristite code.