Web 1:5000 - Diputación Foral de Gipuzkoa

SOAP API Documentación Técnica (descargar PDF)

1. Introducción

El presente documento constituye la descripción técnica de la Plataforma de Servicios Web desarrollada para promover el acceso a la Infraestructura de Datos Espaciales de la Diputación Foral de Gipuzkoa. La documentación está orientada al integrador de soluciones "consumidoras"de los Servicios Web, disponibles actualmente en la plataforma. Constituye la descripción funcional y de interface, detallando los parámetros de entrada y salida de cada una de las funciones de los mismos.

El conocimiento de estas funciones y su interface (parámetros de entrada y salida) , permite integrar en aplicaciones terceras, variadas funcionalidades de consulta del almacén de datos espaciales, a través de Internet.

Para información genórica sobre el estándar, recomendamos la siguiente documentación de Sun Microsystems, Inc:
http://java.sun.com/developer/technicalArticles/WebServices/soa2/WSProtocols.html#soatechs

Volver al índice

2 Descripción genórica de los Servicios Web

La plataforma de Servicios Web cuenta con una serie de Servicios que ofrecen cada uno, una o más operaciones posibles (funciones). Se describen en este documento cada una de ellas.

Cada uno de los Servicios cuenta con una página Web llamada "SOAP API Home Page" (Ver Ilustración 1 Ejemplo de Home Page de Servicio Web. Servicio de Consulta por Coordenadas), que da acceso a al fichero WSDL, a la página de test o "Editor Page", documentación de la interface JavaScript, y la lista de operaciones o funciones disponibles para el servicio.

El fichero WSDL (SOAP API Descriptor Lenguaje) es un fichero XML que indica principalmente, qué formato utilizar en la conformación de una petición al servicio y el significado de la petición. Se puede salvar en local.

La página de test permite invocar una petición a alguna de las funciones del servicio entrando los correspondientes parámetros de entrada en un interface web.

Se indican a continuación los servicios desarrollados, con una descripción genórica de su funcionalidad y las direcciones a sus correspondientes "Home Page".

1.Callejero

2.Toponimia

3.Dibujar

4.Localizar

5.Consultar

6.Calcular Ruta

Ilustración 1 Ejemplo de Home Page de Servicio Web. Servicio de Consulta por Coordenadas

Home Page de Servicio Web. Servicio de Consulta por Coordenadas

Volver al índice

3. Test de Servicios

3.1 Test en entorno Web

Desde la página de edición del servicio se accede a la de Test haciendo clic en la operación del servicio que quiera testear (Ver Ilustración 2 Acceso a la página de edición desde la página principal del Servicio de Toponimia pulsando en la operación "buscartoponimo").

Ilustración 2 Acceso a la página de edición desde la página principal del Servicio de Toponimia pulsando en la operación "buscartoponimo"s

Acceso a la página de edición desde la página principal del Servicio de Toponimia pulsando en la operación buscartoponimos

Esta página se puede utilizar para testear diferentes parámetros de entrada para el servicio ya que se visualiza una tabla que presenta los diferentes parámetros o elementos, sus tipos de datos, y unos cuadros de texto para introducir posibles valores. Si el parámetro es opcional según la definición del servicio, aparece una casilla de verificación delante del parámetro.

  • Marcar la casilla de verificación si se pretende incluir el parámetro en el test.
  • Deseleccionar la casilla de verificación si no se quiere incluir ningún valor en el parámetro opcional.
  • Hacer en clic en "Preview SOAP" para visualizar la petición SOAP para la operación con los parámetros establecidos y se accede a la página de test (Ver Ilustración 3 Página de ejecución de Test de Operación del Servicio.) . Pulsando Invoke se realiza la petición y se muestra el XML de respuesta.

Ilustración 3 Página de ejecución de Test de Operación del Servicio.

Página de ejecución de Test de Operación del Servicio.

Volver al índice

3.2 Test a través de la aplicación de Prueba

3.2 Test a través de la aplicación de Prueba

Esta disponible actualmente una aplicación de Test de la Plataforma de SOAP API que se encuentra disponible en la dirección:

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

Pulsando el botón "Run" de este interface de acceso (Ver Ilustración 4 Interface Web de Arranque de la Aplicación de Test de SOAP API) se arranca la aplicación.

Este aplicativo constituye un ejemplo implementado en tecnología .Net de Microsoft que permite hacer llamadas a todos los Servicios Web, visualizar los resultados ya sean imágenes o de datos alfanuméricos, presentados en formularios de aplicación.

Incluye datos de ejemplo seleccionables directamente para poder ejecutar de forma rápida, ejemplos fijos, sin tener que buscar casos de uso válidos de parámetros de entrada.

Este aplicativo permite el testeo de Servicio a partir de datos de entrada válidos de una manera más rápida, a parte de representar un ejemplo de solución.

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

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

Nota: Consultar la documentación de la Herramienta de Test Test.

Volver al índice

4. Servicio Web "Consulta de Callejero"

4.1 Operación "buscarcallejero".

4.1.1 Descripción funcional

La operación buscarcallejero es la única de este servicio. Permite realizar diferentes tipos de consulta de diversas entidades del callejero: muncipios, calles, números de portal, edificios, códigos postales, etc., en función de distintas opciones de parámetros de entrada. El nivel de detalle (información de respuesta del servicio) cambia en función del tipo de Búsqueda que se realice.

En la Tabla 1 Parámetros de entrada requeridos por tipo de consulta, se indican los parámetros necesarios en la llamada al servicio, para cada uno de los tipos de Búsquedas que se pueden realizar con este servicio.

Ya que se puede especificar un municipio por su nombre o código, y una calle también por su nombre o código, aunque en la tabla aparezcan marcados ambos, se puede invocar el servicio con cualquiera de los dos campos. Hay que considerar que si existen datos en el campo "muni", el servicio no usa el campo "codmuni". Igualmente, si existen datos en el campo "calle", el servicio no usa el campo de "codcalle".

Tabla 1 Parámetros de entrada requeridos por tipo de consulta

Ejemplo de interpretación de la tabla: Una Búsqueda de tipo Calle filtra la respuesta en función de los campos de muni o codmuni, calle o codcalle, codpostal, distrito y seccion.

Para las Búsquedas de tipo Numero y Edificio, es obligatorio elegir un municipio.

Tipo de Búsqueda
Muni Calle Número 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 Parámetros de Entrada

La siguiente tabla muestra los parámetros de entrada del servicio Web del callejero.

Parámetros de entrada del servicio Web del callejero
Nombre Tipo Valores de ej.
Tipo String Los distintos tipos de Búsqueda de la tabla pudiendo ser alguno de los siguientes: Muni, Calle, Numero, Edificio, CP, Distrito o Seccion
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
Muni String Nombre del Municipio, por ejemplo: donostia
codmuni String Código Eustat del Municipio, por ejemplo: 004
Calle String Nombre de la calle, por ejemplo: aldakoenea
codcalle String Código Eustat de la Calle, por ejemplo:1200
Numero String Número de portal, por ejemplo: 010
bis String Bis, por ejemplo: A o vacia
nomedif String Es el nombre del edificio, por ejemplo: etxeberria
codpostal String Código Postal: 001
Distrito String Distrito: 04
Sección String Sección: 002

Volver al índice

4.1.3 Parámetros de Salida

4.1.3 Parámetros de Salida

En la tabla Tabla 2 Parámetros de Salida devueltos por tipo de consulta. se indican los campos devueltos por el servicio Web en función del tipo de Búsqueda.

Tabla 2 Parámetros de Salida devueltos por tipo de consulta.

Tipo de Búsqueda
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 - - -
Número - - 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 Estructura de datos de salida

Tabla 2 Parámetros de Salida devueltos por tipo de consulta.
Nombre Tipo Valores de ej.
return WsreplyUser  
objectOut Array de WscallobjUser  

Nombre Tipo Valores de ej.
wsmessage String  
wsstatus Decimal  

WscallobjUser es un tipo de dato de salida con los siguientes parámetros:

parámetros "WscallobjUser"
Nombre Tipo Valores de ej.
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 Decimal 570729
YEd50utm Decimal 4775742
ZEd50 Decimal 259
lonEd50 Decimal -2.13045033281384
latEd50 Decimal 43.1303388591911
lonWgs84 Decimal -2.13169361178994
latWgs84 Decimal 43.12923609425
cod3d Decimal 259
x1Ed50utm Decimal 570716.956
y1Ed50utm Decimal 4775735.155
x2Ed50utm Decimal 570733.538
y2Ed50utm Decimal 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………

Ejemplo: Tipo Edificio, codmuni=004, Bis=A.

4.1.3.2 Descripción de los parámetros de salida

Descripción de los parámetros de salida
Tipo Descripción
Muni Nombre del municipio
codmuni Código del municipio
Calle Nombre de la Calle
codcalle Código de la Calle
Numero Número del portal
bis Bis
nomedificio Nombre del edificio
codpostal Código Postal
Distrito Distrito
Sección Sección
XEd50utm Coordenada X (ED50 UTM 30 Norte) del centro del MBR de los objetos
YEd50utm Coordenada Y (ED50 UTM 30 Norte) del centro del MBR de los objetos
ZEd50 Altura (ED50 UTM 30 Norte) del centro del MBR de los objetos
lonEd50 Longitud (ED50) del centro del MBR de los objetos
latEd50 Latitud (ED50) del centro del MBR de los objetos
lonWgs84 Longitud (WGS84) del centro del MBR de los objetos
latWgs84 Longitud (WGS84) del centro del MBR de los objetos
cod3d Altura virtual (ED50 UTM 30 Norte) del centro del MBR de los objetos para el vuelo virtual Gipuzkoa 3D
x1Ed50utm Coordenada X minima (ED50 UTM 30 Norte) del centro del MBR de los objetos.
y1Ed50utm Coordenada Y minima (ED50 UTM 30 Norte) del centro del MBR de los objetos
x2Ed50utm Coordenada X maxima (ED50 UTM 30 Norte) del centro del MBR de los objetos
y2Ed50utm Coordenada Y maxima (ED50 UTM 30 Norte) del centro del MBR de los objetos
urlInfo Enlace la aplicación Web "b5m".
Es la dirección url dónde se puede consultar más información en la página Web 1:5000
url2d Enlace la aplicación Web "b5m".
Es un enlace tipo url a la página Web 1:5000 que permite visualizar el resultado de la consulta con una configuración de fondo tipo mapa.
urlOrto Enlace la aplicación Web "b5m".
Es un enlace tipo url a la página Web "b5m" que permite visualizar el resultado de la consulta con una configuración de la imagen de fondo tipo ortofoto.
url3d Es un enlace tipo url a la página Web "b5m" que arranca el vuelo virtual Gipuzkoa 3D en la posición geográfica resultado de la consulta.
urlGoogle Es un enlace (dirección url) de google maps dónde se visualiza la zona resultado de la consulta.

Volver al índice

4.1.4 Código de ejemplo

El siguiente ejemplo de C# (para Visual Studio 2005) muestra como llamar al SOAP API con un tipo de Búsqueda "Calle", y parámetros de codmuni=004 y calle=SANTA, lo cual devuelve un registro.

Para registrar el servicio Web y crear los proxies, hace falta seguir los siguientes pasos:

  • 1. Seleccionar "Add Web Reference" desde la ventana del "Solution Explorer".
  • 2. En la ventana que aparece, mete el path del WSDL en el campo URL y el texto ws_Callejero en el campo "Web Reference Name" y seleccionar "Add Reference"
  • 3. Visual Studio genera automáticamente los proxies C# y el correspondiente DataSource.
  • 4. Para crear un DataGridView automáticamente que está vinculado con el DataSource, se puede arrastrar el objeto toponimoarrOut desde la ventana de "Data Sources" a un formulario.

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. Servicio Web "Buscar Topónimo""

5.1 Operación "toponimo"

5.1.1 Parámetros de Entrada

La operación toponimo permite consultar todos los elementos de la Base de Datos coincidentes con un texto dado. Dado un nombre, devuelve todos los toponimos de edificios, calles, ríos, etc.. que coinciden con él, asi como sus coordenadas de localización

Parámetros de entrada

Parámetros de entrada del servicio Web "buscar topónimos"
Nombre Tipo Valores
Topónimo String Cadena a buscar.
Ejemplos: "victor2" o "aduana 13 irun"
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés

Volver al índice

5.1.2 Parámetros de Salida

Parámetros de Salida
Nombre Tipo Valores
return Decimal Número de registros devueltos.
toponimoarrOut Array de WstopobjUser  

"WstopobjUser" es un tipo de dato de salida con los siguientes valores:

Tabla 3 Ejemplo para los parámetros de salida: toponimo=victor, lengua=0
Nombre Tipo Valores de ej.
Nombre String VICTOR HUGO KALEA
Tipo String CALLE
otro String HERNANI
codigo String K_040_1608
direccion String  
XEd50UTM Decimal 583009
YEd50UTM Decimal 4790785
ZEd50 Decimal 42
lonEd50 Decimal -1.9772408737149
latEd50 Decimal 43.2645252048455
lonWgs84 Decimal -1.97848413231404
latWgs84 Decimal 43.2634269038068
cod3d Decimal 42
x1Ed50UTM Decimal 582990.936
y1Ed50UTM Decimal 4790750.12
x2Ed50UTM Decimal 583052.8
y2Ed50UTM Decimal 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 Descripción de los parámetros de Salidaa

Descripción de los parámetros de Salida
Tipo Descripción
nombre El nombre de elemento encontrado que contiene la palabra clave consulada por el usuario.
tipo El tipo de nombre del que se trata, por ejemplo, EDIFICIO, MUNICIPIO, BARRIO, ARROYO, CALLE, DIRECCION POSTAL, etc.
otro Municipio, cuenca u otra información
codigo Es el código del elemento en la base de datos[1]
direccion Dirección postal si la tiene.
XEd50UTM Coordenada X (ED50 UTM30 Norte) del centro del MBR de los objetos
YEd50UTM Coordenada Y (ED50 UTM 30 Norte) del centro del MBR de los objetos
ZEd50 Altura (ED50 UTM30 Norte) del centro del MBR de los objetos
lonEd50 Longitud (ED50) del centro del MBR de los objetos
latEd50 Latitud (ED50) del centro del MBR de los objetos
lonWgs84 Longitud (WGS84) del centro del MBR de los objetos
latWgs84 Latitud (WGS84) del centro del MBR de los objetos
cod3d Altura virtual (ED50 UTM 30 Norte) del centro del MBR de los objetos para el vuelo virtual Gipuzkoa 3D
x1Ed50UTM Coordenada X minima (ED50 UTM30 Norte) del centro del MBR de los objetos.
y1Ed50UTM Coordenada Y minima (ED50 UTM 30 Norte) del centro del MBR de los objetos
x2Ed50UTM> Coordenada X maxima (ED50 UTM30 Norte) del centro del MBR de los objetos.
y2Ed50UTM Coordenada Y maxima (ED50 UTM 30 Norte) del centro del MBRMBRde los objetos
urlInfo Enlace la aplicación Web "b5m".
Es la dirección url dónde se puede consultar más información en la página Web 1:5000
url2d Enlace la aplicación Web "b5m".
Es un enlace tipo url a la página Web 1:5000 que permite visualizar el resultado de la consulta con una configuración de fondo tipo mapal.
urlOrto Enlace la aplicación Web "b5m".
Es un enlace tipo url a la página Web "b5m" que permite visualizar el resultado de la consulta con una configuración de la imagen de fondo tipo ortofoto.
url3d Es un enlace tipo url a la página Web "b5m" que arranca el vuelo virtual Gipuzkoa 3D en la posición geográfica resultado de la consulta.
urlGoogle Es un enlace (dirección url) de google maps dónde se visualiza la zona resultado de la consulta.

[1] Los código de elementos del almacén se pueden utilizar para otros Servicios Web, como por ejemplo en el de "LocalizarporId"

Volver al índice

5. Servicio Web "Buscar Topónimo""

5.1.3 Código de ejemplo

El siguiente ejemplo de C# (para Visual Studio 2005) muestra como llamar al SOAP API con parámetros de toponimo=victor y lengua=0, lo cual devuelve 16 registros de tipos CALLE y EDIFICIO.

Nota: Para ver como se registra el servicio Web, ver el ejemplo del Callejero.

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. Servicio Web "Dibujar Imagen"

6.1 Operación "dibujarimagen"

Esta función permite obtener una imagen tipo plano de situación o ortofoto, dadas dos coordenadas que definen la extensión de la misma ( MBR ). Devuelve el Minimun Bounding Rectangle de la imagen resultante asi como la URL de esta. Es posible especificar temas de información añadida a visualizar. Para establecer la visibilidad de los temas añadidos, se puede consultar antes los temas disponibles a través del la operación mapasdisponibles (ver punto siguiente)

6.1.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
ix1 String X minimo Ejem. 540000
iy1 String Y minimo Ejem. 4740000
ix2 String X maximo Ejem. 610000
iy2 String Y maximo Ejem. 4810000
iwidth String Anchura en pixel Ejem. 600
iheight String Altura en pixel Ejem. 400
iescenario String Escenario Ejemplo: PUBLI
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
mapaselectarr Array de WsmapasselectUser  

"WsmapasselectUser" es un objeto del siguiente tipo:
Nombre Tipo Valores de ej.
Nombre             String farmacias
estado String       sí
Tipo String Clase, Grupo, Mapa      
Un ejemplo para incluir la visualización de farmacias sería:
Nombre estado Tipo
Invisible sí Clase
Invisible             sí Grupo
farmacias sí             Mapa            

Ya que existe una jerarquéa de los temas que agrupa los temas en "Grupos" y los Grupos en "Clases", para activar un determinado tema habrá que activar también el grupo y clase a los que pertenece. Para saber que temas estan disponibles para un escenario dado, llamar a mapasdisponibles descrito en el punto siguiente.

6.1.2 Parámetros de Salida

Estructura de datos de salida:
Tipo Valores de ej.
return String  
oimagepathOut String Devuelve el path de la imagen generada:
http://b5m.gipuzkoa.net/internet/GenaImageSourcer?IMAGEID=2677484727 &RETCONTENTTYPE=image/png&RM=FALSE
x1 String X mínimo de la imagen generada
y1 String Y mínimo de la imagen generada
x2 String X máximo de la imagen generada
y2 String Y máximo de la imagen generada

Volver al índice

6.2 Código de ejemplo

El siguiente ejemplo de C# (para Visual Studio 2005) muestra como llamar al SOAP API con parámetros de :

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

El servicio Web genera la imagen y devuelve su URL.

Nota Para ver cómo se registra el servicio Web, ver el ejemplo del Callejero.

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 Operación "Mapas Disponibles"

Esta operación, dado un nombre de escenario (o categoría), devuelve una lista de clases, grupos y temas. Por lo tanto devuelve la lista de temas disponibles cuya visibilidad se puede activar en la petición de "dibujarimagen"

Parámetros de entrada

Parámetros de entrada
Nombre Tipo Valores
categoría String Escenario Ejemplo: PUBLI
lengua       String      
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés

Parámetros de Salida

Estructura de datos de salida:
Nombre Tipo Valores de ej.
WsreplyUser String  
WsmapasUser Array de WsmapasUser  
"WsreplyUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
wsmessage String  
wsstatus Decimal  
"WsmapasUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
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. Servicio Web "Localizar"

El Servicio Web de Localizar contiene diferentes operaciones ( o funciones) que permiten realizar la localización geográfica de determinadas entidades concretas de la base de datos como son: municipios, calles, núcleos urbanos, carreteras, puntos kilométricos, topónimos, rios, o simplemente unas coordenads xy; por poner algunos ejemplos.

Cada una de las operaciones disponibles en este servicio agrupa la posibilidad de localizacion de unas determinadas entidades de idiosincrasia común.

La información devuelta es la dirección de una imagen que incluye el elemento localizado (url), información alfanumórica del elemento localizado, y en algunas operaciones o funciones se permite obtener, a parte de la imagen, la información geográfica (coordenadas) del elemento consultado en determinados formatos estandar (gml, wkb o wkt).

Es posible especificar temas de información añadida a visualizar en la imagen. Para establecer la visibilidad de los temas añadidos, se puede consultar antes las temas disponibles a través del la operación mapasdisponibles del servicio Dibujar Imagen.

Para conocer los codigos de las entidades a localizar, se puede utilizar las operaciones buscarcallejero del SOAP API de Consulta del Callejero y toponimo del SOAP API Buscar Toponimo.

7.1 Localización de entidades del Callejero

Dado un identificado de alguna de las entidades contempladas, devuelve atributos y opcionalmente un mapa en formato raster o vectorial.
Nombre de operación : localizaridcallejero

7.1.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
identificador String Codigo de la entidad a localizar
Ejemplos:
  • 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.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
imagen String si/no
escenario String Ejemplo : PUBLI
anchura String Anchura en pixeles de la imagen generada.
Ejemplo : 800
altura String Altura en pixeles de la imagen generada.
Ejemplo : 600
vector String GML, wkt, WKB
mapaselectarr WsmapasselectUser  
"WsmapasselectUser" es un tipo de dato de entrada con los siguientes parámetros:
Nombre Tipo Valores de ej.
Nombre String farmacias
estado String sí
Tipo String Clase, Grupo, Mapa

Ya que existe una jerarquéa de los temas que agrupa los temas en "Grupos" y los Grupos en "Clases", para activar un determinado tema habrá que activar también el grupo y clase a los que pertenece. Para saber que temas estan disponibles para un escenario dado, llamar a mapasdisponibles descrito en otro punto del documento.

7.1.2 Parámetros de Salida

Se obtiene información alfanumórica de la entidad que se localiza, una imagen y opcionalmente los ficheros gml, wkb o wkt.

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipocallejerosUser  
"TipocallejerosUser" es un tipo de datos con los siguientes parámetros:
Nombre Tipo Valores de ej.
listaDirecciones Array de DireccionPostalUser.  
listaActividades Array de ActividadUser.  

Ejemplo : E_51507

"DireccionPostalUser"es un tipo de datos con los siguientes parámetros:
Nombre Tipo Valores de ej.
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" es un tipo de datos con los parámetros :
Nombre Tipo Valores de ej.
tipoActividad String MONUMENTO
nombreActividad String Maria Cristina
ATipoActividad String F.1.1
a2NombreActividad String 23255
a1NombreActividad String 69241

Volver al índice

7.2 Localización de entidades del inventario de levantamientos cartográficos

Dado un identificador de levantamiento cartográfico, devuelve atributos y opcionalmente un mapa en formato raster. Nombre de la operación: localizaridcartofototeca

7.2.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
identificador String Codigo del levantamiento a localizar
Ejemplos : Q_002, Q_001_6429a1a.dwg
escala String
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
imagen String si/no
escenario String Ejemplo : PUBLI
anchura String Anchura en pixeles de la imagen generada.
Ejemplo : 800
altura String Altura en pixeles de la imagen generada.
Ejemplo : 600
vector String GML, WKT, WKB
mapaselectarr WsmapasselectUser  

7.2.2 Parámetros de Salida

Parámetros de Salida
Nombre Tipo Valores
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut CartoUser  
"CartoUser" es un tipo de dato con el siguiente parametros:
Nombre Tipo Valores
Cartofototeca TipocartofototecaUser  

Ejemplo : Q_002

"TipocartofototecaUser" es un tipo de datos con los siguientes parámetros:
Nombre Tipo Valores
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

Volver al índice

7.3 Localización de entidades de Ríos

Dado un identificador de cuenca o río, devuelve atributos y opcionalmente un mapa en formato raster y vector.
Nombre : localizaridrios

7.3.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
identificador String Codigo de la entidad a localizar
Ejemplos :
  • Cuenca: C_11
  • Río: I_16072
escala String Ejemplo: 5000 o vacia
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
imagen String si/no
escenario String Ejemplo : PUBLI
anchura String Anchura en pixeles de la imagen generada.
Ejemplo : 800
altura String Altura en pixeles de la imagen generada.
Ejemplo : 600
vector String GML, WKT, WKB
mapaselectarr WsmapasselectUser  

7.3.2 Parámetros de Salida

Se obtiene información alfanumórica (atributos) de la entidad que se localiza, una imagen y opcionalmente los ficheros gml, wkb o wkt.

Parámetros de Salida
Nombre Tipo Valores
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TiporioUser  
"TiporioUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
rio String UROLA
cuenca String rioUROLA
ARio String 12
ACuenca String 16072
wktVec base64Binary  
wkbVec String  
gmlVec String  

Ejemplo : I_16072

Volver al índice

7.4 Localización de Topónimos

Esta operación permite, dado un identificador de orografía o barrio, devolver atributos y opcionalmente un mapa en formato raster y vector.Nombre de operación: localizaridtoponimia

7.4.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
identificador String Codigo de la entidad a localizar
Ejemplos :
  • 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 Ejemplo: 5000 o vacia
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
imagen String si/no
escenario String Ejemplo : PUBLI
anchura String Anchura en pixeles de la imagen generada.
Ejemplo : 800
altura String Altura en pixeles de la imagen generada.
Ejemplo : 600
vector String GML, WKT, WKB
mapaselectarr WsmapasselectUser  

7.4.2 Parámetros de Salida

Parámetros de Salida
Nombre Tipo Valores
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipotopoUser  
"TipotopoUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
municipio String URNIETA
barrio (district) String  
orografia(orography) String MONTE ABALLARRI
AMunicipio String  
AOrografia String 24071
wktVec String  
wkbVec base64Binary  
gmlVec String  

Ejemplo : G_24071

Volver al índice

7.5 Localización de Viales

Dado un identificador de vial, de punto kilométrico, línea de transporte o parada (estas están sin actualizar), devuelve atributos y opcionalmente un mapa en formato raster y vector. Nombre: localizaridviales

7.5.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
identificador String Codigo de la entidad a localizar
Ejemplos :
  • 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 Ejemplo: 5000 o vacia
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
imagen String si/no
escenario String Ejemplo : PUBLI
anchura String Anchura en pixeles de la imagen generada.
Ejemplo : 800
altura String Altura en pixeles de la imagen generada.
Ejemplo : 600
vector String GML, WKT, WKB
mapaselectarr WsmapasselectUser  

7.5.2 Parámetros de Salida

Se obtiene información alfanumórica (atributos) de la entidad que se localiza, una imagen y opcionalmente los ficheros gml, wkb o wkt.

Parámetros de Salida
Nombre Tipo Valores
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipovialesUser  
"TipovialesUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
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  

Ejemplo : T_9044

"TipolineaUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
empresa String (RENFE)
tipo String LÍNEA DE TREN
sentido String IDA
ruta String IRUN-BRINKOLA
paradas Array de ParadaUser  
"TipoparadaUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
nombre String ELOSEGI ALKATEA,3 AURREAN (DONOSTIA)
paradas Array de TipolineasUser  

Ejemplo : RA_176

"TipolineasUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
empresa String HIJOS A. AREIZAGA
tipo String línea de autobus interurbano
sentido String IDA
ruta String A3-PASAI SAN PEDRO-DONOSTIA/SAN SEBASTIAN

Volver al índice

7.6 Localización de coordenadas XY

Dado un tipo de proyección y valores XY, devuelve valores en UTM30 y Lat-Long y opcionalmente un mapa en formato raster. Nombre : localizaridxy

7.6.1 Parámetros de Entrada

Parámetros de entrada
Nombre Tipo Valores
x String Coordenada
y String Coordenada
tipo String UTM, Lat-Long , Lat-Long-WGS84
escala String Ejemplo: 5000 o vacia
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
imagen String si/no
escenario String Ejemplo : PUBLI
anchura String Anchura en pixeles de la imagen generada.
Ejemplo : 800
altura String Altura en pixeles de la imagen generada.
Ejemplo : 600
mapaselectarr WsmapasselectUser  

7.6.2 Parámetros de Salida

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
imagenurlOut String http://b5m.gipuzkoa.net/internet/GenaImageSourcer
objectOut TipoxyUser  
"TipoxyUser" es un tipo de dato con el siguiente parámetros:
Nombre Tipo Valores de ej.
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

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

Volver al índice

7.7 Código de ejemplo

El siguiente ejemplo de C# (para Visual Studio 2005) muestra como llamar al SOAP API de LocalizarPorId Callejero, con los siguientes parámetros :

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

El servicio Web devuelve un registro en el DataSource de Actividades y otro en el DataSource de Direcciones.

Nota Para ver como se registra el servicio Web, ver el ejemplo del Callejero.

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. Servicio Web "Consultar"

El Servicio Web de Consultar devuelve información de los elementos de una determinada entidad que se encuentran en unas determinadas coordenadas geográficas. Tanto el nombre de la entidad que se consulta, como las coordenadas X e Y se pasan como parámetros de entrada.

8.1 Operación Consultar Coordenadas

En esta operación o función se devuelve información del punto cuyas coordenadas X e Y se pasan como argumento. Esta información incluye datos como la Longitud y Latitud, la Altura del punto, etc. Nombre de la operación: consultarcoorcoordenadas

8.1.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
tema String COORDENADAS
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
coorX String X en ED50 UTM30N Ejem. 581082
coorY String Y en ED50 UTM30N Ejem. 4793752

8.1.2 Parámetros de Salida.

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
objectOut TipocoordenadaUser  
"TipocoordenadaUser" es un tipo de dato con el siguiente parámetros:
Nombre Tipo Valores de ej.
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:
Nombre Tipo Valores de ej.
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" es un tipo de dato con el siguiente parámetros:
Nombre Tipo Valores de ej.
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 Operación Consultar Toponimia.

8.2 Operación Consultar Toponimia.

En esta operación o función del servicio de consulta, se obtiene información de la comarca, municipio, barrio y orografia del punto geográfico cuyas coordenadas x e y se pasan como parámetros de entrada. Nombre de la operación : consultarcoortoponimia

8.2.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
tema String TOPONIMIA
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
coorX String X en ED50 UTM30N Ejem. 583269
coorY String Y en ED50 UTM30N Ejem. 4797499

8.2.2 Parámetros de Salida.

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
objectOut TipotoponimiaUser  
"TipotoponimiaUser" es un tipo de dato con el siguiente parámetros:
Nombre Tipo Valores de ej.
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 Operación Consultar Viales

En esta función se obtiene un nombre o nombres de calles, carreteras o vías de tren dado un punto geográfico cuyas coordinas X e Y se pasan como parámetros de entrada. Nombre de la operación: consultarcoorvial

8.3.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
tema String VIAL
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
coorX String X en ED50 UTM30N Ejem. 583515
coorY String Y en ED50 UTM30N Ejem. 4795662

8.3.2 Parámetros de Salida.

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
objectOut TipovialUse  
"TipovialUse" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
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 Operación Consultar Callejero.

Es una función que devuelve información del callejero a partir de un punto geográfico determinado cuyas coordenadas X e Y se pasan como parámetros de entrada. Nombre de la operación : consultarcoorcallejero

8.4.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
tema String MUNICIPIO, EDIFICIO, CALLE
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
coorX String X en ED50 UTM30N Ejem. 582583
coorY String Y en ED50 UTM30N Ejem. 4797168

8.4.2 Parámetros de Salida

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
objectOut TipocallejeroUser  
"TipocallejeroUser" es un tipo de dato con el siguiente parámetros:
Nombre Tipo Valores de ej.
listaDirecciones Array de DirPostalUser.  
listaActividades Array de ActividadUser Usado cuando el tema=EDIFICIO
"DirPostalUser" es un tipo de dato con el siguiente parámetro:
Nombre Tipo Valores de ej.
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

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

"ActividadUser" es un tipo de dato con los siguientes parámetros:
Nombre Tipo Valores de ej.
nombreActividad(activity name) String MONUMENTO(MONUMENT)
nombreActividad(activity name) String Maria Cristina
ATipoActividad String F.1.1
a2NombreActividad String 23255
a1NombreActividad String 69241

Volver al índice

8.5 Operación consultar Ríos

En esta función se obtienen nombres de ríos en un punto geográfico dado cuyas coordenadas XY se pasan como parámetros de entrada. Nombre : consultarcoorrio

8.5.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
tema String RIO
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
coorX String X en ED50 UTM30N Ejem. 582868
coorY String Y en ED50 UTM30N Ejem. 4797335

8.5.2 Parámetros de Salida.

Parámetros de Salida
Nombre Tipo Valores de ej.
return String  
objectOut TiporioUser  
"TiporioUser" es un tipo de dato con el siguiente parámetros:
Nombre Tipo Valores de ej.
rio   rio URUMEA
cuenca   URUMEA
ARio   16436
ACuenca   13

Volver al índice

8.6 Operación Consultar CartoFototeca.

En esta función se obtienen nombres de ríos en un punto geográfico dado cuyas coordenadas XY se pasan como parámetros de entrada. Nombre : consultarcoorrio

8.6.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
tema String CARTOGRAFIA, CINCOMILES, FOTOSAEREAS
lengua String
  • 0.Castellano
  • 1.Euskera
  • 2.Inglés
  • 3.Francés
coorX String X en ED50 UTM30N Ejem. 581082
coorY String Y en ED50 UTM30N Ejem. 4793752

8.6.2 Parámetros de Salida.

Parámetros de Salida
Nombre Tipo Valores de ej.
fotosAereas Array de TipofotosareaUser. tema= FOTOSAEREAS
_CINCOMILES_26 Array de TipocincomilUser tema=CINCOMILES
cartografia Array de TipocartofototecaUser tema=CARTOGRAFIA
"TipofotosareaUser" es un tipo de dato con los siguientes parámetros
Nombre Tipo Valores de ej.
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

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

"TipocincomilUser" es un tipo de dato con los siguientes parámetros
Nombre Tipo Valores de ej.
fecha String 1983
enlace String http://b5m.gipuzkoa.net...

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

"TipocartofototecaUser" es un tipo de dato con los siguientes parámetros
Nombre Tipo Valores de ej.
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

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

Volver al índice

8.7 Código de ejemplo.

El siguiente ejemplo de C# (para Visual Studio 2005) muestra como llamar al SOAP API de Consultar-Rios, con los siguientes parámetros:

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

Nota Para ver como se registra el servicio Web, ver el ejemplo del Callejero.

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. Calcular Ruta.

9.1 Operación Consultar Coordenadas de un ruta.

Dado un XY de comienzo y un xy final, devuelve la ruta por carretera entre los dos puntos. Opcionalmente, se puede especificar un punto intermedio. Nombre : calcularruta

9.1.1 Parámetros de Entrada.

Parámetros de entrada
Nombre Tipo Valores
ix0 String Coordenada X de origen Ejem. 550497
iy0 String Coordenada Y de origen Ejem. 4790307
ix1 String Coordenada X de un punto intermedio
iy1 String Coordenada Y de un punto intermedio
ixd String Coordenada X de destino Ejem. 549665
iyd String Coordenada Y de destino Ejem. 4789587

9.1.2 Parámetros de Salida.

La función devuelve un XML codificado en un String con los valores XY de las líneas y vértices de la ruta.
Ejemplo.

  • <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 Código de ejemplo.

El siguiente ejemplo de C# (para Visual Studio 2005) muestra como llamar al SOAP API de Consultar Rios, con los siguientes parámetros :

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

El servicio Web devuelve un XML en un String que se puede leer en C# con el XmlTextReader.

Nota Para ver como se registra el servicio Web, ver el ejemplo del Callejero.

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

Logotipo de la diputación Foral de Gipuzkoa y enlace a la página principal.
  | Gipuzkoa.net   | Departamento de Medio Ambiente y Ordenación del Territorio     © 1997-2012