Download - GFA Web Services Dokumentazio Teknikoa Lurralde ...€¦ · 1. Taula. Kontsulta motaren arabera eskatzen diren sarrera-parametroak Taularen interpretazioaren adibidea: Calle motako

GFA Web Services - Dokumentazio Teknikoa

| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua

GFA Web Services Dokumentazio Teknikoa

Lurralde Plangintzako Zerbitzua

Gipuzkoako Foru Aldundia



Edukiak

1 Sarrera

2 Web Zerbitzuen Deskribapen orokorra

3 Zerbitzuen Testa

3.1 Testa Web ingurunean 3.2 Testa, probazko aplikazioaren bitartez

4 ‘Consulta de Callejero’ Web Zerbitzua

4.1 ‘buscarcallejero’ eragiketa. 4.1.1 Deskribapen funtzionala 4.1.2 Sarrera-parametroak 4.1.3 Irteera-parametroak 4.1.3.1 Irteera-datuen egitura 4.1.3.2 Irteera-parametroen deskribapena 4.1.4 Kode bat adibide gisa

5 ‘Buscar Topónimo’ Web Zerbitzua

5.1 'toponimo' Eragiketa 5.1.1 Sarrera-parametroak 5.1.2 Irteera-parametroak 5.1.2.1 Irteera-parametroen deskribapena 5.1.3 Kode bat adibide gisa

6 ‘Dibujar Imagen’ Web Zerbitzua

6.1 ‘dibujarimagen’ Eragiketa 6.1.1 Sarrera-parametroak 6.1.2 Irteera-parametroak

6.2 Kode bat adibide gisa 6.3 ‘Mapas Disponibles’ Eragiketa

6.3.1 Sarrera-parametroak 6.3.2 Irteera-parametroak

7 ‘Localizar’ Web Zerbitzua 24

7.1 Kale-izendegiaren entitateen Kokapena 7.1.1 Sarrera-parametroak 7.1.2 Irteera-parametroak

7.2 Jasotze kartografikoen inbentarioko entitateen kokapena 7.2.1 Sarrera-parametroak



7.2.2 Irteera-parametroak 7.3 Ibai-entitateen Kokapena

7.3.1 Sarrera-parametroak 7.3.2 Irteera-parametroak

7.4 Toponimoen Kokapena 7.4.1 Sarrera-parametroak 7.4.2 Irteera-parametroak

7.5 Bideen Kokapena 7.5.1 Sarrera-parametroak 7.5.2 Irteera-parametroak

7.6 XY Koordenatuen Kokapena 7.6.1 Sarrera-parametroak 7.6.2 Irteera-parametroak

7.7 Kode bat adibide gisa

8 ‘Consultar’ Web Zerbitzua

8.1 Koordenatuak Kontsultatzeko Eragiketa 8.1.1 Sarrera-parametroak 8.1.2 Irteera-parametroak

8.2 Toponimia Kontsultatzeko Eragiketa 8.2.1 Sarrera-parametroak 8.2.2 Irteera-parametroak

8.3 Bideak Kontsultatzeko Eragiketa 8.3.1 Sarrera-parametroak 8.3.2 Irteera-parametroak

8.4 Kale-izendegia Kontsultatzeko Eragiketa 8.4.1 Sarrera-parametroak 8.4.2 Irteera-parametroak 38

8.5 Ibaiak Kontsultatzeko Eragiketa 39 8.5.1 Sarrera-parametroak 8.5.2 Irteera-parametroak

8.6 KartoFototeka Kontsultatzeko Eragiketa 8.6.1 Sarrera-parametroak 8.6.2 Irteera-parametroak


9 Ibilbidea Kalkulatu

9.1 Ibilbide baten Koordenatuak Kontsultatzeko Eragiketa 9.1.1 Sarrera-parametroak 9.1.2 Irteera-parametroak


DFG Web Services - Documentación Técnica

1 Sarrera

Dokumentu hau Gipuzkoako Foru Aldundiko Espazio-Datuen Azpiegiturara sartzea sustatzeko

garatutako Web Zerbitzuen Plataformaren deskribapen teknikoa da. Dokumentazioa Web

Zerbitzuetako irtenbide 'kontsumitzaileen' integratzailera zuzenduta daude, gaur egun

plataforman eskuragai daudenak, eta deskribapen funtzionala eta interfazeari dagokiona da,

horien funtzio bakoitzaren sarrera eta irteera parametroak zehazten dituelarik.

Funtzio horiek eta bere interfazea (sarrera eta irteera parametroak) ezagutzeak, beste aplikazio

batzuetan, Interneten bitartez, espazio-datuen bilketa kontsultatzeko funtzionalitate ezberdinak

integratzea ahalbidetzen du.

Zerbitzuak SOAP (Simple Object Access Protocol) eta WSDL estandarren arabera

inplementatu dira.

• SOAP estandarrak zerbitzuetara deiak burutzen dituen eta erantzunaren informazioa

jasotzen duen mekanismoa zehazten du. SOAP bezeroek zerbitzuak eskatzen dituzte XML

formatuan dauden objektuak HTTP protokoloaren bitartez pasatuz.

• WSDL (Web Service Definition Lenguaje) estandarrak Zerbitzu baten kanpoko interfazea

deskribatzen du, garatzaileek definizio horretan oinarrituta erabiltzeko gai diren bezeroak

sor ditzaten.

Estandar horietan oinarritutako zerbitzuen plataforma bat inplementatzeak bezero- eta zerbitzu-

aplikazioak elkar komunikatzea eta ulertzea ahalbidetzen du, ezberdinak diren garapen

plataforma eta lengoaia mota ezberdinen bitartez; eta ezberdinak dira ondoko baldintzak

betetzen dituztelako:

• Elkarreragingarritasuna: Zerbitzuetakoren bat erabiltzen duen aplikazio baten ez

dut zertan ezagutu zerbitzu horren hardware edo software plataforma. Zerbitzu

batera bezero mota ezberdinetatik sar daiteke (esaterako, Web aplikazioak,

wireless aplikazioak edo beste zerbitzu batzuk), beti ere zerbitzuaren estandar

teknologikoa erabiltzen bada.

• Enkapsulazioa: Zerbitzu-osagai bat erabiltzen duen aplikazio batek ez du kezkatu

behar horren programazioaren barruko xehetasunez.

Estandarrari buruzko informazio orokorra jasotzeko, Sun Microsystems, Inc –en honako dokumentazioa gomendatzen dugu:

http://java.sun.com/developer/technicalArticles/WebServices/soa2/WSProtocols.html#soatechs





2 Web Zerbitzuen Deskribapen orokorra

Web Zerbitzuen plataformak Zerbitzu jakin batzuk ditu eta bakoitzak egin daitekeen eragiketa

bat edo gehiago (funtzioak) eskaintzen ditu. Dokumentu honetan horietako bakoitza

deskribatzen da.

Zerbitzu bakoitzak “Web Service Home Page” izeneko web orri bat dauka (Ikus 1. Irudia. Web

Zerbitzuaren Home Page-aren Adibidea. Kontsulta Zerbitzua), WDSL fitxategira, test-orrira

