Post on 14-Jun-2020
GFA Web Services - Dokumentazio Teknikoa
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
GFA Web Services Dokumentazio Teknikoa
Lurralde Plangintzako Zerbitzua
Gipuzkoako Foru Aldundia
GFA Web Services - Dokumentazio Teknikoa
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
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
GFA Web Services - Dokumentazio Teknikoa
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
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
8.7 Kode bat adibide gisa
9 Ibilbidea Kalkulatu
9.1 Ibilbide baten Koordenatuak Kontsultatzeko Eragiketa 9.1.1 Sarrera-parametroak 9.1.2 Irteera-parametroak
9.2 Kode bat adibide gisa
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
3. Irudia. Zerbitzuaren Eragiketaren Testa gauzatzeko Orrialdea.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
‘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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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 (webCallMuniOut.@return.wsstatus == -1)
MessageBox.Show(webCallMuniOut.@return.wsmessage); else
if ((Convert.ToInt16(webCallMuniOut.@return.wsstatus)) > 0) callejeroBindingSource.DataSource = webCallMuniOut.objectOut;
-------------------------------------------
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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.
5.1.1 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
5.1.2 Irteera-parametroak
Izena Mota Balioak return hamartarra Itzulitako erregistroen kopurua. toponimoarrOut WstopobjUser-en Array-
a
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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)
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
6.1.1 Sarrera-parametroak
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
1- Euskara 2- Ingelesa 3- Frantsesa
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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
6.1.2 Irteera-parametroak
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
6.2 Kode bat adibide gisa
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; -------------------------------------------
OHARRA Web zerbitzua nola erregistratzen den ikusteko, ikus Kale-izendegiaren adibidea.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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.
6.3.1 Sarrera-parametroak
Izena Mota Balioak
Escenario Adb. PUBLI categoria String lengua String 0- Gaztelania
1- Euskara 2- Ingelesa 3- Frantsesa
6.3.2 Irteera-parametroak
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
7.1.1 Sarrera-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 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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
7.1.2 Irteera-parametroak
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
Izena Mota Balioak identificador string Kokatu beharreko jasotzearen kodea
Adibideak: Q_002, Q_001_6429a1a.dwg 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
7.2.2 Irteera-parametroak
Izena Mota Balioen adibideak. return string imagenurlOut string http://b5m.gipuzkoa.net/internet/Gen
aImageSourcer... objectOut CartoUser
‘CartoUser’ datu mota bat da, ondoko parametroak dituena:
Izena Mota Balioen adibideak. Cartofototeca TipocartofototecaUser-en Array-a.
Adibidea: Q_002
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
‘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
7.3.1 Sarrera-parametroak
Izena Mota Balioak identificador string Kokatu beharreko entitatearen kodea
Adibideak: Cuenca: C_11 Río: I_16072 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 GML, WKT, WKB vector string
mapaselectarr WsmapasselectUser
7.3.2 Irteera-parametroak
Kokatzen den entitatearen informazio alfanumerikoa (ezaugarriak), irudi bat eta aukeran, gml,
wkb edo wkt fitxategiak lortzen dira.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
Izena Mota Balioen adibideak. return string imagenurlOut string http://b5m.gipuzkoa.net/internet/Gen
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
7.4.1 Sarrera-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 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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
altura String Sortutako irudiaren altuera
pixeletan. Adibidea: 600
vector String GML, WKT, WKB mapaselectarr WsmapasselectUser
7.4.2 Irteera-parametroak
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
7.5.1 Sarrera-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 Adibidea: 5000 edo hutsik escala String
lengua String 0- Gaztelania 1- Euskara 2- Ingelesa 3- Frantsesa
imagen String si/no
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
7.5.2 Irteera-parametroak
Kokatzen den entitatearen informazio alfanumerikoa (ezaugarriak), 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 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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
‘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
7.6.1 Sarrera-parametroak
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
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
7.6.2 Irteera-parametroak
Izena Mota Balioen adibideak. return String imagenurlOut String http://b5m.gipuzkoa.net/internet/Gen
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.
7.7 Kode bat adibide gisa
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;
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
// Funtzionatu badu eta zerbait itzuli badigu, datuak DataSource-era pasatu. if (webIdOut.objectOut.listaDirecciones != null) listaDireccionesBindingSource.DataSource = webIdOut.objectOut.listaDirecciones; -------------------------------------------
OHARRA Web zerbitzua nola erregistratzen den ikusteko, ikus Kale-izendegiaren adibidea.
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
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
8.1.2 Irteera-parametroak
Izena Mota Balioen adibideak. return string objectOut TipocoordenadaUser
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
‘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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
Izena Mota Balioak tema string TOPONIMIA lengua string 0- Gaztelania
1- Euskara 2- Ingelesa 3- Frantsesa
coorX string X ED50 UTM30N-en Adb. 583269 coorY string Y ED50 UTM30N-en Adb. 4797499
8.2.2 Irteera-parametroak
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
Izena Mota Balioak tema string VIAL lengua string 0- Gaztelania
1- Euskara 2- Ingelesa 3- Frantsesa X ED50 UTM30N-en Adb. 583515 coorX string Y ED50 UTM30N-en Adb. 4795662 coorY string
8.3.2 Irteera-parametroak
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
8.4.1 Sarrera-parametroak
Izena Mota Balioak tema string MUNICIPIO, EDIFICIO, CALLE lengua string 0- Gaztelania
1- Euskara 2- Ingelesa 3- Frantsesa X ED50 UTM30N-en Adb. 582583 coorX string Y ED50 UTM30N-en Adb. 4797168 coorY string
8.4.2 Irteera-parametroak
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
‘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
8.5.1 Sarrera-parametroak
Izena Mota Balioak tema string RIO lengua string 0- Gaztelania
1- Euskara 2- Ingelesa 3- Frantsesa X ED50 UTM30N-en Adb. 582868 coorX string Y ED50 UTM30N-en Adb. 4797335 coorY string
8.5.2 Irteera-parametroak
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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
8.6.1 Sarrera-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
‘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
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
‘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
8.7 Kode bat adibide gisa
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.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
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
9.1.1 Sarrera-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
Amaierako X koordenatua Adb. 549665 ixd string Amaierako Y koordenatua Adb. 4789587 iyd string
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>
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua
DFG Web Services - Documentación Técnica
9.2 Kode bat adibide gisa
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")); -------------------------------------------
OHARRA Web zerbitzua nola erregistratzen den ikusteko, ikus Kale-izendegiaren adibidea.
| Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua