Hasta próxima revisión

Transcripción

1 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 1 de 85 Título Servicios web de CartoCiudad v 4.7 Identificador Autor Fecha Tema Estado Objetivo Descripción Contribuciones Fuente Difusión Idioma Documentos relacionados Período de validez ServicioswebCartoCiudadv4_7.doc Alicia González, José Miguel Rubio, Ana Velasco, Julián González, Patricia Trigo, Paloma Verdejo, Gloria Andrés Servicios web con interfaces estándar Definitivo Descripción de servicios web de CartoCiudad Definición de los servicios web estándar de CartoCiudad que se han implementado en el contexto del proyecto, así como proporcionar parámetros y peticiones de ejemplo para su uso eficiente. No aplicable Pública Español (SPA) Hasta próxima revisión

2 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 2 de 85 Versiones: Número de Fecha Autor/modificado Comentarios versión por José Miguel Rubio Primera versión José Miguel Rubio Modificación de las peticiones de ejemplo José Miguel Rubio Inclusión de una descripción más amplia del WMS-C. Inclusión de parámetros y peticiones para procesos WFS, WPS. Inclusión de descripción del servicio de geocodificación inversa José Miguel Rubio, Alicia González Actualización de contenidos de la introducción. Inclusión de nuevas capas en el WMS. Modificación de la sección de WFS y WPS. Inclusión de GML de respuesta a las peticiones de ejemplo. Inclusión de las referencias adecuadas en cada servicio al cliente web de CartoCiudad. Inclusión de los términos de uso de los servicios web José Miguel Rubio Cambio de nombre en algunas capas del WMS. Modificación de ejemplos. Inclusión de peticiones al WMS versión Inclusión de las novedades implementadas en los WFS. Actualización de imágenes José Miguel Rubio Inclusión de consultas por parámetro FeatureID Patricia Trigo Descripción del nuevo servicio de WMTS y modificaciones sobre el WMS-C Patricia Trigo Descripción del nuevo servicio de WMS-INSPIRE Julián González, Ana Velasco Modificación de los sistemas de referencia disponibles en los servicios WFS y Servicios

3 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 3 de Patricia Trigo REST. Inclusión del parámetro GeocodeAddress en los servicios REST y uso del cálculo masivo de direcciones en apartado de Cálculos Patricia Trigo Descripción WFS inspire de direcciones. Descripción para incluir cuadro de búsqueda en página web y Api móvil Patricia Trigo Nueva Versión WPS 1.0.0, servicios REST y descripción utilidades nuevo visor.

4 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 4 de 85 Índice 1 Introducción Qué servicios web publica CartoCiudad? Servicios de Mapas WMS de CartoCiudad WMS de CartoCiudad según INSPIRE Servicio de Mapas Cacheado y/o Teselado WMS-C, Servicio de Mapas Cacheado WMTS servicio de Mapas Teselado Servicios de Fenómenos WFS de Código Postal WFS de Vial WFS de Portales y Puntos kilométricos WFS de Distrito Censal WFS de Sección Censal WFS Inspire WFS Inspire de direcciones WFS Inspire de transportes Servicio de Geoprocesamiento WPS Cálculo de rutas o camino mínimo entre direcciones postales Cálculo de áreas de proximidad Calculo de puntos de interés en un área de proximidad Geocodificación inversa de direcciones postales Geocodificación directa mediante texto libre Geocodificación directa mediante texto dirigido Servicios REST de Cálculos Servicio REST bajo el aplicativo CartoGeocoder : Geocodificación de dirección a partir de texto libre (Geocode): Geocodificación dirigida (GeocodeAddress) Servicio REST bajo el aplicativo services : Geocodificación inversa (reversegeocode): Cálculo de distancias y/o rutas (route) Cálculo de áreas de influencia (servicearea) API visualizador API móvil Política de uso de los servicios web de CartoCiudad... 85

5 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 5 de 85 1 Introducción En conformidad con el Real Decreto 1545/2007, de 23 de noviembre, por el que se regula el Sistema Cartográfico Nacional, el proyecto CartoCiudad se define como un servicio de información geográfica que debe estar incluido en la Infraestructura Nacional de Información Geográfica. Asimismo, la información contenida en el mismo se clasifica, de acuerdo con el artículo 27 del citado Real Decreto, como Información Geográfica de Referencia. Como el resto de los nodos y portales integrados en la Infraestructura Nacional de Información Geográfica, CartoCiudad es accesible tanto a través del Portal Nacional IDEE (Infraestructura de Datos Espaciales de España, como del Portal IDEAGE (Infraestructura de Datos Espaciales de la Administración General del Estado, Para que esto sea posible, es necesario que se cumplan los requerimientos técnicos que permitan la interoperabilidad del servicio con la Infraestructura Nacional de Información Geográfica. Además, en conformidad con el artículo 30 del Real Decreto, el acceso debe realizarse a través de Internet o cualquier otro servicio de telecomunicaciones, siendo público para el ciudadano. Por todo lo anterior, el diseño de CartoCiudad responde al objetivo de explotación a través de Internet empleando diferentes servicios web estándar. Los servicios están implementados siguiendo las especificaciones OGC (Open Geospatial Consortium) que permiten la visualización y consulta de la información así como distintos procesamientos. Éstos admiten, además, su encadenamiento con otros servicios y aplicaciones y su explotación a través de otros geoportales IDE, mashups y herramientas SIG. Los servicios web facilitan el acceso a los datos y mejoran su aprovechamiento con distintas aplicaciones, pudiendo realizarse la combinación con otras capas de información de distinta procedencia, obteniendo, de este modo, nuevos productos y servicios de valor añadido. Con ello, se pretende contribuir al cumplimiento de la Directiva 2/2007/EC para el establecimiento de una Infraestructura de Datos Espaciales en Europa (INSPIRE), que promueve la máxima difusión de datos geográficos y el desarrollo de servicios interoperables

6 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 6 de 85 para su explotación a través de Internet y, del mismo modo, cumplir con su transposición al marco legislativo español, la Ley 14/2010, de 5 de julio, sobre las Infraestructuras y los Servicios de Información Geográfica en España (LISIGE). El geoportal de CartoCiudad en abierto al público desde 2008, da acceso fácil y sencillo a la información del proyecto (información relativa a los datos) y a los distintos servicios web que CartoCiudad. Consta de una zona de contenidos que da acceso a cálculos de geoprocesamiento (geocodificación directa e inversa y distancias), enlaza con el Centro de Descargas del CNIG y ofrece toda la documentación sobre el proyecto, así como los medios para contactar con el equipo del proyecto para realizar consultas o sugerencias. Área de contenidos del Geoportal CartoCiudad Y de un visualizador que muestra el servicio de visualización de mapas y permite búsqueda de direcciones, códigos postales y cálculo de rutas. El visualizador de CartoCiudad está

7 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 7 de 85 desarrollado con software libre OpenLayers 3 y basado en jquery UI, en concreto Widget Factory. Incluye también componentes de búsqueda y de cálculo de rutas que se apoyan sobre los servicios CartoCiudad y que se explicarán más adelante. A través de su componente de búsqueda se pueden localizar códigos postales, calles, portales, municipios, núcleos de población y otros topónimos, y realizar cálculo de rutas. Entre las funcionalidades cabe destacar la posibilidad de añadir capas procedentes de servicios de mapas (WMS) así como la medición de áreas y distancias. Visualizador de CartoCiudad El proyecto también promueve la utilización de sus datos mediante una aplicación web JavaScript libre y gratuita, CartoVisor, que puede ser añadido fácilmente a cualquier página HTML para permitir la visualización de la cartografía y la utilización de los servicios de CartoCiudad, constituyendo un marco ideal para la referenciación de puntos de interés de cualquier organización sobre una base cartográfica fiable. CartoVisor incluye además la posibilidad de personalizar sus funciones y ampliar la información mostrada en el mismo. Toda la información acerca de este API, publicada en 2009, está disponible en En un futuro próximo esta aplicación será sustituida por el nuevo visualizador que permitirá exactamente las mismas funcionalidades que el CartoVisor, pero que todavía están en desarrollo.

8 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 8 de 85 Página de documentación de la API de CartoCiudad - CartoVisor Este documento describe en detalle los servicios web de CartoCiudad, las especificaciones a las que son conformes, sus características y sus funcionalidades, además contiene ejemplos de peticiones y cómo invocarlos a través del cliente web de CartoCiudad.

9 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 9 de 85 2 Qué servicios web publica CartoCiudad? Los servicios web ofrecidos por CartoCiudad son los siguientes: Servicio de Mapas Servicio de Mapas INSPIRE Servicio de Mapas Teselado Servicios de Fenómenos Servicios de Geoprocesamiento: o Cálculo de rutas o Cálculo de áreas de proximidad o Cálculo de puntos de interés en áreas de proximidad o Geocodificación inversa Servicios REST de cálculos: o Geocodificación directa o Geocodificación inversa o Cálculo de distancias 2.1 Servicios de Mapas WMS de CartoCiudad Los servicios de mapas (Web Map Service WMS) permiten la generación mapas de forma dinámica a partir de información geográfica vectorial o ráster. Se invocan a través de un navegador web o cliente, enviando una petición en forma de URL (Uniform Resource Locator) y devolviendo a continuación una imagen digital al cliente. El WMS CartoCiudad cumple con las especificaciones de OGC WMS versión y versión 1.3.0, así como la Norma ISO 19128:2005 Geographic Information - Web Map Service Interface. Está implementado sobre GeoServer 2.2 alojado en un servidor de aplicaciones Tomcat 6.0.

10 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 10 de 85 Además, el WMS de CartoCiudad soporta la especificación SLD (Styled Layer Descriptor) versión 1.0 de OGC, con lo cual es posible aplicar un estilo de usuario a una determinada capa del WMS. Los grupos de capas, junto con las capas de fenómenos que los componen, del WMS de CartoCiudad son los siguientes: o FondoUrbano: Contiene las siguientes entidades: o Núcleos urbanos (NUC_POB_AREA). o Núcleos urbanos de menor entidad con geometría puntual (NUC_POB_Puntual). o Manzanas urbanas (MANZANA_PUBLI). o Parcelas urbanas, sólo en País Vasco y Navarra (PARCELA_PUBLI). o Edificaciones (sólo País Vasco y Navarra), zonas verdes, deportivas e hidrografía urbana (CONSTRUCCION_PUBLI). o Líneas de fondo urbano como aceras, escaleras, elementos hidrográficos, líneas de ferrocarril, perímetros de puente y túnel (LINEA_AUXILIAR_PUBLI). o Vial: contiene los viales tanto urbanos como interurbanos (TRAMO_VIAL_PUBLI). o Portal: comprende tanto los portales como los puntos kilométricos (PORTAL_PK_PUBLI). o Toponimo: contiene la capa de topónimos (TOPONIMO_PUBLI). o CodigoPostal: comprende la capa de códigos postales (CODIGO_POSTAL_PUBLI). o SeccionCensal: contiene las siguientes capas: o Secciones censales (SECCION_CENSAL_PUBLI). o Distritos censales (DISTRITO_CENSAL_PUBLI). El sistema de referencia nativo de los datos es ETRS89 en coordenadas geográficas, es decir, con código EPSG Asimismo, admite los siguientes sistemas de referencia: En coordenadas geográficas: o o EPSG:4230 (ED50). EPSG:4326 (WGS84).

11 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 11 de 85 En coordenadas UTM: o EPSG:25828 (ETRS89, zona 28N). o EPSG:25829 (ETRS89, zona 29N). o EPSG:25830 (ETRS89, zona 30N). o EPSG:25831 (ETRS89, zona 31N). o EPSG:23028 (ED50, zona 28N). o EPSG:23029 (ED50, zona 29N). o EPSG:23030 (ED50, zona 30N). o EPSG:23031 (ED50, zona 31N). o EPSG:32628 (REGCAN, zona 28N). o EPSG:32627 (REGCAN, zona 27N). Otros sistemas de referencia: o EPSG: (Proyección Google Mercator). o GoogleMapsCompatible EPSG:3857 Los principales formatos de imagen que puede devolver el WMS son (en tipos MIME): Image/png Image/jpg Image/gif Image/tiff El WMS de CartoCiudad también trabaja con kml, pdf, atom o svg. El WMS de CartoCiudad permite las siguientes operaciones: GetMap: Posibilita las operaciones de visualización devolviendo una imagen del mapa cuyos parámetros geoespaciales y dimensionales se han definido en la petición. La solicitud para la operación GetMap se codifica como una URL enviada al WMS usando una petición HTTP GET. A continuación se muestra un ejemplo de petición GetMap solicitando la visualización de las capas FondoUrbano, Vial, Portal, Toponimo, SeccionCensal y CodigoPostal, en ETRS89, coordenadas latitud y longitud:

12 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 12 de 85 El resultado de la petición es la siguiente imagen PNG: Respuesta del WMS de CartoCiudad a la petición GetMap de ejemplo La siguiente petición es un ejemplo de petición GetMap, en la versión de la especificación WMS, solicitando la visualización de las capas FondoUrbano, Vial, Portal y Toponimo, en ETRS89, coordenadas latitud y longitud: Urbano,Vial,Portal,Toponimo,SeccionCensal,CodigoPostal&FORMAT=image%2Fp ng&transparent=true&service=wms&version=1.1.1&request=getmap&s TYLES=&SRS=EPSG%3A4258&BBOX= , , , &WIDTH=1247&HEIGHT=901 Urbano,Vial,Portal,Toponimo&VERSION=1.3.0&FORMAT=image/png&TRANSPAR ENT=true&QUERYABLE=true&SERVICE=WMS&REQUEST=GetMap&STYLES=&EXC EPTIONS=application/vnd.ogc.se_inimage&CRS=EPSG:4258&BBOX= , , , &WIDTH=800&HEIGHT=400

13 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 13 de 85 A continuación se muestra el resultado de la petición anterior, una imagen PNG de las capas incluidas en la petición: Respuesta del WMS de CartoCiudad a la petición GetMap de ejemplo GetCapabilities: devuelve los metadatos del servicio, una descripción del contenido de información del WMS y de los parámetros de petición admisibles. La petición correspondiente en la versión es: &REQUEST=GetCapabilities La petición correspondiente al servicio WMS en versión es: &REQUEST=GetCapabilities&VERSION=1.1.1 GetFeatureInfo: devuelve información sobre entidades particulares mostradas en el mapa. Son consultables las siguientes capas del servicio: o o o o CodigoPostal SeccionCensal Vial FondoUrbano La respuesta del WMS de CartoCiudad ante esta petición puede ser un fichero HTML (por defecto) o bien XML y devuelve todos los atributos de la capa

14 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 14 de 85 obtenidos en ese punto. A modo de ejemplo, una consulta sobre la división territorial en un punto dado en ETRS89, coordenadas UTM huso 30, sería: FeatureInfo&VERSION=1.3.0&SERVICE=WMS&QUERY_LAYERS=CodigoPostal,Sec cioncensal&feature_count=100&x=521&y=426&srs=epsg:25830&bbox= , , , &WIDTH=1000&HEIGH T=833&LAYERS=SeccionCensal,CodigoPostal&STYLES=&INFO_FORMAT=text/htm l La respuesta del WMS de CartoCiudad ante esta petición es el siguiente documento HTML: GetLegendGraphic: devuelve información sobre los estilos de un tipo de entidad mostrado en el mapa, que están descritos de acuerdo con la especificación SLD. Para ello, es necesario consultar la capa del fenómeno en cuestión, no el grupo de capas, con una petición como la que aparece a continuación: egendgraphic&version=1.1.1&format=image/png&width=20&height=20& LAYER=LINEA_AUXILIAR_PUBLI El resultado a esta petición es una imagen PNG de la leyenda de la capa LINEA_AUXILIAR_PUBLI:

15 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 15 de 85 Los estilos asociados por defecto a cada capa son los siguientes (se indica el nombre de cada capa y estilo): Grupo de capa y Capa CartoCiudad FondoUrbano NUC_POB_AREA NUC_POB_Puntual MANZANA_PUBLI PARCELA_PUBLI CONSTRUCCION_PUBLI LINEA_AUXILIAR_PUBLI Portal PORTAL_PK_PUBLI Vial TRAMO_VIAL_PUBLI Toponimo TOPONIMO_PUBLI CodigoPostal CODIGO_POSTAL_PUBLI SeccionCensal DISTRITO_CENSAL_PUBLI SECCION_CENSAL_PUBLI Estilo por defecto nucleos_poligonos nucleos_puntual manzanas parcela construcciones lineas_auxiliares portal_pk vial toponimo codigo_postal distrito_censal seccion_censal DescribeLayer: Esta petición, opcional en un WMS, permite obtener información de la capa o capas de cara a su simbolización por parte del usuario. Un ejemplo de petición, para dos capas, podría ser el siguiente: cribelayer&version=1.1.1&layers=codigo_postal_publi,seccion_censal _PUBLI Dado que es un servicio web estándar, es posible invocarlo desde visualizadores IDE o sistemas SIG que admitan este tipo de servicios, como por ejemplo ArcGIS

16 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 16 de 85 o gvsig, Google Earth (utilizando la pasarela de CartoCiudad en el mashup de goolzoom ( o en el visualizador de la Infraestructura de Datos Espaciales de España (IDEE), El WMS de CartoCiudad en el visualizador de mapas de la GoolZoom WMS de CartoCiudad según INSPIRE Este servicio de visualización de mapas es conforme con la Guía Técnica de Servicios de Visualización INSPIRE y conforme al perfil INSPIRE de ISO19128-WMS Este servicio permite el acceso a todos los datos de CartoCiudad en capas conforme a las especificaciones de datos de Direcciones y de Redes de Transporte (Anexo I de INSPIRE). Además, los estilos asociados a las capas son los indicados por defecto en la sección Portrayal de las citas especificaciones. Se invoca también a través de un navegador web o cliente, enviando una petición en forma de URL (Uniform Resource Locator) y devolviendo a continuación una imagen digital al cliente.

17 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 17 de 85 El servicio WMS-INSPIRE está implementado sobre GeoServer 2.2 alojado en un servidor de aplicaciones Tomcat 6.0. Soporta la especificación SLD (Styled Layer Descriptor) versión 1.0 de OGC, con lo cual es posible aplicar un estilo de usuario a una determinada capa del WMS. Las capas publicadas son: - AD.Address: En esta capa se publican los portales y puntos kilométricos que hay en CartoCiudad según la Especificación de Direcciones. - TN.RoadTransportNetwork.RoadLink: En esta capa se publican los tramos que hay en CartoCiudad según la Especificación de Redes de Transporte. Estilos: Por defecto cada capa tiene asociado el estilo (escrito en SLD) que la Especificación de Datos correspondiente publica en su sección Portrayal. Capa AD.Address TN.RoadTransportNetwork.RoadLink Estilo INSPIRE por defecto AD.Address.Default TN.RoadTransportNetwork.RoadLink.Default Los principales formatos de imagen que puede devolver el WMS son (en tipos MIME): Image/png, Image/jpg, Image/gif, Image/tiff. El servicio WMS INSPIRE también trabaja con kml, pdf, atom o svg. El servicio WMS-INSPIRE permite las siguientes operaciones: GetMap: Permite la visualización devolviendo una imagen del mapa cuyos parámetros geoespaciales y dimensionales se han definido en la petición. A continuación se muestra un ejemplo de petición GetMap solicitando la visualización de las capas AD.Address y TN.RoadTransportNetwork.RoadLink, en ETRS89, coordenadas latitud y longitud: Link&FORMAT=image%2Fpng&TRANSPARENT=true&SERVICE=WMS&VERSION= 1.1.1&REQUEST=GetMap&STYLES=&SRS=EPSG%3A4326&BBOX=-

18 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 18 de , &WIDTH=1148&HEIGHT=599 Bajo estas líneas se muestra el resultado de la petición anterior, una imagen PNG de las capas incluidas en la petición: Respuesta del WMS-Inspire de CartoCiudad a la petición GetMap de ejemplo , ,- NOTA: Al hacer una petición GetMap en la versión de WMS habrá que invertir la latitud y longitud, tal y como describe la norma. GetCapabilities: devuelve los metadatos del servicio, una descripción del contenido de información del WMS y de los parámetros de petición admisibles. La petición correspondiente en la versión es: s Si queremos obtener el fichero de capabilities en inglés la petición sería la siguiente: s&language=eng La petición correspondiente al servicio WMS-INSPIRE en versión es:

19 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 19 de 85 inspire/cartociudad/cartociudad?service=wms&request=getcapabilitie s&language=eng&version=1.1.1 GetFeatureInfo: devuelve información sobre entidades particulares mostradas en el mapa. Son consultables las siguientes capas del servicio: o AD.Address o TN.RoadTransportNetwork.RoadLink La respuesta del WMS de CartoCiudad ante esta petición puede ser un fichero HTML (por defecto) o bien XML y devuelve todos los atributos de la capa obtenidos en ese cuadro. A modo de ejemplo, una consulta sobre AD.Address sería: application%2fvnd.ogc.se_xml&bbox= %2c %2c %2C &SERVICE=WMS&INFO_FORMAT=text%2Fhtml&QUERY _LAYERS=AD.Address&FEATURE_COUNT=50&Layers=AD.Address&WIDTH=512& HEIGHT=362&format=image%2Fpng&styles=&srs=EPSG%3A4258&version=1.1.1 &x=273&y=321 La respuesta del WMS de CartoCiudad ante esta petición es el siguiente documento HTML con los identificadores inspire de los portales que se encuentran en el Bounding Box seleccionado:

20 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 20 de 85 GetLegendGraphic: devuelve información sobre los estilos de un tipo de entidad mostrado en el mapa, que están descritos de acuerdo con la especificación SLD. Para ello, es necesario consultar la capa del fenómeno en cuestión, no el grupo de capas, con una petición como la que aparece a continuación: &FORMAT=image/png&WIDTH=20&HEIGHT=20&LAYER=TN.RoadTransport Network.RoadLink 2.2 Servicio de Mapas Cacheado y/o Teselado WMS-C, Servicio de Mapas Cacheado Los tiempos de respuesta del visualizador de CartoCiudad se disminuyen gracias a la utilización de la extensión GeoWebCache de GeoServer, ya que permite la generación de un WMS cacheado (WMS-C) o teselado (WMTS) a partir de un WMS. El servicio WMS-C almacena las teselas generadas por el WMS en su primera petición de manera que, en lo sucesivo, devuelve las teselas almacenadas evitando así el procesamiento que el WMS debe llevar a cabo para generar la imagen de nuevo. El servicio de Mapas Cacheado propio de CartoCiudad se ha suprimido por haberse integrado las capas del proyecto en el servicio WMS-C del IGN_Base. El WMS-Caché de IGN_Base con CartoCiudad, es conforme con el perfil de OSGeo sobre WMS (WMS-C). La capa que hay que invocar para obtener CartoCiudad es: o IGNBaseTodo: comprende todas las capas del WMS de IGNBase a escalas pequeñas (hasta escala 1:68.000) y combina IGN_Base y CartoCiudad (FondoUrbano, Vial y Portal) a escalas grandes (desde 1: hasta 1:1.000). La URL del servicio para obtener las capacidades es: Los parámetros para realizar una petición al WMS-C son los mismos que los correspondientes a las peticiones GetMap a un WMS, pero es necesario indicar las resoluciones correspondientes a los niveles de caché.

21 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 21 de WMTS servicio de Mapas Teselado. Es el servicio WMTS de CartoCiudad también ha sido eliminado en favor del de IGN_Base, que cumple con la especificación OGC WMTS versión Este servicio ofrece la posibilidad de consultar las capas de información guardadas en teselas. Complementa así a los servicios WMS existentes proporcionando una mayor velocidad de visualización mediante la utilización de estas teselas de imagen generadas previamente. La URL del servicio de Mapas Teselado de IGN_Base es Fichero de capacidades: Como ejemplo, a continuación se muestra una petición GetTile al servicio WMTS, que devuelve una tesela de la capa Todas: rsion=1.0.0&format=image%2fjpeg&tilematrix=14&tilecol=16047&tilerow=4528 La imagen de respuesta que devuelve el WMTS es la siguiente tesela que corresponde al nivel de resolución 14 TileMatrix=14, columna TILECOL=16047 y fila 4528 TILEROW=4528. Hay que tener en cuenta que para dar la posición de la tesela, el origen según OGC está en la esquina superior izquierda de la imagen. Para más detalles ver la especificación del servicio (

22 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 22 de Servicios de Fenómenos Los servicios de fenómenos de CartoCiudad están desarrollados de acuerdo con la Especificación OGC de WFS (Web Feature Service). En general, un servicio WFS permite recuperar y modificar (consultar, insertar, actualizar y eliminar) datos espaciales en formato vectorial codificados en Geography Markup Language GML. En el caso de los WFS de CartoCiudad, el usuario puede consultar los datos existentes en la base de datos del proyecto así como la descarga en formato GML de la geometría de los fenómenos de CartoCiudad, salvo las secciones y los distritos censales. La versión de la Especificación OGC de WFS empleada en CartoCiudad es la Para su implementación se ha utilizado Deegree 2.4, que se ha desplegado sobre un servidor de aplicaciones Apache Tomcat 7.0. Los servicios de fenómenos de CartoCiudad se pueden considerar servicios de nomenclátor puesto que se han adaptado para el cumplimiento del Modelo de Nomenclátor de España (MNE) cuya versión actual 1.2 define un servicio de nomenclátor como aquél ( ) que devuelve una o más entidades en respuesta a una consulta solicitada a través de la red. Esta consulta debe soportar la selección de atributos de las entidades, incluyendo el tipo, el nombre, el identificador de la entidad entre otros. El Servicio de Nomenclátor constituye uno de los tres servicios mínimos que debe proporcionar una Infraestructura de Datos Espaciales, según la recomendación de la Comisión de Geomática del Consejo Superior Geográfico ( ). El sistema de referencia empleado en este servicio es el ETRS89 en coordenadas geográficas, con código EPSG:4258. Asimismo, admite la consulta y descarga de fenómenos en los siguientes sistemas de referencia: En coordenadas geográficas: o EPSG:4326 (WGS84) En coordenadas UTM: o EPSG:25828 (ETRS89, zona 28N) o EPSG:25829 (ETRS89, zona 29N) o EPSG:25830 (ETRS89, zona 30N)

23 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 23 de 85 o EPSG:25831 (ETRS89, zona 31N) o EPSG:32627 (WGS84, zona 27N) o EPSG:32628 (WGS84, zona 28N) o EPSG:32629 (WGS84, zona 29N) o EPSG:32630 (WGS84, zona 30N) o EPSG:32631 (WGS84, zona 31N) En Pseudo-Mercator: o EPSG:3857 (WGS84) o GoogleMapsCompatible La clase de conformidad que cumplen los WFS de CartoCiudad es la básica, esto es, soportan las siguientes peticiones: GetCapabilities: Ofrece información acerca de las características del servicio, de los tipos de fenómeno que ofrece y qué operaciones soporta cada uno de ellos. DescribeFeatureType: Ofrece la estructura (campos y atributos) de los tipos de fenómeno que el servicio ofrece, mediante su descripción en esquemas XML, siendo éstos esquemas GML válidos. GetFeature: Devuelve instancias de fenómenos o entidades (objetos individuales) en formato GML 3.1.1, sus características y su localización (mínimo rectángulo envolvente, centroide y geometría). Para restringir la búsqueda de fenómenos de acuerdo con algún criterio, deben emplearse condiciones o filtros en conformidad con la Especificación FE (Filter Encoding) de OGC. Los servicios de fenómenos de CartoCiudad permiten realizar consultas y localizaciones geográficas de direcciones postales tanto urbanas (calle y número de portal) como interurbanas (carretera y punto kilométrico), de códigos postales, de distritos y secciones censales. Además, salvo en el caso de los distritos y secciones censales, es posible acceder y descargar la geometría de los tipos de fenómeno citados. Es importante destacar que, como resultado, y si procede, el WFS sólo proporcionará los primeros diez fenómenos encontrados en la Base de Datos que cumplan con las condiciones de la consulta realizada mediante la operación GetFeature. No obstante, utilizando convenientemente las palabras claves STARTPOSITION y MAXFEATURES en la petición es posible obtener el resto de fenómenos que cumplen con las condiciones fijadas en la petición.

24 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 24 de 85 Mediante peticiones GetFeature también es posible realizar consultas por el identificador único de cada instancia de fenómeno, empleando el parámetro FEATUREID. En estas consultas, al identificador único será necesario añadir un prefijo que se indicará convenientemente en cada uno de los apartados siguientes. Siguiendo el esquema del Modelo de Nomenclátor de España se han creado un total de 8 servicios de fenómenos, uno por cada tipo de fenómeno de CartoCiudad. De acuerdo con las características de los distintos fenómenos, que se obtienen con la operación DescribeFeatureType y que se desarrollan en el esquema XML correspondiente, para localizar cada fenómeno es posible filtrar o consultar por una o varias de las propiedades o parámetros de consulta que se indican para cada uno de los WFS implementados. Para cada WFS, su interacción con el cliente se particulariza en los apartados siguientes. Se pueden consultar códigos postales, de distritos y secciones censales y por último y más importante direcciones WFS de Código Postal El WFS de códigos postales devuelve las características, geometría y localización de un código postal. La URL del fichero Capabilities es: Las características de los fenómenos (PropertyName) que se ofrecen a través de este WFS son las siguientes: nombreentidad/nombre: el número de código postal. entidadlocal/municipio: el nombre del municipio o municipios en el que se encuentra el código postal. entidadlocal/provincia: el nombre de la provincia en la que se encuentra el código postal.

25 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 25 de 85 fid: identificador único en la base de datos de CartoCiudad (los cinco primeros dígitos se corresponden con el código INE del municipio en el que se encuentra). geom: coordenadas de los puntos del límite del código postal. posicionespacial/bbox: mínimo rectángulo envolvente del código postal. posicionespacial/centroide: centroide del código postal. Es posible, por lo tanto, utilizar alguno de estos parámetros en una petición GetFeature para filtrar los resultados obtenidos, de acuerdo con la Especificación OGC Filter Encoding. Ejemplo: Si se quiere obtener mediante una petición GetFeature las características y localización de aquellos códigos postales que comiencen por 190 en la provincia de Guadalajara la sintaxis podría ser: xmlns(app= And><PropertyIsLike%20wildCard="*"%20singleChar="_"%20escapeChar="!"><Proper tyname>nombreentidad/nombre</propertyname><literal>190*</literal></propertyi slike><propertyisequalto><propertyname>entidadlocal/provincia</propertyname>< Literal>Guadalajara</Literal></PropertyIsEqualTo></And></Filter> A continuación se muestra un extracto de la respuesta GML (una colección de 6 fenómenos Código Postal) del WFS a esta petición:

26 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 26 de 85 Para realizar consultas de códigos postales por FEATUREID en este WFS, se debe utilizar el valor del atributo fid precedido del prefijo CCPP_. Un ejemplo de petición de este tipo sería: CPP_ La petición DescribeFeatureType de la entidad sería: MESPACE=xmlns(app= Desde el visualizador puede efectuarse también una búsqueda de Código Postal se accede a la información introduciendo directamente el código postal y el polígono con el Código correspondiente se marca: Búsqueda a través del widget de búsqueda del visor de CartoCiudad

27 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 27 de WFS de Vial Este servicio proporciona las características, geometría y localización de los tramos de un vial de la Base de Datos de CartoCiudad. Las características de los fenómenos (PropertyName) que se ofrecen a través de este WFS son las siguientes: nombreentidad/nombre: el nombre de la vía entidadlocal/municipio: el nombre del municipio en el que se encuentra la vía. entidadlocal/provincia: el nombre de la provincia en la que se encuentra la vía. tipoentidad/tipo: el tipo de vía por la cual se está preguntando. fid: identificador único en la base de datos de CartoCiudad (para vías urbanas los cinco primeros dígitos se corresponden con el código INE del municipio en el que se encuentra). geom: geometría de los tramos que componen el vial posicionespacial/bbox: mínimo rectángulo envolvente de los tramos de un vial. Es posible, por lo tanto, utilizar alguno de estos parámetros en una petición GetFeature para filtrar los resultados obtenidos, de acuerdo con la Especificación OGC Filter Encoding. Ejemplo: para obtener las características, geometría y localización de un vial llamado Alonso Castrillo en la localidad de Madrid se podría enviar la siguiente petición GetFeature: ns(app= ><PropertyIsLike%20wildCard="*"%20singleChar="_"%20escapeChar="!"><PropertyN ame>nombreentidad/nombre</propertyname><literal>*alonso CASTRILLO*</Literal></PropertyIsLike><PropertyIsEqualTo><PropertyName>entidadL ocal/municipio</propertyname><literal>madrid</literal></propertyisequalto></and ></Filter>

28 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 28 de 85 El resultado GML de la consulta contempla tanto el nombre de la entidad y sus atributos de acuerdo con el MNE, su tipo, su geometría y el mínimo rectángulo envolvente en el sistema de referencia correspondiente así como la localidad y la provincia en la que se encuentra. La petición GetCapabilities correspondiente es: Para realizar consultas de viales por FEATUREID en este WFS, se debe utilizar el valor del atributo fid precedido del prefijo VIAL_. Un ejemplo de petición de este tipo sería: _ La petición DescribeFeatureType de la entidad sería: PACE=xmlns(app=

29 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 29 de 85 Desde el visualizador de CartoCiudad se puede también hacer la búsqueda de un vial a través del widget de búsqueda, introduciendo el nombre del vial y seguido de una coma el municipio en el que se encuentra. Búsqueda de vial a través del widget del visualizador de CartoCiudad WFS de Portales y Puntos kilométricos El WFS de portales y puntos kilométricos permite localizar un portal o un punto kilométrico en una vía determinada, es decir, una dirección postal urbana o interurbana. Las características de los fenómenos (PropertyName) que se ofrecen a través de este WFS son las siguientes: nombreentidad/nombre: se corresponde con el número y letra de portal. entidadrelacionada/descripcionrelacion: se indica el nombre de la vía a la que pertenece.

30 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 30 de 85 entidadrelacionada/identidad: se debe indicar el identificador de la vía conrrespondiente, que se puede extraer de una consulta al WFS-vial (se corresponde con la propiedad fid de la entidad vial) entidadlocal/municipio: municipio al que pertenece el portal. entidadlocal/provincia: provincia en la que se encuentra la entidad buscada. posicionespacial/bbox: Bounding Box coordenadas del portal. posicionespacial/centroide: centroide del portal coordenadas del portal. fid: identificador único en la base de datos de CartoCiudad (los cinco primeros dígitos se corresponden con el código INE del municipio en el que se encuentra). Es posible, por lo tanto, utilizar alguno de estos parámetros en una petición GetFeature para filtrar los resultados obtenidos, de acuerdo con la Especificación OGC Filter Encoding. Ejemplo: Es posible obtener mediante una petición GetFeature las características y localización del portal número 3 que se encuentra en la calle Alonso Castrillo en la localidad de Madrid: mlns(app= nd><propertyisequalto><propertyname>nombreentidad/nombre</propertyname><l iteral>3</literal></propertyisequalto><propertyislike%20wildcard="*"%20singlechar ="_"%20escapeChar="!"><PropertyName>entidadRelacionada/descripcionRelacion</P ropertyname><literal>*alonso CASTRILLO*</Literal></PropertyIsLike><PropertyIsEqualTo><PropertyName>entidadL ocal/municipio</propertyname><literal>madrid</literal></propertyisequalto></and ></Filter> En otra consulta al WFS de portal se podría indicar el vial utilizando su identificador, extraído de una consulta previa al WFS de vial:

31 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 31 de 85 mlns(app= nd><propertyisequalto><propertyname>nombreentidad/nombre</propertyname><l iteral>3</literal></propertyisequalto><propertyislike%20wildcard="*"%20singlechar ="_"%20escapeChar="!"><PropertyName>entidadRelacionada/idEntidad</PropertyNa me><literal> </literal></propertyislike><propertyisequalto><property Name>entidadLocal/municipio</PropertyName><Literal>Madrid</Literal></PropertyIs EqualTo></And></Filter> Este tipo de consulta es posible gracias a que se ha definido como entidad relacionada la entidad vial, la cual mantiene una relación de tipo jerárquica padre respecto a la entidad portal. La respuesta GML obtenida en este caso es la misma que la anterior, esto es, las coordenadas del portal en el sistema de referencia de los datos, así como la relación existente con el vial en el que se encuentra, el municipio y la provincia.

32 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 32 de 85 La petición GetCapabilities correspondiente es: Además, es posible hacer una consulta al WFS-Portal realizando una petición al fenómeno entidadlocal_ que permite, a partir de un vial determinado, conocer el municipio en el que se encuentra gracias a la propiedad ine_mun: mlns(app= ter%20xmlns:app=" e>app:id_vial</propertyname><literal> </literal></propertyisequalto> </Filter> Para realizar consultas de portales o puntos kilométricos por FEATUREID en este WFS se debe utilizar el valor del atributo fid precedido del prefijo PPK_. Un ejemplo de petición de este tipo sería: K_ La petición DescribeFeatureType de la entidad sería: ESPACE=xmlns(app=

33 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 33 de WFS de Distrito Censal El WFS de distrito censales permite obtener la localización y las características de un distrito censal indicando el municipio al que pertenece y, opcionalmente, la provincia. Las características de los fenómenos (PropertyName) que se ofrecen a través de este WFS son las siguientes: nombreentidad/nombre: el número de distrito censal entidadlocal/municipio: municipio donde se sitúa el distrito censal entidadlocal/provincia: provincia donde se sitúa el distrito censal fid: identificador único del distrito censal en la base de datos de CartoCiudad (los cinco primeros dígitos se corresponden con el código INE del municipio en el que se encuentra). posicionespacial/bbox: mínimo rectángulo envolvente del distrito censal. posicionespacial/centroide: centroide del distrito censal. Es posible, por lo tanto, utilizar alguno de estos parámetros en una petición GetFeature para filtrar los resultados obtenidos, de acuerdo con la Especificación OGC Filter Encoding. Ejemplo: Petición GetFeature del distrito censal número 2 del municipio de Alcalá de Henares: xmlns(app= And><PropertyIsEqualTo><PropertyName>nombreEntidad/nombre</PropertyName>< Literal>2</Literal></PropertyIsEqualTo><PropertyIsEqualTo><PropertyName>entidadL ocal/municipio</propertyname><literal>alcalá Henares</Literal></PropertyIsEqualTo></And></Filter> de

34 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 34 de 85 La petición GetCapabilities correspondiente es: Para realizar consultas de distritos censales por FEATUREID en este WFS se debe utilizar el valor del atributo fid precedido del prefijo DDCC_. Un ejemplo de petición de este tipo sería: DCC_ La petición DescribeFeatureType de la entidad de Distrito Censal sería: MESPACE=xmlns(app=

35 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 35 de WFS de Sección Censal Este servicio WFS de Sección Censal permite obtener las características y localización de una sección censal dado un distrito censal y un municipio determinados. Las características de los fenómenos (PropertyName) que se ofrecen a través de este WFS son las siguientes: nombreentidad/nombre: el número de sección censal atributoentidad/valoratributo: el número de distrito censal entidadlocal/municipio: municipio donde se sitúa la sección censal entidadlocal/provincia: provincia donde se sitúa la sección censal fid: identificador único de la sección censal en la base de datos de CartoCiudad (los cinco primeros dígitos se corresponden con el código INE del municipio en el que se encuentra). posicionespacial/bbox: mínimo rectángulo envolvente de la sección censal. posicionespacial/centroide: centroide de la sección censal. Es posible, por lo tanto, utilizar alguno de estos parámetros en una petición GetFeature para filtrar los resultados obtenidos, de acuerdo con la Especificación OGC Filter Encoding. Ejemplo: petición GetFeature de la sección censal 2 correspondiente al distrito censal 1 de Madrid: =xmlns(app= <And><PropertyIsEqualTo><PropertyName>nombreEntidad/nombre</PropertyName> <Literal>2</Literal></PropertyIsEqualTo><PropertyIsEqualTo><PropertyName>entidad Local/municipio</PropertyName><Literal>Madrid</Literal></PropertyIsEqualTo><Pro pertyisequalto><propertyname>atributoentidad_valoratributo</propertyname><lite ral>1</literal></propertyisequalto></and></filter>

36 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 36 de 85 La petición GetCapabilities correspondiente es: Para realizar consultas de secciones censales por FEATUREID en este WFS se debe utilizar el valor del atributo fid precedido del prefijo SSCC_. Un ejemplo de petición de este tipo sería: CC_ La petición DescribeFeatureType de la entidad de Sección Censal sería: MESPACE=xmlns(app=

37 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 37 de WFS Inspire El servicio es conforme a la especificación OGC WFS y la guía técnica de servicios de descarga de INSPIRE (versión 3.1). Este servicio se ha implementado sobre servidores con sistema operativo Linux, con Tomcat7 y sobre la aplicación Deegree WFS Inspire de direcciones Es el servicio Web de Fenómenos de CartoCiudad que permite el acceso, la consulta y localización de direcciones, nombres de unidades administrativas, codigos postales y nombres de viales de España, generados en el marco del proyecto CartoCiudad. Los fenómenos se sirven conforme a la especificación de datos sobre direcciones de INSPIRE (versión 3.0.1). En este servicio se pueden consultar los siguientes tipos de fenómenos: - Address (direcciones) - ThoroughfareName (nombres de calles o viales) - PostalDescriptor (códigos postales) - AdminUnitName (nombres de unidades administrativas) Es posible, por lo tanto, utilizar alguno de estos parámetros en una petición GetFeature para filtrar los resultados obtenidos, de acuerdo con la Especificación OGC Filter Encoding. Ejemplo: petición GetFeature para que me liste tres municipios aleatoriamente: =ad:adminunitname&count=3

38 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 38 de 85 En la imagen anterior se puede ver la respuesta en formato GML a la petición del ejemplo. Nos da el nombre del municipio Alcalá de los Gazules. Se puede observar que como se han pedido 3 entidades, hay 3 wfs:member en la respuesta. Para obtener la provincia a la que pertenece, habría que ejecutar la petición que se encuentra en ad:situatedwithin: ORMAT=application%2Fgml%2Bxml%3B+version%3D3.2&STOREDQUERY_ID=urn:ogc: def:query:ogc- WFS::GetFeatureById&ID=AD_ADMINUNITNAME_PRO_ #AD_ADMINUN ITNAME_PRO_ Cuya respuesta sería:

39 ServiciosWebCartoCiudadv4_7.doc Servicios web de CartoCiudad Página 39 de WFS Inspire de transportes Es el servicio Web de Fenómenos de la red de transportes por carreterera del proyecto CartoCiudad. Los fenómenos se sirven conforme a la especificación de datos sobre Redes de transportes del anexo I de la Directiva Inspire(versión 3.0.1). La URL correspondiente al fichero de capacidades es: Para facilitar el uso del servicio se han creado una serie de consultas almacenadas (stored queries), de manera que el usuario solo tenga que indicar los valores de los parámetros de cada consulta en vez de un filtro según la especificación Filter Encoding 2.0 de OGC. Para obtener la lista de consultas almacenadas: Y para obtener la descripción de las mismas: En este servicio se pueden consultar las siguientes entidades geográficas: - tn-ro:roadlink, tn-ro:eroad, tn-ro:road - tn:markerpost - tn:accessrestriction - tn:conditionoffacility - tn:verticalposition - tn-ro:roadname - tn-ro:formofway - tn-ro:functionalroadclass - net:network