1:5000 web - Gipuzkoako Foru Aldundia

SOAP API Dokumentazio Teknikoa (PDF deskargatu)

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 (SOAP API 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

Volver al índice

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 "SOAP API Home Page" izeneko web-orri bat dauka (Ikus 1. Irudia. Web Zerbitzuaren Home Page-aren Adibidea. Kontsulta Zerbitzua), WSDL fitxategira, test-orrira edo "Editor Page" orrira sartzeko bidea ematen duena, JavaScript interfazearen dokumentazioa, eta zerbitzuan erabil daitezkeen eragiketa edo funtzioen zerrenda.

WSDL (SOAP API 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.

1.Callejero

2.Toponimia

3.Dibujar

4.Localizar

5.Consultar

6.Calcular Ruta

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

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

Volver al índice

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.

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.

Zerbitzuaren Eragiketaren Testa gauzatzeko Orrialdea

Volver al índice

3.2 Testa, probazko aplikazioaren bitartez

3.2 Testa, probazko aplikazioaren bitartez

Gaur egun SOAP API-ko Plataformaren Testaren aplikazioa ondoko helbidean eskura daiteke:

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

Interfaze honetako "Run" botoia sakatuz aplikazioa hasten da. Ikus 4. Irudia. SOAP API-ko 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. SOAP API-ko Testaren Aplikazioa Hasteko Web Interfazea

Interface Web de Arranque de la Aplicación de Test de SOAP API

Oharra: SOAP API-ko Testaren Aplikazioa Hasteko Web Interfazea

Volver al índice

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.

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

Bilaketa mota
Muni Calle Zenbakia Edificio CP Distrito Secció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
Sección - x x x x x x

Volver al índice

4.1.2 Sarrera-parametroak

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

Kale-izendegiaren Web zerbitzuaren sarrera-parametroak
Izena Mota Balioen Adbk
Mota 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 String Posta kodea: 001
Distrito String Barrutia: 04
Sección String Atala: 002

Volver al índice

4.1.3 Irteera-parametroak

4.1.3 Irteera-parametroak

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

2. Taula. Kontsulta motaren arabera itzulitako irteera-parametroak

Bilaketa mota
Muni Calle Numero Edificio CP Distrito Sección
Muni x x x x - x x
codmuni x x x x - x x
Calle - x x x - - -
codcalle - x x x - - -
Zenbakia - - x x - - -
bis - - x x - - -
nomedif - - x x - - -
codpostal - - x x x - -
Distrito - - x x - x x
Sección - - 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 - - x
urlGoogle x x x x x - -

4.1.3.1 Irteera-datuen egitura

2. Taula. Kontsulta motaren arabera itzulitako irteera-parametroak
Izena Mota Balioen Adbk
return WsreplyUser  
objectOut Array de WscallobjUser  

Izena Mota Balioen Adbk
wsmessage String  
wsstatus Hamartarra  

WscallobjUser irteera-datu mota bat da, ondoko parametroak dituena:

WscallobjUser parametroak
Izena Mota Balioen Adbk
Muni String ALBIZTUR
codmuni String 004
Calle String ALBIZTUR NUCLEO
codcalle String 1110
Numero String 045
bis String A
nomedif String ARKATZPE
codpostal String 20495
Distrito String 01
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/LurbiraRotAround Pt.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

Irteera-parametroen deskribapena
Mota Deskribapena
Muni Udalerriaren izena
codmuni Udalerriaren kodea
Calle Kalearen izena
codcalle Kalearen kodea
Numero Número del portal
bis Bis
nomedificio Eraikinaren izena
codpostal Posta Kodea
Distrito Distrito
Sección Sección
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, Gipuzkoa 3D 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, Gipuzkoa 3D 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.

Volver al índice

4.1.4 Kode bat adibide gisa

Hurrengo C# adibideak (Visual Studio 2005-erako) SOAP API-ra 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;
 -----------------------------------------------

// Limpiar los resultados anteriores.
callejeroBindingSource.Clear();
Refresh();

// Crear instancia del servicio web.
webCall = news ws_Callejero.Callejero;

// Llamar al Web Service
ws_Callejero.CallejeroUser_buscarcallejero_Out t webCallMuniOut = webCall.buscarcallejero ("0","Calle","","004","SANTA","","","","","",","");

// Si ha funcionado y nos ha devuelto algo, pasar los datos al DataSource
if (webCallMuniOut.@return.wsstatus == -1)
        MessageBox.Show(webCallMuniOut.@return.wsmessage);
else
                if ((Convert.ToInt16(webCallMuniOut.@return.wsstatus)) >0)
                        callejeroBindingSource.DataSource = webCallMuniOut.objectOut;

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

Volver al índice

5. "Buscar Topónimo" Web Zerbitzua

5.1 "toponimo" Eragiketa

5.1.1 Sarrera-parametroak

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.

Sartzeko parametroak:

Sarrera-parametroak
Izena Mota Balioak
toponimo String Bilatu beharreko katea.
Adibideak: "victor" edo "aduana 13 irun"
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa

Volver al índice

5.1.2 Irteera-parametroak

Irteerako parametroak:
Izena Mota Balioak
return Hamartarra Itzulitako erregistroen kopurua
toponimoarrOut Array de WstopobjUser  

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

3. Taula. Sarrera-parametroetarako adibidea: toponimo=victor, lengua=0
Izena Mota Balioen Adbk
Izena String VICTOR HUGO KALEA
Mota String CALLE
otro String HERNANI
codigo String K_040_1608
direccion String  
XEd50UTM Hamartarra 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_1608lengua=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

5.1.2.1 Irteera-parametroen deskribapenaa

Irteera-parametroen deskribapena
Mota 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 da[1]
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, Gipuzkoa 3D 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, Gipuzkoa 3D 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.

Volver al índice

5. "Buscar Topónimo" Web Zerbitzua

5.1.3 Kode bat adibide gisa

Hurrengo C# adibideak (Visual Studio 2005-erako) SOAP API-ra nola deitu erakusten du, toponimo=victor eta lengua=0 parametroekin; horrek CALLE eta EDIFICIO moten 16 erregistro itzultzen ditu.

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

private ws_BuscarTopo.Toponimo webTop;
-----------------------------------------------

// Limpiar los resultados anteriores.
toponimoarrOutBindingSource.Clear();
Refresh();

// Crear instancia del servicio web.
webTop = new ws_BuscarTopo.Toponimo();

// Llamar al Web Service
ws_BuscarTopo.ToponimoUser_buscartoponimo_Out webTopOut = webTop.buscartoponimo; ("victor","0" );

// Escribir el número de registros devueltos en la ventana.
TxtRegistros.Text = Convert.ToString(webTopOut.@return);

// Si ha funcionado y nos ha devuelto algo, pasar los datos al DataSource
if ((Convert.ToInt16(TxtRegistros.Text)) > 0)
      toponimoarrOutBindingSource.DataSource = webTopOut.toponimoarrOut;

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

Volver al índice

6. "Dibujar Imagen" Web Zerbitzua

6.1 "dibujarimagen" 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)

6.1.1 Sarrera-parametroak

Sartzeko parametroak:
Izena Mota Balioak
ix1 String X minimoa Adb. 540000
iy1 String Y minimoa Adb. 4740000
ix2 String X maximoa Adb. 610000
iy2 String Y maximoa Adb. 4810000
iwidth String Zabalera pixeletan Adb. 600
iheight String Altuera pixeletan Adb.. 400
iescenario String Lekua, Adibidez: PUBLI
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
mapaselectarr WsmapasselectUser-en Array-a  

"WsmapasselectUser" mota honetako objektu bat da:
Izena Mota Balioen Adbk
Izena             String farmacias
Egoera String       sí
Mota String Clase, Grupo, Mapa      
Farmazien ikuspena sartzeko adibide bat honakoa litzateke:
Izena Egoera Mota
Invisible sí Clase
Invisible             sí Grupo
farmacias sí             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.

6.1.2 Irteera-parametroak

Irteera-datuen egitura
Mota Balioen Adbk
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

Volver al índice

6.2 Kode bat adibide gisa

Hurrengo C# adibideak (Visual Studio 2005-erako) SOAP API-ra 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.

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

private ws_BibImagen.Dibujar();
 -----------------------------------------------

// Crear instancia del servicio Web.
webDibImg = new ws_DibImagen.Dibujar();
Refresh();

// Array para la selección de mapas.
ws_DibImagen.WsmapasselectUser[] nomArr = null;

// Llamar al Web Service
ws_DibImagen.DibujarUser_dibujarimagen_Out webDibImgOut =
webDibImg.dibujarimagen ("540000","4740000","610000","4810000","629","362","PUBLI","0", nomArr);

// Dibujar la imagen en un PictureBox.
PictureBox1.ImageLocation = webDibImgOut.oimagepathOut;

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

Volver al índice

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.

Sartzeko parametroak:

Sartzeko parametroak:
Izena Mota Balioak
categoría String Escenario Adb. PUBLI
lengua       String      
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa

Irteerako parametroak:

Irteera-datuen egitura
Izena Mota Balioen Adbk
WsreplyUser String  
WsmapasUser WsmapasUser-en Array-a  
"WsreplyUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
wsmessage String  
wsstatus Hamartarra  
"WsmapasUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
Clase       String       Actividades      
grupo String Turismo
mapa String T_19
descripcion String Playas
MActivado String n
GActivado String n
CActivado String n

Volver al índice

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 SOAP API-eko buscarcallejero eta Buscar Toponimo SOAP API-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

7.1.1 Sarrera-parametroak

Sartzeko parametroak:
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
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 WsmapasselectUser  
"WsmapasselectUser" irteera-datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
Izena String farmacias
Egoera String sí
Mota 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.

7.1.2 Irteera-parametroak

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

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipocallejerosUser  
"TipocallejerosUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
listaDirecciones DireccionPostalUser-en Array-a.  
listaActividades ActividadUser-en Array-a.  

Adibidea : E_51507

"DireccionPostalUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
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 Adbk
tipoActividad String MONUMENTO
nombreActividad String Maria Cristina
ATipoActividad String F.1.1
a2NombreActividad String 23255
a1NombreActividad String 69241

Volver al índice

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

7.2.1 Sarrera-parametroak

Sartzeko parametroak:
Izena Mota Balioak
identificador String Kokatu beharreko jasotzearen kodea
Adibideak: Q_002, Q_001_6429a1a.dwg
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 WsmapasselectUser  

7.2.2 Irteera-parametroak

Irteerako parametroak:
Izena Mota Balioak
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut CartoUser  
"CartoUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioak
Cartofototeca TipocartofototecaUser  

Adibidea : Q_002

"TipocartofototecaUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioak
propietario String AYTO. de LEZO
lugar String LEZO
Eskala 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

Volver al índice

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

7.3.1 Sarrera-parametroak

Sartzeko parametroak:
Izena Mota Balioak
identificador String Kokatu beharreko entitatearen kodea
Adibideak :
  • Cuenca: C_11
  • Río: I_16072
escala String Adibidea: 5000 edo hutsik
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 WsmapasselectUser  

7.3.2 Irteera-parametroak

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

Irteerako parametroak:
Izena Mota Balioak
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TiporioUser  
"TiporioUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
rio String UROLA
cuenca String rioUROLA
ARio String 12
ACuenca String 16072
wktVec base64Binary  
wkbVec String  
gmlVec String  

Adibidea : I_16072

Volver al índice

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

7.4.1 Sarrera-parametroak

Sartzeko parametroak:
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
escala String Adibidea: 5000 edo hutsik
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 WsmapasselectUser  

7.4.2 Irteera-parametroak

Irteerako parametroak:
Izena Mota Balioak
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipotopoUser  
"TipotopoUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
municipio String URNIETA
barrio String  
orografia String MONTE ABALLARRI
AMunicipio String  
AOrografia String 24071
wktVec String  
wkbVec base64Binary  
gmlVec String  

Adibidea : G_24071

Volver al índice

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

7.5.1 Sarrera-parametroak

Sartzeko parametroak:
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
escala String Adibidea: 5000 edo hutsik
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 WsmapasselectUser  

7.5.2 Irteera-parametroak

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

Irteerako parametroak:
Izena Mota Balioak
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipovialesUser  
"TipovialesUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
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 Adbk
empresa String (RENFE)
tipo String LÍNEA DE TREN
sentido String IDA (OUTWARD)
ruta String IRUN-BRINKOLA
paradas ParadaUser-en Array-a  
"TipoparadaUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
nombre String ELOSEGI ALKATEA,3 AURREAN (DONOSTIA)
paradas ParadaUser-en Array-a  

Adibidea : RA_176

"TipolineasUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
empresa String HIJOS A. AREIZAGA
tipo String línea de autobus interurbano
sentido String IDA (OUTWARD)
ruta String A3-PASAI SAN PEDRO-DONOSTIA/SAN SEBASTIAN

Volver al índice

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

7.6.1 Sarrera-parametroak

Sartzeko parametroak:
Izena Mota Balioak
x String Coordenada
y String Coordenada
tipo String UTM, Lat-Long , Lat-Long-WGS84
escala String Adibidea: 5000 edo hutsik
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
mapaselectarr WsmapasselectUser  

7.6.2 Irteera-parametroak

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipoxyUser  
"TipoxyUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
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

Volver al índice

7.7 Kode bat adibide gisa

Hurrengo C# adibideak (Visual Studio 2005-erako) LocalizarPorId - Callejero SOAP API-ra 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.

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

private ws_Localizar.LocalizarPorId webId;
-----------------------------------------------

// Limpiar los resultados anteriores.
listaActividadesBindingSource.Clear();
listaDireccionesBindingSource.Clear();
Refresh();

// Array para la selección de mapas.
ws_Localizar.WsmapasselectUser[] nomArr = null;

// Crear instancia del servicio Web.
webId = new ws_Localizar.LocalizarPorId();

// Llamar al Web Service
ws_Localizar.LocalizarPorIdUser_localizaridcallejero_Out webIdOut =
webId.localizaridcallejero("A_11933","","0","si","PUBLI","447","307","GML",nomArr);

/ Si ha funcionado y nos ha devuelto algo, pasar los datos al DataSource
 if (webIdOut.objectOut.listaActividades != null)
     listaActividadesBindingSource.DataSource = webIdOut.objectOut.listaActividades;

/ Si ha funcionado y nos ha devuelto algo, pasar los datos al DataSource
 if (webIdOut.objectOut.listaDirecciones != null)
     listaDireccionesBindingSource.DataSource = webIdOut.objectOut.listaDirecciones;

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

Volver al índice

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

8.1.1 Sarrera-parametroak.

Sartzeko parametroak:
Izena Mota Balioak
tema String COORDENADAS
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
coorX String X en ED50 UTM30N Ejem. 581082
coorY String Y en ED50 UTM30N Ejem. 4793752

8.1.2 Irteera-parametroak.

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
objectOut TipocoordenadaUser  
"TipocoordenadaUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
pendiente String 20-30 % (lidar: 5-10 %)
orientacion String ESTE (lidar: SUDESTE)
ed50 Tipoed50User  
wgs84 Tipowgs84User  
Tipoed50User es un tipo de dato con el siguiente parámetros:
Izena Mota Balioen Adbk
longitudGeograficas String -2 0 1.9
latitudGeograficas String 43 17 29.2
alturaGeograficas String 67m
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 Adbk
longitudGeograficas String -2 0 6.5
latitudGeograficas String 43 17 25.2
alturaGeograficas String 117m
XGeocentricas String 4647142 m
YGeocentricas String -162430 m
ZGeocentricas String 4351116 m

Volver al índice

8.2 Toponimia Kontsultatzeko Eragiketa

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

8.2.1 Sarrera-parametroak.

Sartzeko parametroak:
Izena Mota Balioak
tema String TOPONIMIA
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
coorX String X en ED50 UTM30N Ejem. 583269
coorY String Y en ED50 UTM30N Ejem. 4797499

8.2.2 Irteera-parametroak.

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
objectOut TipotoponimiaUser  
"TipotoponimiaUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
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  

Volver al índice

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

8.3.1 Sarrera-parametroak.

Sartzeko parametroak:
Izena Mota Balioak
tema String VIAL
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
coorX String X ED50 UTM30N-en Adb. 583515
coorY String Y ED50 UTM30N-en Adb. 4795662

8.3.2 Irteera-parametroak.

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
objectOut TipovialUse  
"TipovialUse" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
calle String GREGORIO ORDOÑEZ
carretera String  
carreteraDesc String  
municipio String DONOSTIA-SAN SEBASTIAN
ACalle String 7920
ACarretera String  
AMunicipio String 069

Volver al índice

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

8.4.1 Sarrera-parametroak.

Sartzeko parametroak:
Izena Mota Balioak
tema String MUNICIPIO, EDIFICIO, CALLE
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
coorX String X ED50 UTM30N-en Adb. 582583
coorY String Y ED50 UTM30N-en Adb. 4797168

8.4.2 Irteera-parametroak

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
objectOut TipocallejeroUser  
"TipocallejeroUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
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 Adbk
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 Adbk
nombreActividad String MONUMENTO
nombreActividad String Maria Cristina
ATipoActividad String F.1.1
a2NombreActividad String 23255
a1NombreActividad String 69241

Volver al índice

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

8.5.1 Sarrera-parametroak.

Sartzeko parametroak:
Izena Mota Balioak
tema String RIO
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
coorX String X ED50 UTM30N-en Adb. 582868
coorY String Y ED50 UTM30N-en Adb. 4797335

8.5.2 Irteera-parametroak.

Irteerako parametroak:
Izena Mota Balioen Adbk
return String  
objectOut TiporioUser  
"TiporioUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
rio   rio URUMEA
cuenca   URUMEA
ARio   16436
ACuenca   13

Volver al índice

8.6 Ibaiak 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

8.6.1 Sarrera-parametroak.

Sartzeko parametroak:
Izena Mota Balioak
tema String CARTOGRAFIA, CINCOMILES,FOTOSAEREAS
lengua String
  • 0.Gaztelania
  • 1.Euskara
  • 2.Ingelesa
  • 3.Frantsesa
coorX String X ED50 UTM30N-en Adb. 581082
coorY String Y ED50 UTM30N-en Adb. 4793752

8.6.2 Irteera-parametroak.

Irteerako parametroak:
Izena Mota Balioen Adbk
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 Adbk
pasada String 06a
fotograma String 6374
link String http://b5m.gipuzkoa.net...
tipo String Abril/Mayo - 1:15.000 - vuelo completo - negativos y diapositivas
año String 2001

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

"TipocincomilUser" edatu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
fecha String 1983
enlace String http://b5m.gipuzkoa.net...

Adibidez : tema=CINCOMILES, x=573993, y=4781593

"TipocartofototecaUser" datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen Adbk
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

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

Volver al índice

8.7 Kode bat adibide gisa.

Hurrengo C# adibideak (Visual Studio 2005-erako) Consultar - Rios SOAP API-ra nola deitu erakusten du, ondoko parametroekin:

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

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

private ws_Consultar.ConsultarPorCoordenadas webId;
-------------------------------------------

// Limpiar los resultados anteriores.

consultarPorCoordenadasUser_consultarcoorrio_OutBindingSource.Clear();
Refresh();

// Crear instancia del servicio Web.

webXY = new ws_Consultar.ConsultarPorCoordenadas();

// Llamar al Web Service.

ws_Consultar.ConsultarPorCoordenadasUser_consultarcoorrio_Out webXYOut
= webXY.consultarcoorrio("RIO","0","582868","4797335");

// Si ha funcionado, pasar los datos al DataSource

if (webXYOut.@return == "OK")
consultarPorCoordenadasUser_consultarcoorrio_OutBindingSource.DataSource
= webXYOut.objectOut;
-------------------------------------------

Volver al índice

9. Ibilbidea Kalkulatu

9.1 Ibilbidea Kalkulatu

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

9.1.1 Sarrera-parametroak.

Sartzeko parametroak:
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
ixd String Amaierako X koordenatua Adb. 549665
iyd String Amaierako Y koordenatua Adb. 4789587

9.1.2 Irteera-parametroak.

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>

Volver al índice

9.2 Kode bat adibide gisa.

Hurrengo C# adibideak (Visual Studio 2005-erako) Consultar - Rios SOAP API-ra 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.

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

private ws_Ruta.CalculoRuta webId;
-----------------------------------------------

// Limpiar los resultados anteriores.
lsbCalcRutaOut.Items.Clear();
Refresh();

// Crear instancia del servicio web.
webRuta = new ws_Ruta.CalculoRuta();

// Llamar al Web Service
string sXML = Convert.ToString(webRuta.calcularruta(
                 "550497","4790307","","","549665","4789587"));

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

Volver al índice

Gipuzkoako Atari Instituzionalaren logotipoa eta orri nagusirako esteka
  | Gipuzkoa.net   | Ingurumeneko eta Lurralde Antolaketako Departamentua     © 1997-2012