Pöördumine kaardirakendusse läbi URLi

Sisukord

Läbi URL-i pöördumise võimalus on eelkõige mõeldud pöördumiseks Maa-ameti maainfo kaardirakenduse poole mõnest veebipõhisest portaalist, kodulehelt või andmebaasist. Pöördumist saab teha kasutades parameetritena aadressi, koordinaate, katastriüksuse tunnust. Täpsema infot pöördumiste tehniliste võimaluste kohta leiate altpoolt.

Maa-ameti kaardirakenduste kasutamine on jätkuvalt kõigile tasuta, sõltumata kaardirakenduse poole pöördumise viisist.

Kui kasutate kaardirakenduse poole pöördumist läbi URL-i, siis palume viidata või muul moel ära märkida, et pöördutakse Maa-ameti X-GIS kaardirakenduse poole.

Pöördumise kasutuselevõtul mõnes suuremas portaalis või infosüsteemis palume sellest ka Maa-ametile teada anda aadressil kaardirakendus@maaamet.ee.

Pöördumine soovitud rakenduse poole:
URL-i kaudu on võimalik valida X-GIS'i rakendust, mille poole soovitakse pöörduda.

Parameeter	Selgitus
app_id	Rakendusele vastav kood: UU82 - Maainfo teenus UU75 - Maanteeameti rakendus UU38 - Mullakaart UU43A -Avalikustatud detailplaneeringud UU41 - Ajaloolised kaardid UU217 - Nitraaditundlikud alad UU42 - Natura 2000 kaart UU218 - Pärandkultuuri rakendus UU62A - Looduskaitse rakendus UU204 - Kitsenduste kaart UU60 - Kultuurimälestised

Näide Maainfo teenuse poole pöördumisega
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at
Näite link
Näide Avalikustatud detailplaneeringute rakenduse poole pöördumisega
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU43A&user_id=at
Näite link

Pöördumine otsingupaneeli funktsionaalsuse kaudu

Parameeter	Selgitus
searchid	UUOTS_GKY_82 - Katastriüksuste otsing UUOTS_DP_43A - Avalikustatud detailplaneeringute otsing UUOTS_DP_43 - (suunatud) detailplaneeringute otsing UUOTS_KYKITA - Kitsenduste otsing UUOTS_KYKPOA - Kitsendusi põhjustavate objektide otsing

Näide 1: pöördumine katastriüksuse tunnusega
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &searchid=UUOTS_KY_82&tunnus=41201:004:0067
Näite link
Näide 2: pöördumine mitme katastriüksuse tunnusega
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &searchid=UUOTS_GKY_82&tunnus=78403:301:0149|78403:302:0090
Näite link
Näide 3: pöördumine avalikustatud detailplaneeringu nimega
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU43A&user_id=at& searchid=UUOTS_DP_43A&nimetus_ametlik=Kuristiku
Näite link
Näide 4: katastriüksuse kitsenduste otsing KÜ tunnuse järgi
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU204&user_id=at &searchid=UUOTS_KYKITA_204&tunnus=39201:001:0143
Näite link
Näide 5: KÜ-d kitsendavate objektide otsing
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU204&user_id=at &searchid=UUOTS_KYKPOA_204&tunnus=39201:001:0143
Näite link

Pöördumine koordinaatpaari ja mõõtkava-arvuga
Parameeter Selgitus
PUNKT Y,X (L-est)
MOOT Kaardi mõõtkava-arv
Näide:
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &punkt=545280.74,6588555.21&moot=2000
Näite link
Pöördumine nähtavusulatusega
Parameeter Selgitus
PUNKT Y,X (L-est)
ZOOM Kaardi kõrgus meetrites
Näide:
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &punkt=545280.74,6588555.21&zoom=2000
Näite link
Pöördumine kaardiakna nurga L-Est97 koordinaatidega
Koordinaatide järjekord:
- - vasaku alumise nurga Y koordinaat
- - vasaku alumise nurga X koordinaat
- - parema ülemise nurga Y koordinaat
- - parema ülemise nurga X koordinaat
Näide:
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &bbox=544155.24,6587303.27,547074.56,6590005.45
Näite link

Pöördumine aadressotsingu poole

Parameeter	Selgitus
ADDRESS	Otsitav aadress
ADWHAT	Mida otsitakse? Ei ole kohustuslik. - täisaadress (vaikimisi) - lähiaadress - tunnus
ADWHERE	Otsingu tingimus. Ei ole kohustuslik. - täpne (vaikimisi) - algusest - lõpust - suvalisest
ADFILTER	Maakonna või omavalitsuse kood. Ei ole kohustuslik Vaikimisi kogu Eesti
ADX	Otsingupiirkonna raadiuse kese X koordinaat
ADY	Otsingupiirkonna raadiuse kese Y koordinaat
ADR	Otsingupiirkonna raadius
ADSHOW	Kas tulemus kuvatakse otse kaardile või kuvatakse vahenimekiri 1 - tulemus kuvatakse otse kaardile Puudub - kuvatakse otsingutulemus vahenimekirjana
ADFIT	Kas otsingutulemus mahutatakse kaardile? Kehtib ainult siis kui ADSHOW parameeter on 1 - mahutatakse

Näide 1:
Otsingustring "Kooli tee", täisaadress, suvaline katke, tulemused otse kaardile
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &address=Kooli%20tee&adwhat=1&adwhere=4&adshow=1&adfit=1
Näite link

Näide 2:
Otsingustring "Lai tn 4", lähiaadress, täpne, tulemused vahenimekirja
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &address=Lai%20tn%204&adwhat=2&adwhere=1
Näite link

Näide 3:
Otsingustring "62510:127:0001", KÜ tunnus, tulemus otse kaardile
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &address=62510:127:0001&adwhat=3&adshow=1&adfit=1
Näite link

Universaalne katastriüksuse aadressotsing

Parameeter	Selgitus
SEARCHID	Otsingukomplekti nimi, näiteks UUOTS_GKY_82
TUNNUS	Katastriüksuse tunnus. Mitme tunnuse korral eraldajaks \|
AADRESSTEKST	Katastriüksuse lähiaadress
PIKKAADRESS	Katastriüksuse täisaadress

Täpsem info aadresside süsteemi kohta on saadaval lehel Aadressandmete valdkond

Näide 1:
Katastriüksuse tunnusega otsing
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &searchid=UUOTS_GKY_82&tunnus=52001:005:0002
Näite link

Näide 2:
Katastriüksuse lähiaadressi otsing
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &searchid=UUOTS_GKY_82&aadresstekst=mustamäe%2051
Näite link

Näide 3:
Katastriüksuse täisaadressi järgi otsing
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82&user_id=at &searchid=UUOTS_GKY_82&pikkaadress=mustamäe%2051%20kristiine
Näite link

Katastriüksuse tunnuse päring koordinaadipaari ja raadiuse väärtusega

NB! Muutunud on skriptide poole pöördumiste urlid. PHP skriptide poole pöördumiste uus asukoht on nüüd geoportaal.maaamet.ee/url/

Päringuga saab teada, kas määratud koordinaatidel asub mõni katastriüksus või mitte. Vastavalt määratud raadiusele tagastatakse kõik piirkonda jäävad katastriüksuste tunnused.
Parameeter Selgitus
x X koordinaat (L-est, 2 komakohta)
y Y koordinaat (L-est, 2 komakohta)
d raadius meetrites (0-10m)
Punkti all on katastriüksus
Otsib kattumise 1m raadius, leiab ühe katastriüksuse
http://geoportaal.maaamet.ee/url/xgis-xy.php?x=6459630.00&y=644366.00&d=1
Otsib kattumise 2m raadius, leiab kolm katastriüksust
http://geoportaal.maaamet.ee/url/xgis-xy.php?x=6459630.00&y=644366.00&d=2
Näide kaardil:
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82
&user_id=at&punkt=644366.00,6459630.00&moot=500
Punkti all ei ole katastriüksust
Raadius 10m
http://geoportaal.maaamet.ee/url/xgis-xy.php?x=6459631.00&y=644342.00&d=10
Raadius 0m
http://geoportaal.maaamet.ee/url/xgis-xy.php?x=6459631.00&y=644342.00&d=0
Näide kaardil:
http://xgis.maaamet.ee/xGIS/XGis?app_id=UU82
&user_id=at&punkt=644342.00,6459631.00&moot=500
Katastriüksuse tunnuse ja aadressi päring geograafiliste koordinaatide väärtustega

NB! Muutunud on skriptide poole pöördumiste urlid. PHP skriptide poole pöördumiste uus asukoht on nüüd geoportaal.maaamet.ee/url/

Päringuga saab teada, kas määratud koordinaatidel asub mõni katastriüksus või mitte. Samuti saab pärida määratud koordinaadil asuva registreeritud katastriüksuse aadressi.
Parameeter Selgitus
lat Laius (WGS84, kümnendsüsteemis, DD.ddddd)
lon Pikkus (WGS84, kümnendsüsteemis, DD.ddddd)
out Päringu vastus (pikkaadress, aadress, tunnus, xgis)
Katastriüksuse pikkaadress
http://geoportaal.maaamet.ee/url/xgis-latlon.php?lat=58.2532694444&lon=26.4598111111&out=pikkaadress
Katastriüksuse aadress
http://geoportaal.maaamet.ee/url/xgis-latlon.php?lat=58.2532694444&lon=26.4598111111&out=aadress
Katastriüksuse tunnus
http://geoportaal.maaamet.ee/url/xgis-latlon.php?lat=58.2532694444&lon=26.4598111111&out=tunnus
Päringu punkt kaardil
http://geoportaal.maaamet.ee/url/xgis-latlon.php?lat=58.2532694444&lon=26.4598111111&out=xgis
Geograafilised koordinaadid L-Est süsteemis
http://geoportaal.maaamet.ee/url/xgis-latlon.php?lat=58.2532694444&lon=26.4598111111