SIMMAPXML.EXE:
API
de acceso al Servicio
Municipal de Mapas GeoGranada
El
Servicio Municipal de Mapas del Ayuntamiento de Granada, denominado
GeoGranada, posee una interfaz de exploración WEB implementada como un
CGI denominado SIMMAPXML.EXE
SIMMAPXML.EXE está
diseñado para la obtención de información geográfica del Servicio
Municipal de Mapas en formato XML. Dispone de una serie de comandos que
permite acceder a la funcionalidad geográfica:
- establecimiento
de una sesión de usuario que permita mantener una conexión
con estado (las peticiones CGI son sin estado)
- el
dibujo de un mapa en formato JPG de acuerdo a las características
actuales de la sesión
- la
obtención y modificación de las características del mapa de la sesión
actual
- la obtención de
las entidades geográficas que cumplan determinadas condiciones de
ubicación espacial o de nominación toponímica.
La
funcionalidad está publicada como una lista de comandos que se invocan
mediante URLs en cuyo query
se determinan las características de la acción a ejecutar mediante
pares "parámetro=valor"
Con
SIMMAPXML.EXE es posible desarrollar una aplicación interactiva
utilizando la técnica de desarrollo AJAX (Asynchronous JavaScript And
XML). Un ejemplo de aplicación es el Visor WEB GeoGranada.
Los
comando tienen parámetros obligatorios (indicados entre signos de menor
y mayor "<obligatorio>") y opcionales
(indicados entre llaves "{opcional}"). Vea un ejemplo respuesta en XML
de una petición o pulse sobre el mapa para obtener un ejemplo de respuesta en JPG
Lista de Comandos
Comandos
de
Inicialización de la conexión:
ABRESESIONMAPA
{width}
{height} {tema} {contexto} {<monitorsize>
<screenwidth> <screenheight>} {heredasesion}
Comandos de Obtención y
Establecimiento de características de la sesión:
GETLISTACAPAS
<idmapasesion> {tema}
GETCAPASDEBUSQUEDA
<idmapasesion> {tema}
SETMONITOR
<idmapasesion> <monitorsize>
<screenwidth> <screenheight>
SETMAPABORDE
<idmapasesion> <color>
ENVIARMENSAJE
<idmapasesion> <texto> {tipo}
Comandos de Obtención de una
imagen de mapa en JPG:
GETULTIMOMAPA
<idmapasesion> {comprimir} {<dim>
<fila> <columna>}
GETMAPABARRIO
<valor> {width} {height} {maxescala} {color} {borde}
{comprimir}
GETMAPACALLE
<valor> {width} {height} {maxescala} {color} {borde}
{comprimir}
GETMAPAPORTAL
<valor> {width} {height} {maxescala} {color} {borde}
{comprimir}
GETMAPAESTATICO
<contexto> <tema> <capa>
<valor> {width} {height} {maxescala} {color} {borde}
{comprimir}
Comandos de Obtención de un
fichero una impresión de mapa en formato PDF:
Comandos de Gestión de la
extensión espacial del mapa:
GETZOOMESTADO
<idmapasesion>
ZOOM
<idmapasesion> {x1, y1, x2, y2 | escala | cambio} {tema}
{listacapas} {width} {height}
ZOOMTODO
<idmapasesion> {tema} {listacapas} {width} {height}
ZOOMANTERIOR
<idmapasesion> {tema} {listacapas} {width} {height}
ZOOMSIGUIENTE
<idmapasesion> {tema} {listacapas} {width} {height}
PANNORTE
<idmapasesion> {desplaza} {tema} {listacapas} {width}
{height}
PANSUR
<idmapasesion> {desplaza} {tema} {listacapas} {width}
{height}
PANOESTE
<idmapasesion> {desplaza} {tema} {listacapas} {width}
{height}
PANESTE
<idmapasesion> {desplaza} {tema} {listacapas} {width}
{height}
Comandos de Búsqueda de una
entidad geográfica:
BUSCARTOPONIMOSPORVALOR
<idmapasesion> <capa> {valor} {condicion}
{tema}
BUSCARTOPONIMOPORXY
<idmapasesion> <capa> <X>
<Y> {tema}
BUSCARENTIDADPORTOPONIMO
<idmapasesion> <capa> <valor>
BUSCARMAPAPORTOPONIMO
<idmapasesion> <capa> <valor>
{opcion} {color} {tema} {listacapas} {width} {height}
BUSCARMAPAPORXY
<idmapasesion> <capa> <X>
<Y> {opcion} {color} {tema} {listacapas} {width} {height}
Comandos
de Búsqueda de
múltiples entidades geográficas:
BUSCARENTIDADESPORXY
<idmapasesion> <capa> { x1 y1 x2 y2 |
listaXY | x y radio } {opcion} {maxentidades}
COMPROBARENTIDADESPORXY
<idmapasesion> <capa>
<listatoponimos> { x1 y1 x2 y2 | listaXY | x y radio }
{opcion}
Ejemplo de inicio de
una nueva sesión.
El
siguiente ejemplo es un diálogo que devuelve información en XML.
Llamada:
Respuesta:
<? xml
version="1.0" encoding="ISO-8859-1" ?>
<respuesta
tipo="ABRESESIONMAPA">
<error>none</error>
<idmapasesion>08050813205640101LZL8442T115</idmapasesion>
<width>600</width>
<height>400</height>
<temas defecto="Callejero Municipal">
<tema
nombre="Callejero Municipal">Callejero Oficial del
Municipio de Granada</tema>
</temas>
<paneles desplegado="CALLEJERO">
<panel
id="CAPAS">Capas:
Activar/Desactivar</panel>
<panel id="CALLEJERO">Buscador de
Calles</panel>
<panel id="PROPIEDADES">Resultado de la
Localización</panel>
<panel id="MEDIDAS">Herramientas de
Medida</panel>
</paneles>
</respuesta>
Ejemplo de
petición de una imagen de mapa en formato JPG
Llamada: