Visor geográfico API SITNA v 1.5

Manual de usuario

Julio 2018

Manual de usuario API SITNA Página 1 de 33

Índice de contenidos

1 INTRODUCCIÓN........................................................................................31.1 Objetivo del documento.................................................................................................3

1.2 Características de la API SITNA....................................................................................3

2 VISOR GEOGRÁFICO DE LA API SITNA.......................................................42.1 Cambio del sistema de referencia de coordenadas....................................................5

2.2 Pestaña herramientas....................................................................................................6

2.2.1 Buscador.....................................................................................................................................................6

2.2.2 Mapas de fondo........................................................................................................................................11

2.2.3 Capas de trabajo......................................................................................................................................13

2.2.4 Información sobre los objetos geográficos...............................................................................................17

2.2.5 Medir.........................................................................................................................................................21

2.3 Pestaña leyenda...........................................................................................................22

2.4 Pestaña mapa situación...............................................................................................23

2.5 Control Street View.......................................................................................................25

2.6 Carga de ficheros geográficos propios......................................................................25

2.7 layerCatalog y workLayerManager.............................................................................27

3 IFRAME KML BASADO EN API SITNA......................................................30

Manual de usuario API SITNA Página 2 de 33

1 INTRODUCCIÓN

1.1 Objetivo del documentoEste documento pretende orientar a los usuarios del Visor geográfico de la API SITNA sobre lasfuncionalidades disponibles y cómo usar el Visor.

En http://sitna.navarra.es/api/doc/ está la documentación de la API SITNA dirigida adesarrolladores, pero en ella se pueden ver distintos ejemplos del Visor.

Este manual explica las funcionalidades del Visor utilizando los siguientes ejemplos:

El mapa básico que se obtiene del ejemplo 1 de la clase SITNA.Map.

El mapa con información geográfica del ejemplo 3 de la clase SITNA.Map.

El mapa con la información de un fichero KML del ejemplo 2 de addLayer de la claseSITNA.Map.

1.2 Características de la API SITNALa API SITNA permite, a los técnicos de desarrollo, incluir un visor de mapas interactivos enpáginas y aplicaciones web.

Por defecto, la API SITNA ofrece un visor básico que incluye distintos mapas de fondo deIDENA así como funcionalidades habituales de navegación (zoom, mapa de situación,medición, búsquedas, etc.).

Además, está disponible un iframe para cargar ficheros KML basado en la API SITNA. En estecaso, es posible incluir una cabecera en el visor con el logo de navarra.es y un título. Másinformación en el Apartado 3 – Iframe KML basado en API SITNA .

Notas:

Los textos del visor de mapas están en castellano, no hay soporte multiidioma.

El visor cuenta con diseño adaptativo y por ejemplo el formato de los botones de menúscambia automáticamente en función del tamaño de la ventana.

El funcionamiento y aspecto del visor puede variar en función del navegador que se usa.No funciona en versiones de IE inferiores a la 11, por lo que se recomienda usar unaversión más actualizada o bien otro navegador como Firefox o Chrome.

Manual de usuario API SITNA Página 3 de 33

2 VISOR GEOGRÁFICO DE LA API SITNAEl ejemplo 1 de la clase SITNA.Map carga el Visor de la API SITNA con el mapa básico pordefecto a pantalla completa:

El Visor presenta 8 áreas con distintas funcionalidades:

1. Información del Sistema de referencia espacial del mapa y las coordenadas delpunto en que está situado el cursor. Por defecto EPSG:25830 (ETRS89 y coordenadasUTM). También se incluye la barra de escala.

2. Barra de zoom para acercar y/o alejar el mapa (con el botón + o – de la barra,moviendo el indicador por la barra o bien con la rueda del ratón) y botón de inicio quevuelve al mapa en su extensión inicial.

3. Pestaña herramientas con las funciones de búsqueda, medición y con las capas deinformación geográfica disponibles en el mapa.

4. Pestaña leyenda que presenta la simbología de las capas de trabajo que se visualizanen el mapa.

5. Atribución del mapa, es decir, procedencia de la información geográfica.

6. Pestaña mapa de situación que muestra la ubicación del área geográfica actual delvisor. Moviendo el cuadro rojo sobre el mapa de situación se cambia el área geográficaque se muestra.

7. Control Street View, arrastrando el icono a un punto del mapa, abre una ventana deGoogle Street View.

8. Espacio para visualización del mapa; el resto de áreas se superponen a ésta.

Manual de usuario API SITNA Página 4 de 33

Las pestañas de herramientas, leyenda y mapa de situación se despliegan y/o recogen alpulsar sobre ellas.

2.1 Cambio del sistema de referencia de coordenadasSi pinchamos sobre el cuadro que indica el sistema de referencia de coordenadas en el quenos encontramos:

Aparecerá un cuadro de diálogo en el centro de la pantalla que indicará el sistema dereferencia actual y si tiene o no diferentes sistemas de referencia de coordenadas compatiblesa los que reproyectar. El usuario tiene dos opciones a la hora de cambiar el sistema dereferencia de coordenadas, pudiendo seleccionar entre la opción sistemas de referenciacompatibles u otros ofrecidos dentro de la opción Mostrar sistemas proyectados al vuelo (máslentos)...

Seleccionando cualquiera de ellos el mapa se reproyectará al sistema requerido.

Tanto el número de sistemas de referencia de coordenadas compatibles como los sistemasproyectados al vuelo disponibles dependen del mapa de fondo y/o servicios WMS, si hubiese,visualizados en ese momento.

Manual de usuario API SITNA Página 5 de 33

2.2 Pestaña herramientasLa pestaña herramientas incluye las funciones de búsqueda, medición y selección de losmapas de fondo y las capas de trabajo.

2.2.1 BuscadorEsta herramienta está compuesta por una caja de texto y un icono de una lupa. Permiterealizar búsquedas alfanuméricas y localizar espacialmente los resultados. Las opciones debúsqueda disponibles son:

Nomenclátor (municipios y cascos urbanos)

Direcciones (vías y portales).

Referencias catastrales.

Coordenadas en geográficas (notación decimal) y coordenadas en proyeccióncartesiana UTM (x,y).

Las dos primeras opciones utilizan los nombres oficiales, en castellano o euskera.

Funciona al introducir, como mínimo, tres caracteres en la caja de texto libre. A continuaciónaparecerá un listado con todos los resultados que contengan esos caracteres.

Los resultados aparecen organizados en grupos identificados por un color como se aprecia enla imagen anterior.

Al hacer clic sobre el resultado deseado, este se centrará espacialmente en el mapa y laresaltará.

En caso de que la búsqueda devuelva un solo resultado, se puede hacer clic en el texto o en elicono de la lupa.

Para hacer una nueva búsqueda dejar en blanco la caja de texto libre.

Cuando no existan resultados en la búsqueda aparecerá un: ‘No se han encontrado resultados’.

Manual de usuario API SITNA Página 6 de 33

1.1.1.1 Nomenclátor (municipios y cascos urbanos)

Para realizar la búsqueda por nomenclátor, introducir en la caja de texto el nombre de laentidad de población buscada.

Se ofrece la posibilidad de centrar el municipio o el casco urbano

Hacer clic sobre el resultado de la búsqueda deseado y el mapa centrará sobre la entidadseleccionada.

Municipio:

Casco urbano:

Manual de usuario API SITNA Página 7 de 33

1.1.1.2 Direcciones (vías y portales)

Para realizar una búsqueda de una vía, introducir en la caja de texto el nombre de la víaseguido de una coma y el nombre de la entidad de población o al revés.

Hacer clic en el resultado de la búsqueda y el mapa se centrará sobre la vía deseadaresaltando su eje en color rojo y con el nombre rotulado.

Para realizar una búsqueda de un portal, introducir en la caja de texto el nombre de la

Manual de usuario API SITNA Página 8 de 33

entidad de población seguido de una coma, el nombre de la vía seguido de una coma yel número de portal.

Al hacer clic en el resultado deseado, el mapa se centrará sobre dicho portal, queaparecerá rotulado.

Manual de usuario API SITNA Página 9 de 33

1.1.1.3 Referencia catastral

Para realizar una búsqueda de una referencia catastral conocida, hay que introducir en la cajade texto el nombre del municipio (o su código INE) seguido de una coma, el número delpolígono catastral seguido de una coma, y el número de la parcela.

El color del borde de lo resaltado identifica el tipo de parcela (urbana en azul, rústica en verde,mixta en rojo).

1.1.1.4 Coordenadas

Para realizar una búsqueda por coordenadas el buscador ofrece dos opciones:

Por coordenadas cartesianas UTM: introduciendo la coordenada ‘X’ seguida de unacoma, e introduciendo la coordenada ‘Y’ de la ubicación.

Por coordenadas geográficas en notación decimal: introduciendo la latitud seguida deuna coma, e introduciendo la longitud de la ubicación.

Manual de usuario API SITNA Página 10 de 33

Al hacer clic en el resultado de la búsqueda, el mapa centrará la ubicación.

2.2.2 Mapas de fondoUn mapa de fondo es la imagen que se muestra como base en el mapa y que sirve de soportepara la localización de la información referida al territorio.

El visor básico ofrece por defecto cuatro mapas de fondo procedentes de IDENA:

Mapa base: proporciona una base cartográfica con contenidos diversos como límitesadministrativos, toponimia, hidrografía, infraestructuras, direcciones y equipamientos deNavarra a múltiples escalas. Se ofrece cacheado.

Ortofoto de máxima actualidad: corresponde con la última ortofotografía de Navarra(Plan Nacional de Ortofotografía Aérea). A fecha de la redacción de este documento, setrata del vuelo digital realizado en 2017, la resolución es de 0,25 metros/píxel, el vuelofue realizado en los meses de junio, julio y agosto de 2017, el rango de altura del vueloestá entre los 2000-4000 metros. Se está ofreciendo la ortofoto cacheada y sólo estádisponible en EPSG:25830.

Cartografía topográfica: proporciona una infraestructura básica de datos cartográficosde Navarra a múltiples escalas.

Catastro: proporciona la información catastral de Navarra.

Nota: el Servicio de Catálogo de IDENA permite consultar las características de estas capas deinformación geográfica (http://idena.navarra.es/catalogo/gn/srv/spa/search#fast=index&from=1&to=50).

Al pinchar en esta opción se despliegan los distintos mapas de fondo disponibles en el Visor yestá marcado en rojo el mapa que se está visualizando. Pinchando sobre la imagencorrespondiente se cambia el mapa de fondo.

Manual de usuario API SITNA Página 11 de 33

Al cambiar el mapa de fondo se muestra la misma zona geográfica que se visualizaba.

Por ejemplo, la zona de la Plaza de Toros con la ortofoto:

Se cambia el mapa de fondo al catastro:

Manual de usuario API SITNA Página 12 de 33

Nota:

Con la API SITNA el desarrollador puede incluir o eliminar mapas de fondo, en cualquier caso,siempre aparecen dentro del menú “mapas de fondo”. En el siguiente ejemplo, se ha añadidola ortofoto del PNOA como otro mapa de fondo.

:

2.2.3 Capas de trabajoNormalmente, en un mapa hay una imagen de fondo sobre la que se superpone informacióngeográfica diversa y que en este visor está incluida en el menú “capas de trabajo”.

Estas capas de información geográfica pueden proceder de servicios WMS, de ficheros KML obien corresponden con marcadores puntuales.

Al pinchar esta opción del menú herramientas, se despliega la tabla de contenidos (TOC) conlas distintas capas de información geográfica que se visualizan sobre el mapa de fondo.

La Tabla de Contenidos presenta una estructura de árbol y se pueden desplegar/recoger losdistintos niveles. Además, se pueden activar/desactivar las capas a visualizar.

Cuando hay capas de trabajo, en la pestaña leyenda se muestra la simbología correspondientea las capas que se están visualizando. La leyenda es dinámica, de manera que sólo semuestran los símbolos de las capas activas y en la escala de visualización correspondiente.

Manual de usuario API SITNA Página 13 de 33

Ejemplo 3 de SITNA.Map

El siguiente ejemplo muestra un mapa básico con las capas de Toponimia y mallascartográficas procedentes del Servicio de Mapas (WMS) de IDENA:

La TOC es un árbol con ramas que se pueden desplegar con el botón + y recoger con –

Se pueden activar/desactivar las capas a visualizar, bien a nivel individual o bien a nivel degrupo. Por ejemplo, se desactiva la capa de Hojas del Mapa Topográfico a escala 1/25000 y elresultado es:

Manual de usuario API SITNA Página 14 de 33

Nota: en un mapa puede haber capas no visibles a todos los niveles de zoom. Las capas queno sean visibles al nivel de zoom actual aparecerán en gris claro en la TOC.

Por ejemplo al hacer zoom, para visualizar la zona de la Ciudadela de Pamplona, se observaque se han activado determinadas capas de información porque ha cambiado la escala y estáen el rango de visualización de dichas capas.

La leyenda es dinámica, es decir, muestra sólo la simbología de las capas que se estánvisualizando en ese momento. A la izquierda se muestra la leyenda del mapa inicial y a laderecha la leyenda del mapa visualizando la ciudadela.

Manual de usuario API SITNA Página 15 de 33

Ejemplo 2 de SITNA.Map.addLayer

El siguiente ejemplo muestra un mapa básico con la información de un fichero KML cargadocon la API SITNA.

En este caso, se ha incluido en la Tabla de Contenidos la capa “Museos en Navarra” y un nivelinferior llamado “Datos” que corresponde con el <name> de la carpeta <Folder> del ficheroKML En la leyenda se muestra el nombre de la capa, de la carpeta y el icono asignado a estegrupo.

Nota: se incluirán tantas carpetas como <Folder> tenga el fichero KML

Al pinchar sobre un icono se muestra el globo con la información asociada a dicho punto. Sequita el globo pinchando en cualquier otro lugar del mapa.

Manual de usuario API SITNA Página 16 de 33

Nota: al pinchar en un dato que sea un enlace, se mostrará la información en la mismaventana, en ventana nueva o en página nueva (dependerá de la configuración del navegadorque se use). Si se pulsa <CTRL> a la vez que el enlace siempre se abre una pestaña nuevacon la información correspondiente al enlace.

2.2.4 Información sobre los objetos geográficosSi la capa (o capas) que hemos cargado es (son) de tipo WMS, podemos visualizar lainformación asociada al objeto geográfico haciendo click sobre él, al igual que en una capaKML, pero además, podemos descargar el objeto que hayamos seleccionado.

Lo vemos con el ejemplo de SITNA.Cfg.MapControlOptions.featureinfo.

Manual de usuario API SITNA Página 17 de 33

Al hacer click sobre un punto, nos muestra información de todos los objetos que hay en esepunto:

Pinchando sobre el borde de la ventana y arrastrando, podemos desplazar la ventana parafacilitar la visualización de los objetos geográficos y su información asociada:

Manual de usuario API SITNA Página 18 de 33

Al pasar el cursor por encima de los datos, resalta el objeto correspondiente:

Y, si hacemos click sobre los datos, centra el objeto geográfico correspondiente:

Manual de usuario API SITNA Página 19 de 33

El icono , que cambia a cuando se sitúa el cursor sobre él, nos abre la posibilidad dedescargar o compartir el objeto seleccionado:

2.2.4.1 Descargar

Esta funcionalidad permite obtener un archivo con el objeto geográfico concreto en variosformatos:

GML (Geography Markup Language), un archivo XML (texto con estructura y etiquetas)que contiene coordenadas geográficas. Admite multi-geometrías.

GeoJSON (Geographic JavaScript Object Notation), estándar abierto diseñado pararepresentar elementos geográficos sencillos, junto con sus atributos no espaciales. Esampliamente utilizado en aplicaciones de cartografía en entornos web al permitir elintercambio de datos de manera rápida, ligera y sencilla.

KML (Keyhole Markup Language) es un lenguaje de marcado basado en XML pararepresentar datos geográficos en tres dimensiones. Incorporado al OGC por Google.

WKT (Well Known Text o de texto conocido) es una codificación o sintaxis en formatotexto estandarizado diseñada para describir objetos espaciales expresados de formavectorial con todo tipo de geometrías y en varias dimensiones. No incluye informaciónde los atributos alfanuméricos asociados.

2.2.4.2 Compartir

Permite obtener una URL de enlace a la vista actual o el código QR equivalente o el códigoHTML para incrustar el visualizador en un iFRAME en páginas de terceros (incluidas las capascargadas del proyecto, como ya se podía hacer desde la función compartir del panel principalde “herramientas”), ahora además destacando el elemento geográfico seleccionado. Lasopciones son:

Enviar el enlace por correo electrónico.

Obtener el código QR.

Compartir el enlace por Facebook.

Compartir el enlace por Twitter.

Guardar la dirección en “marcadores” del navegador Web (Control + D en Firefox o

Manual de usuario API SITNA Página 20 de 33

Chrome).

También es posible almacenar la dirección https o el código HTML del iFRAME en elPortapapeles con el botón “Copiar”.

Quienes reciban este enlace, encontrarán en “capas de trabajo” del panel principal deherramientas, un nuevo elemento “Entidad geográfica de interés”, que puede ser manipuladocomo el resto de información.

2.2.5 MedirAl pinchar sobre este apartado se muestran las opciones para medir tanto longitud como áreasy perímetros. Al pulsar sobre una de estas opciones se muestra un submenú con las acciones arealizar mientras se mide y el cursor se presenta con un círculo rojo que indica que ya se puedeempezar a medir pinchando sobre el mapa.

Las acciones posibles para medir son:

El cursor se convierte en un círculo rojo y se mide pinchando sobre el mapa en losdistintos puntos. En el cuadro inferior se muestra el resultado de la medición.

Deshace el último punto pinchado en la medición.

Rehace el último punto eliminado en la medición.

Aceptar la medición realizada (con doble clic sobre el punto también se confirma lamedición).

Cancela la medición realizada y se recoge el menú de acciones.

Por ejemplo, para medir el diámetro de la Plaza de Toros de Pamplona se elige “Longitud”, sepincha en el extremo origen (1) y doble clic en el extremo final (2). Se muestra la distancia en elcuadro longitud.

Para medir el área y el perímetro de la Plaza de Toros de Pamplona se elige “Área y perímetro”

Manual de usuario API SITNA Página 21 de 33

y se va pinchando alrededor del coso. Se muestra el resultado en el cuadro conforme se vahaciendo la medición.

Nota: el menú de medición se puede desplegar y recoger pulsando sobre “medición”, pero nose quita la acción de medir elegida. Para quitarla hay que pulsar el botón de cancelar lamedición o bien al confirmar una medición.

2.3 Pestaña leyendaLa pestaña leyenda incluye la simbología correspondiente a las capas de trabajo que se estánvisualizando en este momento.

Como ya se ha indicado en los ejemplos de menú “capas de trabajo” la leyenda es dinámica yvaría en función de las capas que se visualizan.

Por ejemplo, al cargar el fichero KML de Recursos turísticos de Open Data se presentan en latabla de contenidos los distintos tipos de recursos y en la leyenda el icono correspondiente acada tipo.

Manual de usuario API SITNA Página 22 de 33

.

Se eliminan en la tabla de contenidos los recursos de tipo Establecimiento hotelero,Restaurantes y Casa Rural y el resultado en la leyenda es:

2.4 Pestaña mapa situaciónLa pestaña “mapa situación” muestra en un rectángulo rojo la ubicación de la zona que se estávisualizando actualmente en el mapa.

Por ejemplo, cuando el mapa muestra todo Navarra, el rectángulo rojo del mapa de situaciónengloba toda la extensión de Navarra.

Cuando en el mapa se visualiza una zona concreta, el rectángulo rojo muestra sobre el mapabase la ubicación de lo que se está viendo. Por ejemplo, el mapa muestra el municipio dePamplona y en el mapa de situación el rectángulo está posicionado en esa zona.

Manual de usuario API SITNA Página 23 de 33

Conforme se cambia el área geográfica que se visualiza también cambia el mapa de situación.

Se puede mover el rectángulo rojo en el mapa de situación y así cambiar el área que sevisualiza. Para ello se pone el cursor dentro del rectángulo (que se muestra como una cruz) ycon el botón izquierdo del ratón pulsado se mueve el rectángulo a la zona que se quiere ver.

Manual de usuario API SITNA Página 24 de 33

2.5 Control Street ViewArrastrando el icono a un punto del mapa, abre una ventana de Google Street View.

Esta ventana se cierra pulsando la cruz de la esquina superior derecha.

Sólo funciona en carreteras por las que haya pasado el coche de Google, en caso contrario nosmostrará el siguiente mensaje:

2.6 Carga de ficheros geográficos propiosTambién es posible habilitar el arrastrar y soltar archivos al área del mapa, además de abrirlosde la manera convencional abriendo el cuadro de diálogo de búsqueda de archivos. Losformatos admitidos son:

• KML

• GML

• GeoJSON

• TopoJSON

• WKT

Manual de usuario API SITNA Página 25 de 33

Lo vemos con el ejemplo de cfg.DataLoaderOptions.html

Si tenemos, por ejemplo, un KML con datos propios, lo arrastramos sobre el visor:

Se cargará como una capa más:

Manual de usuario API SITNA Página 26 de 33

2.7 layerCatalog y workLayerManagerEn lugar del control Capas de trabajo, se pueden utilizar dos controles más sofisticados:

layerCatalog: Control de administración de capas de WMS. Sus funcionalidades son:

• Consultar las capas disponibles en uno o varios WMS.

• Buscar capas mediante texto libre. Se busca el texto en los títulos y los resúmenesdescriptivos de cada capa, que se publican en el documento de capacidades delservicio.

• Añadir al mapa capas como capas de trabajo.

workLayerManager: Control de administración de capas de trabajo. Con él se dispone de lassiguientes funcionalidades:

• Consultar qué capas están cargadas en el mapa.

Manual de usuario API SITNA Página 27 de 33

• Ver en qué orden están superpuestas y modificar ese orden.

• Comprobar si una capa es visible al nivel de zoom actual.

• Activar y desactivar la visibilidad de las capas.

• Establecer el grado de transparencia de cada capa.

• Borrar capas cargadas.

• Consultar metadatos asociados a la capa.

Manual de usuario API SITNA Página 28 de 33

Lo vemos con el ejemplo de cfg.MapControlOptions.layerCatalog_workLayerManager.html

Manual de usuario API SITNA Página 29 de 33

3 IFRAME KML BASADO EN API SITNAEl “iframe KML” es una implementación de un visor de KMLs basado en el API SITNA

Cada visor GIS interpreta y visualiza los KML de forma distinta y el iframe KML presenta lassiguientes características:

Sólo se puede cargar un fichero KML al mismo tiempo.

Si el <Point> no tiene un icono concreto en el estilo, no se pintan esos puntos porque eliframe no asigna icono por defecto.

No se muestra el nombre sobre cada punto. Al pinchar en un punto, el globo muestratodos los datos incluidos en ExtendedData del fichero KML.

Si el nº de puntos del KML es muy alto puede que tarde mucho o incluso que no secargue.

Si el KML carga información gráfica mediante servicios WMS, el iframe no lo interpreta.

En la pestaña “herramientas”, opción “capas de trabajo” se incluye una capa con elnombre del Fichero KML cargado y una carpeta por cada categoría, cada <Folder>.

Puede utilizarse de distintas formas:

Indicando directamente la URL del iframe (bien en el navegador o bien enlazandodesde otra web), en este caso se carga el visor en pantalla completa.

En una etiqueta <IFRAME> de una página web, en cuyo caso se debe indicar eltamaño de dicho IFRAME.

La URL para cargar el iframe con un fichero KML es:

http://sitna.navarra.es/kml/?url=url del fichero kml&title=titulo

Que tiene dos parámetros:

url: obligatorio y corresponde con la URL donde está ubicado el fichero KML a cargar(siempre tiene que estar en un servidor web, no puede cargarse un fichero KML localcon el iframe).

title: opcional y es el texto a incluir en la cabecera del visor. En este caso el visor secarga con cabecera y los menús desplegados (preferiblemente cuando se presenta apantalla completa). Si se omite el título, el visor se carga en modo incrustable, es decirsin cabecera y recogidos los menús (recomendado cuando se carga incrustado en otrapágina).

Nota: el título sólo se mostrará cuando se llame al iframe desde páginas del dominio“navarra.es”. Si se indica título y se llama desde otros dominios se muestra sólocabecera con el logo de navarra.es.

Hay que tener en cuenta que, si la URL de ubicación del fichero KML también tieneparámetros, para que se interpreten bien hay que codificar todos los caracteresespeciales de la dirección (/,=,espacio, :, etc.) en codificación URL. El parámetro titlesiempre deberá pasarse en codificación URL.

En la página http://www.w3schools.com/tags/ref_urlencode.asp hay una tabla de relación decaracteres ASCII - codificación URL y también ofrece un conversor del texto introducido. Latabla siguiente muestra algunos caracteres especiales:

Carácter ASCII Codificación URL Carácter ASCII Codificación URL

Blanco %20 ? %3F

/ %2F % %25

: %3A & %26

= %3D

Manual de usuario API SITNA Página 30 de 33

Ejemplo 1 – iframe con fichero KML ubicado en una URL con parámetros y sin título

La URL de ubicación del fichero KML de “Promociones Censo de Vivienda” de Open DataNavarra tiene dos partes (url donde se guardan los ficheros y luego el parámetro file con elnombre del fichero a descargar):

http://gobiernoabierto.navarra.es/sites/all/modules/pubdlcnt/pubdlcnt.php? file=http%3A%2F %2Fwww.navarra.es%2Fappsext%2FDescargarFichero%2Fdefault.aspx%3FcodigoAcceso%3DOpenData%26fichero%3DVivienda%2FPromocionesViviendas.kml&nid=651

Toda esta URL sería el parámetro url del iframe KML, hay que codificar correctamente todoslos caracteres especiales que aparecen en esta url, tanto los que hay en la parte de rojo (: / ?)como todos los que hay en la parte azul (= % &)

Por lo tanto, la sentencia para cargar este fichero con el iframe KML API SITNA sólo con elparámetro URL sería:

http://sitna.navarra.es/kml/?url= http%3A%2F%2Fwww.gobiernoabierto.navarra.es%2Fsites %2Fall%2Fmodules%2Fpubdlcnt%2Fpubdlcnt.php%3Ffile%3Dhttp%253A%252F%252Fwww.navarra.es%252Fappsext%252FDescargarFichero%252Fdefault.aspx%253FcodigoAcceso%253DOpenData%2526fichero%253DVivienda%252FPromocionesViviendas.kml%26nid%3D651

El resultado es:

Se presenta el mapa básico con todas las funcionalidades explicadas en apartados anteriores.Se ha incluido una capa de trabajo que corresponde con la información del KML, en este casoson puntos agrupados en dos carpetas (<Folder>) cada una con un icono diferente que semuestra en la leyenda.

Manual de usuario API SITNA Página 31 de 33

Al pinchar sobre un punto se muestra toda la información incluida en <ExtendedData> paradicho punto.

Ejemplo 2 – iframe con fichero KML ubicado en URL con parámetros y con título

La sentencia para cargar el KML de “Promociones Censo de Vivienda” con parámetro titulosería:

http://sitna.navarra.es/kml/?url= http%3A%2F%2Fwww.gobiernoabierto.navarra.es%2Fsites %2Fall%2Fmodules%2Fpubdlcnt%2Fpubdlcnt.php%3Ffile%3Dhttp%253A%252F%252Fwww.navarra.es%252Fappsext%252FDescargarFichero%252Fdefault.aspx%253FcodigoAcceso%253DOpenData%2526fichero%253DVivienda%252FPromocionesViviendas.kml%26nid%3D651&title=Open%20Data%20Navarra.%20Promociones%20Censo%20de%20Vivienda

El resultado en este caso incluye la cabecera con el logo y el título:

Nota: el título sólo se muestra cuando se invoca desde el dominio navarra.es, por lo tanto esteejemplo se puede ver desde la ficha de Promociones de Censo de Vivienda del portal OpenData Navarra.

http://www.gobiernoabierto.navarra.es/es/open-data/datos/promociones-censo-de-vivienda-0

Si se indica el parámetro &title= sin valor, se cargará el visor con la cabecera y sólo el logonavarra.es que permite enlazar con dicho portal. Por ejemplo:

Manual de usuario API SITNA Página 32 de 33

http://sitna.navarra.es/kml/?url= http%3A%2F%2Fwww.gobiernoabierto.navarra.es%2Fsites %2Fall%2Fmodules%2Fpubdlcnt%2Fpubdlcnt.php%3Ffile%3Dhttp%253A%252F%252Fwww.navarra.es%252Fappsext%252FDescargarFichero%252Fdefault.aspx%253FcodigoAcceso%253DOpenData%2526fichero%253DVivienda%252FPromocionesViviendas.kml%26nid%3D651&title=

Manual de usuario API SITNA Página 33 de 33