gfa web services dokumentazio teknikoa lurralde ... 1. taula. kontsulta motaren arabera eskatzen...

Download GFA Web Services Dokumentazio Teknikoa Lurralde ... 1. Taula. Kontsulta motaren arabera eskatzen diren

If you can't read please download the document

Post on 14-Jun-2020

0 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

  • 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.h tml#soatechs

    | Gipuzkoa.net | Mugikortasuneko eta Lurralde Antolaketako Departamentua

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

  • 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

    http://b5m.gipuzkoa.net/ws/dfg-callejero-context-root/CallejeroSoapHttpPort http://b5m.gipuzkoa.net/ws/dfg-toponimo-context-root/ToponimoSoapHttpPort http://b5m.gipuzkoa.net/ws/dfg-dibujar-context-root/DibujarSoapHttpPort http://b5m.gipuzkoa.net/ws/dfg-localizar-context-root/LocalizarPorIdSoapHttpPort

  • 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

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

  • 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-

Recommended

View more >