edo “Editor Page” orrira sartzeko bidea ematen duena, JavaScript interfazearen

dokumentazioa, eta zerbitzuan erabil daitezkeen eragiketa edo funtzioen zerrenda.

WSDL (Web Service Descriptor Lenguaje) fitxategia XML fitxategi bat da, nagusiki, zerbitzuari

eskaera bat egiterakoan zein formatu erabili eta eskaeraren esanahia adierazten duena.

Lokalean gorde daiteke.

Test-orriak zerbitzuko funtzioetako bati eskaera bat egitea ahalbidetzen du, web-interfaze

batean dagozkion sarrera-parametroak sartuz.

Jarraian garatutako zerbitzuak adierazten dira, bere funtzionalitatearen deskribapen orokor

batekin eta dagozkien "Home Page"-en helbideekin.

Callejero

Herri, kale eta abarren izenak jasotzen ditu eta herri, kale, atari, eraikin,

kokapen-koordenatu eta abarri buruzko informazioa itzultzen du.

http://b5m.gipuzkoa.net/ws/dfg-callejero-context-root/CallejeroSoapHttpPort

Toponimia

Izen bat ematen bazaio, horrekin bat datozen eraikin, kale, ibai eta abarren

toponimo guztiak itzultzen ditu, eta horien kokapen-koordenatuak.

http://b5m.gipuzkoa.net/ws/dfg-toponimo-context-root/ToponimoSoapHttpPort

Dibujar

Leiho bat markatzen duten bi koordenatu jasotzen ditu eta irudi bat itzultzen du.

http://b5m.gipuzkoa.net/ws/dfg-dibujar-context-root/DibujarSoapHttpPort

Localizar

Elementu baten identifikadore bat ematen bazaio, bere atributuak eta

elementuaren kokapenaren irudi bat itzultzen du.

http://b5m.gipuzkoa.net/ws/dfg-localizar-context-root/LocalizarPorIdSoapHttpPort


http://b5m.gipuzkoa.net/ws/dfg-callejero-context-root/CallejeroSoapHttpPort

http://b5m.gipuzkoa.net/ws/dfg-toponimo-context-root/ToponimoSoapHttpPort

http://b5m.gipuzkoa.net/ws/dfg-dibujar-context-root/DibujarSoapHttpPort

http://b5m.gipuzkoa.net/ws/dfg-localizar-context-root/LocalizarPorIdSoapHttpPort


Consultar.

XY bat eta gai baten izena jasotzen ditu eta koordenatu horietan kokatutako gai

horren elementuaren atributuak itzultzen ditu.

http://b5m.gipuzkoa.net/ws/dfg-consultar-context-

root/ConsultarPorCoordenadasSoapHttpPort

Calcular Ruta

Bi koordenatu edo gehiago jasotzen ditu eta ibilbide bat itzultzen du (biratzeko

murrizketarik gabe eta beraz ez du ibilgailuentzako balio).

http://b5m.gipuzkoa.net/ws/dfg-calculo_rutas/CalculoRutaSoapHttpPort

1. Irudia. Web Zerbitzuaren Home Page-aren Adibidea. Kontsulta Zerbitzua Koordenatuen arabera


http://b5m.gipuzkoa.net/ws/dfg-consultar-context-root/ConsultarPorCoordenadasSoapHttpPort

http://b5m.gipuzkoa.net/ws/dfg-consultar-context-root/ConsultarPorCoordenadasSoapHttpPort

http://b5m.gipuzkoa.net/ws/dfg-calculo_rutas/CalculoRutaSoapHttpPort


3 Zerbitzuen Testa

3.1 Testa Web ingurunean

Zerbitzuaren edizio-orritik Testaren orrira sartzen da testatu nahi den zerbitzuaren eragiketan

klik eginez. Ikus 2. Irudia. Edizio-orrira sartzea Toponimia Zerbitzuaren orri nagusitik

'buscartoponimo' eragiketan sakatuz.

2. Irudia. Edizio-orrira sartzea Toponimia Zerbitzuaren orri nagusitik 'buscartoponimo' eragiketa sakatuz.

Orrialde hau zerbitzurako sarrera-parametro ezberdinak testatzeko erabil

daiteke, izan ere, parametro edo elementu ezberdinak, beren datu motak eta



balio posibleak sartzeko testu-laukiak dituen taula bat ikusten da. Parametroa aukerazkoa bada

zerbitzuaren definizioaren arabera, parametroaren aurrean egiaztapen-laukitxo bat agertzen da.

Egiaztapen-laukitxoa markatu parametroa testean sartu nahi bada.

Egiaztapen-laukitxoa markatu gabe utzi ez bada aukerazko parametroan inolako baliorik

sartu.

• ‘Preview SOAP’-en klik egin ezarritako parametroak dituen eragiketarako SOAP eskaera

ikusteko; testaren orrira sartzen da. Ikus

•

•

•

•

•

• 3. Irudia. Zerbitzuaren Eragiketaren Testa gauzatzeko Orrialdea.

. Invoke sakatuz eskaera burutzen da eta erantzunaren XML erakusten da.



3. Irudia. Zerbitzuaren Eragiketaren Testa gauzatzeko Orrialdea.



3.2 Testa, probazko aplikazioaren bitartez

Gaur egun Web Services-eko Plataformaren Testaren aplikazioa ondoko helbidean eskura

daiteke:

http://b5m.gipuzkoa.net/appws/publish.htmInterfaze honetako ‘Run’ botoia sakatuz aplikazioa hasten da. Ikus

4. Irudia. Web Services-eko Testaren Aplikazioa Hasteko Web Interfazea .

Aplikazio hau Microsoft-en .Net teknologian inplementatutako adibide bat da, Web Zerbitzu

guztietara deiak egitea ahalbidetzen duena, baita emaitzak ikustea ere, irudiak nahiz datu

alfanumerikoak izan, aplikazio-formularioetan aurkeztuak.

Zuzenean aukera daitezkeen adibide-datuak ditu, modu azkarrean gauzatu ahal izateko,

adibide finkoak, sarrera-parametroen baliozko erabilera duten kasuak bilatu beharrik gabe.

Aplikagarri honek Zerbitzuaren testatze azkarragoa burutzea ahalbidetzen du baliozko sarrera-

datuetatik abiatuz, eta gainera, irtenbidearen adibide bat da.

4. Irudia. Web Services-eko Testaren Aplikazioa Hasteko Web Interfazea


http://b5m.gipuzkoa.net/appws/publish.htm


4 ‘Consulta de Callejero’ Web Zerbitzua

4.1 ‘buscarcallejero’ eragiketa.

4.1.1 Deskribapen funtzionala

Zerbitzu honen eragiketa bakarra buscarcallejero da. Kale-izendegiaren maila askoren artean

kontsulta-mota ezberdinak egitea ahalbidetzen du: herriak, kaleak, atariko zenbakiak, eraikinak,

posta-kodeak, etab., sarrera-parametroen aukera ezberdinen arabera. Xehetasun-maila

(zerbitzuaren erantzunaren informazioa) burutzen den bilaketa motaren arabera aldatzen da.

1. Taula. Kontsulta motaren arabera eskatzen diren sarrera-parametroak taulan zerbitzuari deitzeko beharrezko parametroak adierazten dira, zerbitzu honekin egin

daitezkeen bilaketa mota bakoitzerako.

Herri bat bere izenaz edo kodeaz zehaztu daitezkeenez, eta, halaber, kale bat bere izenaz edo

kodeaz, aldi berean, nahiz eta taulan biak markatuta agertu, zerbitzuari bi esparruetako

edozeinekin dei dakioke. Kontuan hartu behar da ‘muni’ esparruan datuak badaude, zerbitzuak

ez duela ‘codmuni’ erabiltzen. Era berean, ‘calle’ esparruan datuak badaude, zerbitzuak ez du

‘codcalle’ esparrua erabiltzen.

Bilaketa mota Muni Calle Numero Edificio CP Distrito Seccio

n muni X X X X X X X codmuni X X X X X X X calle X X X X X X codcalle X X X X X X numero X X X X bis X X X X nomedif X X codpostal X X X X distrito X X X X X X seccion X X X X X X

1. Taula. Kontsulta motaren arabera eskatzen diren sarrera-parametroak

Taularen interpretazioaren adibidea: Calle motako bilaketa batek erantzuna muni edo

codmuni, calle edo codcalle, codpostal, distrito eta seccion esparruen arabera iragazten du.

Numero eta Edificio motako bilaketetarako derrigorrezkoa da herri bat aukeratzea.



4.1.2 Sarrera-parametroak

Ondoko taulak kale-izendegiaren Web zerbitzuaren sarrera-parametroak erakusten ditu.

Izena Mota Balioen adibideak. tipo String Taulako bilaketa mota ezberdinak, ondokoak izan

daitezkeelarik: Muni, Calle, Numero, Edificio, CP, Distrito edo Seccion

lengua String 0- Gaztelania 1- Euskara 2- Ingelesa 3- Frantsesa

muni String Herriaren Izena, adibidez: donostia codmuni String Herriaren Eustat kodea, adibidez: 004 calle String Kalearen izena, adibidez: aldakoenea codcalle String Kalearen Eustat Kodea, adibidez: 1200 numero String Atariaren zenbakia, adibidez: 010 bis String Bisa, adibidez: A edo hutsik nomedif String Eraikinaren izena da, adibidez: etxeberria codpostal Posta kodea: 001 String distrito String Barrutia: 04 seccion String Atala: 002



4.1.3 Irteera-parametroak

2. Taula. Kontsulta motaren arabera itzulitako irteera-parametroak. taulan Web zerbitzuak bilaketa motaren arabera itzulitako esparruak adierazten dira.

Bilaketa mota Muni Calle Numero Edificio CP Distrito Seccio

n muni X X X X X X codmuni X X X X X X calle X X X codcalle X X X numero X X bis X X nomedificio X X codpostal X X X distrito X X X X seccion X X X XEd50utm X X X X YEd50utm X X X X ZEd50 X X X X lonEd50 X X X X latEd50 X X X X lonWgs84 X X X X latWgs84 X X X X cod3d X X X X x1Ed50utm X X X X y1Ed50utm X X X X x2Ed50utm X X X X y2Ed50utm X X X X urlInfo X X X X url2d X X X X urlOrto X X X X url3d X X X X urlGoogle X X X X

2. Taula. Kontsulta motaren arabera itzulitako irteera-parametroak.

4.1.3.1 Irteera-datuen egitura

Izena Mota Balioen adibideak. return WsreplyUser objectOut WscallobjUser-en Array-a



‘WsreplyUser’ irteera-datu mota bat da, ondoko parametroak dituena: Izena Mota Balioen adibideak. wsmessage

String

wsstatus Hamartarra ‘WscallobjUser’ irteera-datu mota bat da, ondoko parametroak dituena: Izena Mota Balioen adibideak. muni String ALBIZTUR codmuni String 004 calle String ALBIZTUR NUCLEO codcalle String 1110 numero String 045 bis String A nomedificio String ARKATZPE codpostal String 20495 distrito String 01 seccion String 001 XEd50utm Hamartarra 570729 YEd50utm Hamartarra 4775742 ZEd50 Hamartarra 259 lonEd50 Hamartarra -2.13045033281384 latEd50 Hamartarra 43.1303388591911 lonWgs84 Hamartarra -2.13169361178994 latWgs84 Hamartarra 43.12923609425 cod3d Hamartarra 259 x1Ed50utm Hamartarra 570716.956 y1Ed50utm Hamartarra 4775735.155 x2Ed50utm Hamartarra 570733.538 y2Ed50utm Hamartarra 4775750.224 urlInfo String http://b5m.gipuzkoa.net/kaletegia/url?key=K_040_1608&lengua=0 url2d String http://b5m.gipuzkoa.net/url5000/index.php?id=K_040_1608…… urlOrto String http://b5m.gipuzkoa.net/url5000/index.php?id=K_040_1608…… url3d String http://b5m.gipuzkoa.net/gipuzkoa3D/Gipuzkoa3D/ReDist/LurbiraRotAroundPt.htm?

583009,4790785,42 urlGoogle String http://maps.google.com/maps?q=43.26452520……… Adibidea: Mota: Edificio, codmuni=004, Bis=A.



4.1.3.2 Irteera-parametroen deskribapena

muni Udalerriaren izena codmuni Udalerriaren kodea calle Kalearen izena codcalle Kalearen kodea numero Número de portal bis Bisa nomedificio Eraikinaren izena codpostal Posta Kodea distrito Barrutia seccion Atala XEd50utm X Koordenatua (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa. YEd50utm Y Koordenatua (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa. ZEd50 Altuera (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa. lonEd50 Longitudea (ED50), objektuen MBR-ren zentrokoa. latEd50 Latitudea (ED50), objektuen MBR-ren zentrokoa. lonWgs84 Longitudea (WGS84), objektuen MBR-ren zentrokoa. latWgs84 Latitudea (WGS84), objektuen MBR-ren zentrokoa. cod3d Altuera birtuala (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa,

Gipuzkoa3D hegaldi birtualerako. x1Ed50utm X Koordenatu minimoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. y1Ed50utm Y Koordenatu minimoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. x2Ed50utm X Koordenatu maximoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. y2Ed50utm Y Koordenatu maximoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. urlInfo 'b5m' web aplikazioaren lotura.

url helbidea da, non informazio gehiago kontsulta daitekeen 1:5000 web orrian

url2d 'b5m' web aplikazioaren lotura. 1:5000 web orriarekiko url motako lotura bat da, kontsultaren emaitza ikustea ahalbidetzen duena, mapa motako fondoko konfigurazioarekin.

urlOrto 'b5m' web aplikazioaren lotura. ‘b5m’ web orriarekiko url motako lotura bat da, kontsultaren emaitza ikustea ahalbidetzen duena, fondoko irudiaren konfigurazioa ortofoto motakoa delarik.

url3d ‘b5m’ web orriarekiko url motako lotura bat da, Gipuzkoa3D hegaldi birtuala abiarazten duena, kontsultaren emaitza den kokapen geografikoan.

urlGoogle Google maps-en lotura bat da (url helbidea), non kontsultaren emaitza den gunea ikus daitekeen.



4.1.4 Kode bat adibide gisa

Hurrengo C# adibideak (Visual Studio 2005-erako) Web Service-era nola deitu erakusten du,

"Calle" bilaketa motarekin eta codmuni=004 eta calle=SANTA parametroekin; horrek erregistro

bat itzultzen du.

Web zerbitzua erregistratzeko eta proxy-ak sortzeko, ondoko pausoak jarraitu behar dira:

1. “Add Web Reference” aukeratu “Solution Explorer”-en leihotik.

2. Agertzen den leihoan, URL-ren esparruan sartu WSDL-ren path-a eta ws_Callejero “Web

Reference Name” esparruan eta aukeratu “Add Reference”

3. Visual Studio-k automatikoki sortzen ditu C# proxy-ak eta dagokien DataSource-a.

4. Automatikoki DataSource-arekin lotuta dagoen DataGridView bat sortzeko, toponimoarrOut

objektua "Data Sources"-en leihotik formulario batera arrastatu daiteke.

private ws_Callejero.Callejero webCall; ------------------------------------------- // Aurreko emaitzak garbitu. callejeroBindingSource.Clear(); Refresh(); // Web zerbitzuaren eskaria sortu. webCall = new ws_Callejero.Callejero(); // Web Service-era deitu. ws_Callejero.CallejeroUser_buscarcallejero_Out webCallMuniOut = webCall.buscarcallejero("0","Calle","","004","SANTA","","","","","",",""); // Funtzionatu badu eta zerbait itzuli badigu, datuak DataSource-era pasatu. if ([email protected] == -1)

MessageBox.Show([email protected]); else

if ((Convert.ToInt16([email protected])) > 0) callejeroBindingSource.DataSource = webCallMuniOut.objectOut;

-------------------------------------------



5 ‘Buscar Topónimo’ Web Zerbitzua

5.1 'toponimo' Eragiketa

toponimo eragiketaren bidez testu jakin batekin bat datozen Datu-Baseko elementu guztiak

kontsulta daitezke. Izen bat ematen bazaio, horrekin bat datozen eraikin, kale, ibai eta abarren

toponimo guztiak itzultzen ditu, eta horien kokapen-koordenatuak.


Izena Mota Balioak toponimo string Bilatu beharreko katea.

Adibideak: ‘victor’ edo ‘aduana 13 irun’ lengua string 0- Gaztelania

1- Euskara 2- Ingelesa 3- Frantsesa


Izena Mota Balioak return hamartarra Itzulitako erregistroen kopurua. toponimoarrOut WstopobjUser-en Array-

a



Mota Izena

Balioen adibideak.

nombre String VICTOR HUGO KALEA tipo String CALLE otro String HERNANI codigo String K_040_1608 direccion String XEd50utm Hamart

arra 583009

YEd50utm Hamartarra

4790785

ZEd50 Hamartarra

42

lonEd50 Hamartarra

-1.9772408737149

latEd50 Hamartarra

43.2645252048455

lonWgs84 Hamartarra

-1.97848413231404

latWgs84 Hamartarra

43.2634269038068

cod3d Hamartarra

42

x1Ed50utm Hamartarra

582990.936

y1Ed50utm Hamartarra

4790750.12

x2Ed50utm Hamartarra

583052.8

y2Ed50utm Hamartarra

4790803.1984

urlInfo String http://b5m.gipuzkoa.net/kaletegia/url?key=K_040_1608&lengua=0 url2d String http://b5m.gipuzkoa.net/url5000/index.php?id=K_040_1608…… urlOrto String http://b5m.gipuzkoa.net/url5000/index.php?id=K_040_1608…… url3d

String http://b5m.gipuzkoa.net/gipuzkoa3D/Gipuzkoa3D/ReDist/LurbiraRotAroundPt.htm?583009,4790785,42

urlGoogle String http://maps.google.com/?q=43.2634269038,-1.978………

‘WstopobjUser’ irteera-datu mota bat da, ondoko balioak dituena:

3. Taula. Sarrera-parametroetarako adibidea: toponimo=victor, lengua=0



5.1.2.1 Irteera-parametroen deskribapena

Izena Deskribapena nombre Erabiltzaileak kontsultatutako gako hitza duen kokatutako

elementuaren izena. tipo Zein izen mota den, adibidez, ERAIKINA, HERRIA, AUZOA, ERREKA,

KALEA, POSTA HELBIDEA, etab. otro Herria, arroa edo bestelako informazioa codigo Datu-basean elementuaren kodea da1

direccion Posta helbidea, baldin badu. XEd50utm X Koordenatua (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa. YEd50utm Y Koordenatua (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa. ZEd50 Altuera (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa. lonEd50 Longitudea (ED50), objektuen MBR-ren zentrokoa. latEd50 Latitudea (ED50), objektuen MBR-ren zentrokoa. lonWgs84 Longitudea (WGS84), objektuen MBR-ren zentrokoa. latWgs84 Latitudea (WGS84), objektuen MBR-ren zentrokoa. cod3d Altuera birtuala (ED50 UTM 30 Norte), objektuen MBR-ren zentrokoa,

Gipuzkoa3D hegaldi birtualerako. x1Ed50utm X Koordenatu minimoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. y1Ed50utm Y Koordenatu minimoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. x2Ed50utm X Koordenatu maximoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. y2Ed50utm Y Koordenatu maximoa (ED50 UTM 30 Norte), objektuen MBR-ren

zentrokoa. urlInfo 'b5m' web aplikazioaren lotura.

url helbidea da, non informazio gehiago kontsulta daitekeen 1:5000 web orrian

url2d 'b5m' web aplikazioaren lotura. 1:5000 web orriarekiko url motako lotura bat da, kontsultaren emaitza ikustea ahalbidetzen duena, mapa motako fondoko konfigurazioarekin.

urlOrto 'b5m' web aplikazioaren lotura. ‘b5m’ web orriarekiko url motako lotura bat da, kontsultaren emaitza ikustea ahalbidetzen duena, fondoko irudiaren konfigurazioa ortofoto motakoa delarik.

url3d ‘b5m’ web orriarekiko url motako lotura bat da, Gipuzkoa3D hegaldi birtuala abiarazten duena, kontsultaren emaitza den kokapen geografikoan.

urlGoogle Google maps-en lotura bat da (url helbidea), non kontsultaren emaitza den gunea ikus daitekeen.

1 Biltegiko elementuko kodeak beste Web Zerbitzu batzuetarako ere erabil daitezke, esaterako, ‘LocalizarporId’ zerbitzurako.



5.1.3 Kode bat adibide gisa

Hurrengo C# adibideak (Visual Studio 2005-erako) Web Service-era nola deitu erakusten du,

toponimo=victor eta lengua=0 parametroekin; horrek CALLE eta EDIFICIO moten 16 erregistro

itzultzen ditu.

private ws_BuscarTopo.Toponimo webTop; ------------------------------------------- // Aurreko emaitzak garbitu. toponimoarrOutBindingSource.Clear(); Refresh(); // Web zerbitzuaren eskaria sortu. webTop = new ws_BuscarTopo.Toponimo(); // Web Service-era deitu. ws_BuscarTopo.ToponimoUser_buscartoponimo_Out webTopOut = webTop.buscartoponimo ("victor","0"); // Leihoan itzulitako erregistro kopurua idatzi. TxtRegistros.Text = Convert.ToString(webTopOut.@return); // Funtzionatu badu eta zerbait itzuli badigu, datuak DataSource-era pasatu. if ((Convert.ToInt16(TxtRegistros.Text)) > 0) toponimoarrOutBindingSource.DataSource = webTopOut.toponimoarrOut; -------------------------------------------

OHARRA Web zerbitzua nola erregistratzen den ikusteko, ikus Kale-izendegiaren adibidea.

6 ‘Dibujar Imagen’ Web Zerbitzua

6.1 ‘dibujarimagenmbr’ Eragiketa

Funtzio horrek kokapen-plano edo ortofoto motako irudi bat lortzea ahalbidetzen du, horren

luzapena (MBR) zehazten duten bi koordenatu emanez. Sortutako irudiaren Minimum Bounding

Rectangle-a eta bere URL-a itzultzen ditu. Posible da irudian ikuspenera gehitutako

informazioaren geruzak zehaztea. Gehitutako gaien ikuspena ezartzeko, aurrez gai

erabilgarriak kontsulta daitezke mapasdisponibles eragiketaren bitartez (ikus hurrengo

puntua)




Izena Mota Balioak ix1 String X minimoa Adb. 540000

String Y minimoa Adb. 4740000 iy1 String X maximoa Adb. 610000 ix2

iy2 String Y maximoa Adb. 4810000

iwidth String Zabalera pixeletan Adb. 600 iheight String Altuera pixeletan Adb. 400

Lekua, Adibidez: PUBLI iescenario String lengua String 0- Gaztelania


WsmapasselectUser-en Array-a

mapaselectarr

‘mapaselectarr’ sarrera-parametroa ‘WsmapasselectUser ‘ motako objektuen array bat da. ‘WsmapasselectUser’ mota honetako objektu bat da:

Izena Mota Balioen adibideak. nombre String farmacias estado String si tipo String Clase, Grupo, Mapa

Farmazien ikuspena sartzeko adibide bat honakoa litzateke:

Izena Egoera Mota Si Clase Invisible Si Invisible Grupo

farmacias Si Mapa

Gaiak Taldetan ('Grupos') eta Taldeak Motetan ('Clases') biltzen dituen mapen hierarkia bat

dagoenez, gai jakin bat aktibatzeko horren taldea eta mota ere aktibatu beharko dira. Leku jakin

baterako zein gai erabil daitezkeen jakiteko, hurrengo puntuan deskribatutako

mapasdisponibles-era deitu.


http://arqfotos:8888/dfg-dibujar-context-root/DibujarSoapHttpPort?DibujarSoapHttpPortstub.html#type2



Irteera-datuen egitura:

Izena Mota Balioen adibideak. return String oimagepathOut String Sortutako irudiaren path-a itzultzen du:

http://b5m.gipuzkoa.net/internet/GenaImageSourcer?IMAGEID=2677484727 &RETCONTENTTYPE=image/png&RM=FALSE

x1 String Sortutako irudiaren X minimoa y1 String Sortutako irudiaren Y minimoa x2 String Sortutako irudiaren X maximoa y2 String Sortutako irudiaren Y maximoa


Hurrengo C# adibideak (Visual Studio 2005-erako) Web Service-era nola deitu erakusten du, ondoko parametroekin:

ix1=540000 iy1=4740000 ix2=610000 iy2=4810000 iwidth=629 iheight=362 iescenario=PUBLI lengua=0 mapaselectarr=null

Web zerbitzuak irudia sortzen du eta bere URL-a itzultzen du.

private ws_DibImagen.Dibujar webDibImg; ------------------------------------------- // Web zerbitzuaren eskaria sortu. webDibImg = new ws_DibImagen.Dibujar(); // Mapak aukeratzeko Array-a. ws_DibImagen.WsmapasselectUser[] nomArr = null; // Web Service-era deitu. ws_DibImagen.DibujarUser_dibujarimagen_Out webDibImgOut = webDibImg.dibujarimagen(“540000”,“4740000”,“610000”,“4810000”,”629”,“362”,

“PUBLI”, “0”, nomArr); // Irudia marraztu PictureBox batean. PictureBox1.ImageLocation = webDibImgOut.oimagepathOut; -------------------------------------------




6.3 ‘Mapas Disponibles’ Eragiketa

Eragiketa honek, leku (edo maila) baten izena emanda, mota, talde eta gaien zerrenda bat

ematen du. Horrenbestez, gai erabilgarrien zerrenda ematen du eta horren ikuspena

‘dibujarimagen’ eskaeran aktibatu daiteke.


Izena Mota Balioak

Escenario Adb. PUBLI categoria String lengua String 0- Gaztelania



Irteera-datuen egitura:

Izena Mota Balioen adibideak. WsreplyUser String WsmapasUser WsmapasUser-en Array-a

‘WsreplyUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. wsmessage

String

wsstatus Hamartarra ‘WsmapasUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. clase String Actividades grupo String Turismo mapa String T_19 descripcion String Playas MActivado String n GActivado String n CActivado String n



7 ‘Localizar’ Web Zerbitzua

'Localizar' Web-Zerbitzuak eragiketa (edo funtzio) ezberdinak ditu, datu-basetik entitate jakin

batzuen kokapen geografikoa burutzea ahalbidetzen dutenak. Esate baterako: udalerriak,

kaleak, hiriguneak, errepideak, kilometro-puntuak, toponimoak, ibaiak edo xy koordenatu

batzuk; adibide batzuk jartzearren.

Zerbitzu honetan dauden eragiketa bakoitzak idiosinkrasia komuneko entitate jakin

batzuk kokatzeko aukera biltzen du.

Itzultzen den informazioa kokatutako elementua (url) eta kokatutako elementuaren informazio

alfanumerikoa jasotzen duen irudi bat da. Eragiketa edo funtzio batzuetan, irudiaz gain,

kontsultatutako elementuaren informazio geografikoa (koordenatuak) ere lor daiteke, formatu

estandar jakin batzuetan (gml, wkb edo wkt).

Posible da irudian ikusteko gehitutako informazioaren geruzak zehaztea. Gehitutako gaien

ikuspena ezartzeko, aurrez gai erabilgarriak kontsulta daitezke Dibujar Imagen zerbitzuko

mapasdisponibles eragiketaren bitartez.

Kokatu beharreko entitateen kodeak ezagutzeko, Consulta del Callejero Web Service-eko

buscarcallejero eta Buscar Toponimo Web Service-eko toponimo eragiketak erabil daitezke.

7.1 Kale-izendegiaren entitateen Kokapena

Jasotako entiateetako baten indentifikatu bat emanda, ezaugarriak itzultzen ditu, eta aukeran,

raster edo bektore formatua duen mapa bat.

Eragiketaren izena: localizaridcallejero




Izena Mota Balioak identificador string Kokatu beharreko entitatearen kodea

Adibideak: Comarca. S_3 Municipio: M_045 Núcleo Urbano: N_30145 Calles (Vial): V_003_1110 Calles (Edificios): K_003_1110 Distritos y Secciones: SC_045_01_003 Dirección postal : D_4545 Edificios : E_51507 Muni_calle_portal: F_045_1110_003 Actividad: A_11933 Adibidea: 5000 edo hutsik escala string

lengua string 0- Gaztelania 1- Euskara 2- Ingelesa 3- Frantsesa

imagen string si/no escenario string Adibidea: PUBLI anchura string Sortutako irudiaren zabalera pixeletan.

Adibidea: 800 altura string Sortutako irudiaren altuera pixeletan.

Adibidea: 600 vector string GML, WKT, WKB mapaselectarr WsmapasselectUse

r

‘WsmapasselectUser’ irteera-datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. nombre string farmacias estado string si tipo string Clase, Grupo, Mapa

Gaiak Taldetan ('Grupos') eta Taldeak Motetan ('Clases') biltzen dituen mapen hierarkia bat

dagoenez, gai jakin bat aktibatzeko horren taldea eta mota ere aktibatu beharko dira. Leku jakin

baterako zein gai erabil daitezkeen jakiteko, dokumentuaren beste puntu batean deskribatutako

mapasdisponibles-era deitu.




Kokatzen den entitatearen informazio alfanumerikoa, irudi bat eta aukeran, gml, wkb edo wkt fitxategiak lortzen dira.

Izena Mota Balioen adibideak. return string imagenurlOut string http://b5m.gipuzkoa.net/internet/Gen

aImageSourcer... objectOut TipocallejerosUser

‘TipocallejerosUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. DireccionPostalUser-en Array-a.

listaDirecciones

ActividadUser-en Array-a. listaActividades

Adibidea: E_51507 ‘DireccionPostalUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. seccion String 003 nucleoUrbano String codigoPostal String 20004 nombre String numero String 004 terminoMunicipal String distrito String 02 municipio String DONOSTIA-SAN SEBASTIAN comarca String calle String REPUBLICA ARGENTINA AMunicipio String 069 ACalle String 3970 wktVec String wkbVec base64Binary gmlVec String

‘ActividadUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. tipoActividad String MONUMENTO nombreActividad String Maria Cristina ATipoActividad String F.1.1 a2NombreActividad String 23255 a1NombreActividad String 69241



7.2 Jasotze kartografikoen inbentarioko entitateen kokapena

Jasotze kartografikoaren identifikadore bat emanda, ezaugarriak eta, aukeran, raster formatua

duen mapa bat itzultzen ditu.

Eragiketaren izena: localizaridcartofototeca


Izena Mota Balioak identificador string Kokatu beharreko jasotzearen kodea

Adibideak: Q_002, Q_001_6429a1a.dwg Adibidea: 5000 edo hutsik escala string




Adibidea: 600 vector string GML, WKT, WKB Mapaselectarr WsmapasselectUse

r



aImageSourcer... objectOut CartoUser

‘CartoUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. Cartofototeca TipocartofototecaUser-en Array-a.

Adibidea: Q_002



‘TipocartofototecaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. propietario string AYTO. de LEZO lugar string LEZO escala string 1000 empresa string NEURRI ingenieros S.A. fichero string fechaLevantamientoOriginal string 01-06-1974 fechaUltimaActualizacion string 01-07-1998 fechaDigitalizacion string 01-07-1998

7.3 Ibai-entitateen Kokapena

Arro edo ibaiaren identifikadore bat emanda, ezaugarriak eta, aukeran, raster eta bektore

formatua duen mapa bat itzultzen ditu.

Izena: localizaridrios


Izena Mota Balioak identificador string Kokatu beharreko entitatearen kodea

Adibideak: Cuenca: C_11 Río: I_16072 Adibidea: 5000 edo hutsik escala string




Adibidea: 600 GML, WKT, WKB vector string

mapaselectarr WsmapasselectUser


Kokatzen den entitatearen informazio alfanumerikoa (ezaugarriak), irudi bat eta aukeran, gml,

wkb edo wkt fitxategiak lortzen dira.




aImageSourcer... objectOut TiporioUser

‘TiporioUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. rio string UROLA cuenca string rio UROLA ARio string 12 ACuenca string 16072 wktVec base64Binary wkbVec String gmlVec String

Adibidea: I_16072

7.4 Toponimoen Kokapena

Eragiketa horrek, orografia edo auzo baten identifikadore bat emanda, ezaugarriak eta,

aukeran, raster eta bektore formatua duen mapa bat itzultzea ahalbidetzen du.

Eragiketaren izena: localizaridtoponimia


Izena Mota Balioak identificador String Kokatu beharreko entitatearen

kodea Adibideak: Barrios (nombre): Z_13363 Barrios (área): B_12402 Barrios (combinado): B_12402_13363 Orografía (nombre): G_24071 Orografía (área): O_19171 Orografía (combinado): O_19171_21539 Adibidea: 5000 edo hutsik escala String


imagen String si/no escenario String Adibidea: PUBLI anchura String Sortutako irudiaren zabalera

pixeletan. Adibidea: 800



altura String Sortutako irudiaren altuera

pixeletan. Adibidea: 600

vector String GML, WKT, WKB mapaselectarr WsmapasselectUser


Izena Mota Balioen adibideak. return String imagenurlOut String http://b5m.gipuzkoa.net/internet/Gen

aImageSourcer... objectOut TipotopoUser

‘TipotopoUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. municipio string URNIETA barrio String orografia String MONTE ABALLARRI AMunicipio String AOrografia String 24071 ABarrio String wktVec String wkbVec base64Binary gmlVec String

Adibidea: G_24071

7.5 Bideen Kokapena

Bidearen, kilometro-puntuaren, garraio linea edo geltokiaren (hauek ez daude eguneratuta)

emanda, ezaugarriak eta, aukeran, raster eta bektore formatuko mapa itzultzen du.

Izena: localizaridviales


Izena Mota Balioak identificador String Kokatu beharreko entitatearen kodea

Adibideak: Carreteras/Tren: T_9044 Puntos Kilométricos: T_9044_1.4 Líneas de Transporte Público: TP_155 Paradas de Transporte Público: RA_176 Adibidea: 5000 edo hutsik escala String


imagen String si/no



escenario String Adibidea: PUBLI anchura String Sortutako irudiaren zabalera pixeletan.

Adibidea: 800 altura String Sortutako irudiaren altuera pixeletan.

Adibidea: 600 GML, WKT, WKB vector String

mapaselectarr WsmapasselectUser


Kokatzen den entitatearen informazio alfanumerikoa (ezaugarriak), irudi bat eta aukeran, gml, wkb edo wkt fitxategiak lortzen dira.


aImageSourcer... objectOut TipovialesUser

‘TipovialesUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. carretera string carretera GI-3162 descripcion String Al barrio de Urdaneta (Aia) ACarretera String 9044 wktVec String wkbVec base64Binary gmlVec String lineasTransporte TipolineaUser paradasTransporte TipoparadaUser

Adibidea: T_9044 ‘TipolineaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. empresa String (RENFE) tipo String LÍNEA DE TREN sentido String IDA ruta String IRUN-BRINKOLA paradas ParadaUser-en Array-a

Adibidea: TP_155



‘ParadaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. nombre String IRUNGO GELTOKIA (RENFE) GWkt String GWkb base64Binary GGml String

‘TipoparadaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. nombre String ELOSEGI ALKATEA,3

AURREAN (DONOSTIA) paradas TipolineasUser-en Array-

a

Adibidea: RA_176 ‘TipolineasUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. empresa String HIJOS A. AREIZAGA tipo String línea de autobus interurbano sentido String ida ruta String A3-PASAI SAN PEDRO-DONOSTIA/SAN

SEBASTIAN

7.6 XY Koordenatuen Kokapena

Proiekzio mota bat eta XY balioak emanda, balioak UTM30 eta Lat-Long delakoetan eta,

aukeran, mapa bat raster formatuan itzultzen ditu.

Izena: localizaridxy


Izena Mota Balioak x String Coordenada y String Coordenada tipo String UTM, Lat/Long , Lat/Long-WGS84

Adibidea: 5000 edo hutsik escala String lengua String 0- Gaztelania


imagen String si/no escenario String Adibidea: PUBLI anchura String Sortutako irudiaren zabalera pixeletan.

Adibidea: 800 altura String Sortutako irudiaren altuera pixeletan.

Adibidea: 600 mapaselectarr WsmapasselectUser





aImageSourcer... objectOut TipoxyUser

‘TipoxyUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. XUtm String 582573 YUtm String 4797250 lat String -1 58 53.8 lon String 43 19 22 latW String -1 58 58.4 lonW String 43 19 18

Adibidea: tipo = Lat/Long, x= -1 58 53.87 , y= 43 19 22.


Hurrengo C# adibideak (Visual Studio 2005-erako) LocalizarPorId – Callejero Web Service-era nola deitu erakusten du, ondoko parametroekin:

identificador= A_11933 escala= lengua=0 imagen=si escenario=PUBLI anchura=447 altura=307 vector=GML mapaselectarr=null

Web Zerbitzuak Jardueren (Actividades) DataSource-ean erregistro bat itzultzen du, eta beste bat Helbideen (Direcciones) DataSource-ean.

private ws_Localizar.LocalizarPorId webId; ------------------------------------------- // Aurreko emaitzak garbitu. listaActividadesBindingSource.Clear(); listaDireccionesBindingSource.Clear(); Refresh(); // Mapak aukeratzeko Array-a. ws_Localizar.WsmapasselectUser[] nomArr = null; // Web zerbitzuaren eskaria sortu. webId = new ws_Localizar.LocalizarPorId(); // Web Service-era deitu. ws_Localizar.LocalizarPorIdUser_localizaridcallejero_Out webIdOut = webId.localizaridcallejero(“A_11933”,””,”0”,”si”,”PUBLI”,”447”,”307”,”GML”,nomArr); // Funtzionatu badu eta zerbait itzuli badigu, datuak DataSource-era pasatu. if (webIdOut.objectOut.listaActividades != null) listaActividadesBindingSource.DataSource = webIdOut.objectOut.listaActividades;



// Funtzionatu badu eta zerbait itzuli badigu, datuak DataSource-era pasatu. if (webIdOut.objectOut.listaDirecciones != null) listaDireccionesBindingSource.DataSource = webIdOut.objectOut.listaDirecciones; -------------------------------------------


8 ‘Consultar’ Web Zerbitzua

'Consultar' Web Zerbtzuak koordenatu geografiko jakin batzuetan dauden entitate zehatz baten

elementuen informazioa itzultzen du. Kontsultatzen den entitatearen izena eta X eta Y

koordenatuak sarrera-parametro gisa pasatzen dira.

8.1 Koordenatuak Kontsultatzeko Eragiketa

Eragiketa edo funtzio honetan puntu bati buruzko informazioa ematen da, zeinen X eta Y

koordenatuek argumentu gisa jarduten duten. Informazio honek Longitudea eta Latitudea,

puntuaren Altuera, etab. bezalako datuak ditu.

Eragiketaren izena: consultarcoorcoordenadas


Izena Mota Balioak tema string COORDENADAS lengua string 0- Gaztelania

1- Euskara 2- Ingelesa 3- Frantsesa X ED50 UTM30N-en Adb. 581082 coorX string Y ED50 UTM30N-en Adb. 4793752 coorY string


Izena Mota Balioen adibideak. return string objectOut TipocoordenadaUser



‘TipocoordenadaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. pendiente String 20-30 % (lidar: 5-10 %) orientacion String ESTE (lidar: SUDESTE) ed50 Tipoed50User wgs84 Tipowgs84User

‘Tipoed50User’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. longitudGeograficas string -2 0 1.9 latitudGeograficas string 43 17 29.2 alturaGeograficas string 67 m XUtm30 string 581082 m YUtm30 string 4793752 m alturaUtm30 string 67 m (lidar=76 m)

‘Tipowgs84User’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. longitudGeograficas string -2 0 6.5 latitudGeograficas string 43 17 25.2 alturaGeograficas string 117 m XGeocentricas string 4647142 m YGeocentricas string -162430 m ZGeocentricas string 4351116 m



8.2 Toponimia Kontsultatzeko Eragiketa

Kontsulta zerbitzuaren eragiketa edo funtzio honetan puntu geografikoaren eskualdearen,

herriaren auzoaren eta orografiaren informazioa lortzen da, puntu horren x eta y koordenatuak

sarrera-parametro gisa pasatuz.

Eragiketaren izena: consultarcoortoponimia


Izena Mota Balioak tema string TOPONIMIA lengua string 0- Gaztelania


coorX string X ED50 UTM30N-en Adb. 583269 coorY string Y ED50 UTM30N-en Adb. 4797499


Izena Mota Balioen adibideak. return string objectOut TipotoponimiaUser

‘TipotoponimiaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. barrio string GROS nombreUrbano string GROS nucleoUrbano string DONOSTIA-SAN SEBASTIAN terminoMunicipal string DONOSTIA-SAN SEBASTIAN comarca string DONOSTIALDEA ABarrio string 14524 ANombreUrbano string 14524 ANucleoUrbano string 13996 ATerminoMunicipal string AComarca string



8.3 Bideak Kontsultatzeko Eragiketa

Funtzio honetan, puntu geografiko bat emanda, kale, errepide edo trenbideen izena edo izenak lortzen dira, puntu horren X eta Y koordenatuak sarrera-parametro gisa sartuz.

Eragiketaren izena: consultarcoorvial


Izena Mota Balioak tema string VIAL lengua string 0- Gaztelania



Izena Mota Balioen adibideak. return string objectOut TipovialUse

‘TipovialUse’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. calle string GREGORIO ORDOÑEZ carretera string carreteraDesc string municipio string DONOSTIA-SAN SEBASTIAN ACalle string 7920 ACarretera string AMunicipio string 069

8.4 Kale-izendegia Kontsultatzeko Eragiketa

Puntu geografiko jakin batetik abiatuz, kale-izendegiaren informazioa ematen duen funtzioa da; horren X eta Y koordenatuek sarrera-parametro gisa jarduten dute. Eragiketaren izena: consultarcoorcallejero




Izena Mota Balioak tema string MUNICIPIO, EDIFICIO, CALLE lengua string 0- Gaztelania



Izena Mota Balioen adibideak. return string objectOut TipocallejeroUser

‘TipocallejeroUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. listaDirecciones DirPostalUser-en Array-

a.

listaActividades ActividadUser-en Array-a.

tema=EDIFICIO denean erabilia

‘DirPostalUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. seccion String 003 nucleoUrbano String codigoPostal String 20004 nombre String matricula String PT2782AN numero String 004 idPostal string D_41247 terminoMunicipal String idArea String E_51507 distrito String 02 municipio String DONOSTIA-SAN SEBASTIAN comarca String calle String REPUBLICA ARGENTINA AMunicipio String 069 ACalle String 3970

Adibidea: tema=EDIFICIO, x=582793, y= 4797268



‘ActividadUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. tipoActividad String MONUMENTO nombreActividad String Maria Cristina ATipoActividad String F.1.1

String 23255 a2NombreActividad a1NombreActividad

String 69241

8.5 Ibaiak Kontsultatzeko Eragiketa

Funtzio honetan ibaien izenak lortzen dira, emandako puntu geografiko batean; horren XY

koordenatuek sarrera-parametro gisa jarduten dute.

Izena: consultarcoorrio


Izena Mota Balioak tema string RIO lengua string 0- Gaztelania



Izena Mota Balioen adibideak. return string objectOut TiporioUser

‘TiporioUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. rio rio URUMEA cuenca URUMEA ARio 16436 ACuenca 13



8.6 KartoFototeka Kontsultatzeko Eragiketa

Eragiketa honetan, puntu geografiko jakin bateko kartografiaren datuak lortzen dira, puntu

horren X eta Y koordenatuek argumentu gisa jarduten dutelarik. Kontsulta daitezkeen

kartografia motak ondokoak dira: CARTOGRAFIA, CINCOMILES edo FOTOSAEREAS.

Izena: consultarcoorcartofototec


Izena Mota Balioak tema string CARTOGRAFIA, CINCOMILES,

FOTOSAEREAS lengua string 0- Gaztelania


coorX string X ED50 UTM30N-en Adb. 581082 coorY string Y ED50 UTM30N-en Adb. 4793752


‘CartotecaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. fotosAereas TipofotosareaUser-en Array-a. tema= FOTOSAEREAS cincoMiles TipocincomilUser-en Array-a. tema=CINCOMILES cartografia TipocartofototecaUser-en Array-

a. tema=CARTOGRAFIA

‘TipofotosareaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. pasada String 06a fotograma String 6374 link String http://b5m.gipuzkoa.net... tipo String Abril/Mayo - 1:15.000 - vuelo

completo - negativos y diapositivas ano String 2001

Adibidea: tema= FOTOSAEREAS, x=581082, y=4793752



‘TipocincomilUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. fecha String 1983 enlace String http://b5m.gipuzkoa.net...

Adibidea: tema=CINCOMILES, x=573993, y=4781593 ‘TipocartofototecaUser’ datu mota bat da, ondoko parametroak dituena:

Izena Mota Balioen adibideak. propietario String AYUNTAMIENTO... lugar String DONOSTIA... escala String 500 empresa String VARIOS fichero String N12_2.DWG fechaLevantamientoOriginal String 01-05-2001 fechaUltimaActualizacion String 01-10-2003 fechaDigitalizacion String 01-05-2001

Adibidea: tema= CARTOGRAFIA, x= 581082, y=4793752


Hurrengo C# adibideak (Visual Studio 2005-erako) Consultar – Rios Web Service-era nola deitu erakusten du, ondoko parametroekin:

tema=RIO lengua=0 coorX=582868 coorY=4797335

Web Zerbitzuak DataSource-ean erregistro bat itzultzen du, ibaiaren datuekin. private ws_Consultar.ConsultarPorCoordenadas webId; ------------------------------------------- // Aurreko emaitzak garbitu. consultarPorCoordenadasUser_consultarcoorrio_OutBindingSource.Clear(); Refresh(); // Web zerbitzuaren eskaria sortu. webXY = new ws_Consultar.ConsultarPorCoordenadas(); // Web Service-era deitu. ws_Consultar.ConsultarPorCoordenadasUser_consultarcoorrio_Out webXYOut = webXY.consultarcoorrio("RIO","0","582868","4797335"); // Funtzionatu badu, datuak DataSource-era pasatu. if (webXYOut.@return == "OK")

consultarPorCoordenadasUser_consultarcoorrio_OutBindingSource.DataSource = webXYOut.objectOut;

------------------------------------------- OHARRA Web zerbitzua nola erregistratzen den ikusteko, ikus Kale-izendegiaren adibidea.



9 Ibilbidea Kalkulatu

Ibilbidea Kalkulatzeko Web Zerbitzuak ibilbide bat osatzen duten polilineoen koordenatuak

ematen ditu. Ibilbidea hasierako puntu baten, amaierako puntu baten edo aukeran tarteko puntu

baten koordenatuekin zehatz daiteke. Ibilbide hauek biratzeko murrizketak kontuan hartu gabe

kalkulatzen dira.

Eragiketaren izena da: calcularruta

9.1 Ibilbide baten Koordenatuak Kontsultatzeko Eragiketa

Hasierako XY bat eta amaierako xy bat emanez, bi puntuen arteko errepidearen ibilbidea itzultzen du. Aukeran tarteko puntu bat zehatz daiteke. Izena: calcularruta


Izena Mota Balioak ix0 string Hasierako X koordenatua Adb. 550497 iy0 string Hasierako Y koordenatua Adb. 4790307 ix1 string Tarteko puntu baten X koordenatua iy1 string Tarteko puntu baten Y koordenatua

Amaierako X koordenatua Adb. 549665 ixd string Amaierako Y koordenatua Adb. 4789587 iyd string


Funtzioak XML bat itzultzen du String batean kodetuta, lerroen XY balioekin eta ibilbidearen

erpinekin.

Adibidea. <genaServerReply> <text type="stdout"> <resultados> <line>548652.49 4786818.13 548652.49 4786824.27 548653.36 4786833.78 </line> <line>548786.36 4787388.04 548759.05 4787374.01 548706.17 4…………</line> <line> 548744.29 4786605.94 548736.21 4786610.33 548725.42 ………</line> . . </resultados> </text> <status value="0"/> </genaServerReply>




Hurrengo C# adibideak (Visual Studio 2005-erako) Consultar – Rios Web Service-era nola deitu

erakusten du, ondoko parametroekin:

ix0=550497 iy0=4790307 ix1= iy1= ixd=549665 iyd=4789587

Web Zerbitzuak XML bat itzultzen du C#-n XmlTextReader-ekin irakur daitekeen String batean.

private ws_Ruta.CalculoRuta webId; ------------------------------------------- // Aurreko emaitzak garbitu. lsbCalcRutaOut.Items.Clear(); Refresh(); // Web zerbitzuaren eskaria sortu. webRuta = new ws_Ruta.CalculoRuta(); // Web Service-era deitu. string sXML = Convert.ToString(webRuta.calcularruta( "550497","4790307",””,””,"549665","4789587")); -------------------------------------------

