jueves, 15 de noviembre de 2007

PHP-Mapscript de Mapserver. Parte 2: Volviendo dinámico el MapFile

Creative Commons License

Esta obra está bajo una licencia de Creative Commons.

© 2007 Jaime M. Tan Nozawa. Usted es libre de copiar, distribuir y comunicar públicamente la obra y hacer obras derivadas bajo las condiciones siguientes: a) Debe reconocer y citar al autor original. b) No puede utilizar esta obra para fines comerciales (incluyendo su publicación, a través de cualquier medio, por entidades con fines de lucro). c) Si altera o transforma esta obra, o genera una obra derivada, sólo puede distribuir la obra generada bajo una licencia idéntica a ésta. Al reutilizar o distribuir la obra, tiene que dejar bien claro los términos de la licencia de esta obra. Alguna de estas condiciones puede no aplicarse si se obtiene el permiso del titular de los derechos de autor. Los derechos derivados de usos legítimos u otras limitaciones no se ven afectados por lo anterior. Licencia completa en castellano. La información contenida en este documento y los derivados de éste se proporcionan tal cual son y los autores no asumirán responsabilidad alguna si el usuario o lector hace mal uso de éstos.



En esta segunda parte del tutorial intentaremos hacer más dinámico nuestro MapFile (.map). Como vimos en la parte 1, pudimos crear un archivo de configuración inicial y cargar los datos que se mencionan en el contenido del archivo. Ahora queremos capturar los datos(propiedades) y modificar los datos que se encuentran dentro del archivo; claro, sin tener que entrar al .map para realizar un cambio, sino sólo realizándolo por código.

1. Primero el .map quedará como el siguiente para hacerlo más interesante:

#Inicio mapfile
MAP
NAME Pruebas
SIZE 600 400
EXTENT -87.9964 -19.0216 -63.114 1.19528

WEB
IMAGEPATH "C:/ms4w-php5/tmp/ms_tmp/" #Esto puede variar segun tu configuracion
IMAGEURL "/ms_tmp/"
END


LAYER
NAME "Departamentos"
STATUS ON
DATA "Lim_dep.shp"
TYPE POLYGON
CLASSITEM Nom_Dep

CLASS
NAME "LIMA"
EXPRESSION /LIMA/
STYLE
COLOR 200 150 2
OUTLINECOLOR 200 200 200
END
END

CLASS
NAME "OTROS"
EXPRESSION /.*/
STYLE
COLOR 100 28 55
OUTLINECOLOR 0 0 0
END
END
END

END
#Fin mapfile
Como nos percatamos ahora he agregado nuevas opciones (en negrita) de nuestro mapfile inicial.

Nuetra objeto layer ahora dispone de una propiedad más:
CLASSITEM Nom_Dep   
con él podemos escoger un campo dentro de la tabla, en este caso Nom_dep, para poder hacer algunas búsqueda y filtrar o segmentar según diferentes criterios.

En nuestro objeto CLASS que se encuentra dentro de LAYER ahora dispone de más propiedades:
 CLASS
NAME "LIMA"
EXPRESSION /LIMA/
STYLE
COLOR 200 150 2
OUTLINECOLOR 200 200 200
END
END

En este caso estoy poniéndole un nombre a ese CLASS : LIMA , y el filtro se hace según una expresión regular
en este caso /LIMA/ osea busca dentro de la columna Nom_dep todas los registros que contienen la palabra" LIMA".

En el otro STYLE denominado OTROS , la expresión regular
/.*/ significa uno o más caracteres. En otras palabras todas los restantes. y fíjense que cada CLASS se colorea con colores diferentes tanto sus bordes como el contenido.

2. Ahora procederemos a agregar más lineas en nuestro Ejemplo01.php y lo renombraremos a

ejemplo02.php

 1  <?php
2
// ejemplo02.php
3 // Jaime M. Tan Nozawa
4
5 //Cargo la extensión MapScript . Verificamos si la extensión ya está cargada por defecto.
6
if (!extension_loaded("MapScript")) dl('php_mapscript.'.PHP_SHLIB_SUFFIX);
7
8
// instanciamos un nuevo objeto: map object. El constructor debe recibir al menos el parámetro de la ubicación del archivo .map
9
$jMap = ms_newMapObj("ejemplo01.map");
10
11
// Renderización
12
$jImagen = $jMap->draw();
13
14
// Creamos y capturamos la ruta de imagen renderizada.
15
$url_imagen = $jImagen->saveWebImage();
16
?>
17
<HTML>
18 <HEAD>
19 <TITLE>Ejemplo 1</TITLE>
20 </HEAD>
21 <BODY>
22 <IMG SRC=<?php echo $url_imagen; ?> >
23 <br>
24 <?php
25
// Obtenemos Propiedades del MapaObj llamado jMap
26
echo "Nombre mapa: {$jMap->name}<br>";
27 echo
"Extent mapa: {$jMap->extent->minx} // {$jMap->extent->miny} // {$jMap->extent->maxx} // {$jMap->extent->maxy} <br>";
28 echo
"Tama&ntilde;o imagen: {$jImagen->width} {$jImagen->height}<br>";
29 echo
"Escala: 1/{$jMap->scale}<br><br>";
30
// echo ms_GetVersion()
31 ?>
32
</BODY>
33 </HTML>


Vemos claramente como podemos acceder a las propiedades del MapObj: $jMap

$jMap->name : propiedad nombre del object MapObject
$jImagen->width : ancho de la imagen en pixels
$jMap->extent->miny (minx) (maxx) (maxy) para capturar extent del mapa
La escala no está es muy buena proporción por que se esta usando coordenadas geodésicas (no obtiene áreas)
en próximos tutoriales veremos como corregir esta opción.

3. Ahora que ya mas o menos conocen los objetos y las propiedades , les dejo algo de código interesante para que lo analicen:

 1  <?php
2
// Obtenemos las capas
3
4
$jCapas=$jMap->getAllLayerNames();
5
$layersOn = array();
6 foreach (
$jCapas as $idx => $layer) {
7
8
$capaObj=$jMap->getLayerByName($layer);
9
10 if (
$capaObj->status==MS_ON) {
11 echo
"** CAPA :{$capaObj->name} **<ul>";
12
13 for(
$i=0;$capaObj->getClass($i);$i++){
14
$Class = $capaObj->getClass($i);
15 echo
"<li>CLASS:
16 <ul>
17 <li>NOMBRE CLASS: {$Class->name}</li>
18 <li>EXPRESION: {$Class->getExpression()}</li>
19 <li>COLOR: {$Class->getStyle(0)->color->red} {$Class->getStyle(0)->color->green} {$Class->getStyle(0)->color->blue}</li>
20 </ul></li>
21 "
;
22
23 }
24
25 echo
"</ul>";
26 }
27
28 }
29
?>


Resultado:


continuará...

lunes, 5 de noviembre de 2007

PHP-Mapscript de Mapserver. Parte 1: Conceptos

Creative Commons License

Esta obra está bajo una licencia de Creative Commons.

© 2007 Jaime M. Tan Nozawa. Usted es libre de copiar, distribuir y comunicar públicamente la obra y hacer obras derivadas bajo las condiciones siguientes: a) Debe reconocer y citar al autor original. b) No puede utilizar esta obra para fines comerciales (incluyendo su publicación, a través de cualquier medio, por entidades con fines de lucro). c) Si altera o transforma esta obra, o genera una obra derivada, sólo puede distribuir la obra generada bajo una licencia idéntica a ésta. Al reutilizar o distribuir la obra, tiene que dejar bien claro los términos de la licencia de esta obra. Alguna de estas condiciones puede no aplicarse si se obtiene el permiso del titular de los derechos de autor. Los derechos derivados de usos legítimos u otras limitaciones no se ven afectados por lo anterior. Licencia completa en castellano. La información contenida en este documento y los derivados de éste se proporcionan tal cual son y los autores no asumirán responsabilidad alguna si el usuario o lector hace mal uso de éstos.


¿Qué es MapServer?
MapServer es un entorno de desarrollo en código abierto (Open Source Initiative) para la creación de aplicaciones SIG en Internet/Intranet con el fin de visualizar, consultar y analizar información geográfica a través de la red mediante la tecnología Internet Map Server (IMS).

Sus características principales son:

Fuente: wikipedia

¿Qué es PHP/Mapscript?
PHP/Mapscript es un módulo para PHP que permite acceder a la API de MapServer. Éstas funciones y clases estarían disponible dentro de nuestro entorno de desarrollo. El módulo fue desarrollado y es actualmente mantenida por la empresa
DM Solutions Group.

La Familia mapscript está refresentada como el siguiente árbol (fuente de dato aquí):
          
  MapServer
/\
/ \
/ \
PHPMapScript \ SWIGMapScript
PHP4 +----+-----+----+----+----+
| | | | | |
Perl Python Ruby Java Tcl ...

Perl Python Ruby Java Tcl ...Y como se ve claramente el PHP es un Mapscript que es más cercano al MapServer y por ende más nativo en la ejecución de nuestras aplicaciones.

El MapFile
El MapServer se caracteriza por tener un archivo de configuración denominado mapfile que tiene como extensión punto map (.map). Aquí se definen los datos a ser usados por nuestra aplicación como los siguientes mencionados: las capas, sus tipos y su configuración; fuente de datos de origen y forma de servir los datos; leyenda y proyecciones ; y muchos otras configuraciones que se desea que se cargen al inicio.

Por tal motivo, podríamos decir que el corazón del Mapserver se configura a través de un archivo de texto que es usado en tiempo de ejecución. Bajo la perspectiva del programador se puede presentar como una jerarquía de objetos con un padre principal y muchos objetos hijos que derivan de él.

Notas sobre MapServer CGI : Aunque este no es el objetivo de nuestro artículo, la forma de utilización como CGI de mapserver es la más tradicional y la usada usualmente en los tutoriales que encontramos en Internet. MapServer CGI trabaja a través de plantillas HTML (templates) y bajo estructuras rígidas de consulta básica. Ahí el archivo .map es de vital importancia para la inicialización de las capas.

El PHP Mapscript rompe ésta rigidez del .map (pues carga las capas configuradas en él al inicializar) y podemos modificar, cambiar e incluso agregar más capas según queramos. Ésto significa que si tenemos una capa de color verde inactiva, podemos modificarla a rojo y activa. Hacer acercamiento o consultar data relevante.


Requerimientos para desarrollar
  1. Servidor Web: Apache o IIS con el módulo de PHP y PHP-mapscript de Mapserver
  2. Librerías : PROJ4, OGR, GDAL y utilitarios que iremos requiriendo
  3. Fuente de Datos: shape files, PostGIS u otra fuente OGR
  4. Un archivo Mapfile (.map)
  5. Un editor de texto o ID preferido para PHP.
  6. Conocimiento básicos de Geodesia y SIG y lo más importante: Muchas ganas de aprender
Estamos con suerte porque los requerimientos 1,2,3 ya vienen incluidos para Windows en un paquete llamado MS4W y lo pueden conseguir aquí.
Para los que están metidos en Linux, verán que encontrarán infinidad de paquetes ya compilador tanto para Ubuntu, Debian o Fedora. Solo se intalarían los debs o rpms correspondientes.
Por otro lado, también en Linux podrían usar un paquete denominado FGS y se encuentra aquí.

Si la instalación en Linux se torna algo dificultosa, pueden solicitar con comentario para crear un artículo dedicado sólo a la instalación del mismo.

Un ejemplo básico:

ejemplo01.php

1
<?php
2
// ejemplo01.php
3 // Jaime M. Tan Nozawa
4
5 //Cargo la extensión MapScript . Verificamos si la extensión ya está cargada por defecto.
6
if (!extension_loaded("MapScript")) dl('php_mapscript.'.PHP_SHLIB_SUFFIX);
7
8
// instanciamos un nuevo objeto: map object. El constructor debe recibir al menos el parámetro de la ubicación del archivo .map
9
$jMap = ms_newMapObj("ejemplo01.map");
10
11
// Renderización
12
$jImagen = $jMap->draw();
13
14
// Creamos y capturamos la ruta de imagen renderizada.
15
$url_imagen = $jImagen->saveWebImage();
16
?>
17
<HTML>
18 <HEAD>
19 <TITLE>Ejemplo 1</TITLE>
20 </HEAD>
21 <BODY>
22 <IMG SRC=<?php echo $url_imagen; ?> >
23 </BODY>
24 </HTML>


ejemplo01.map

MAP
NAME Pruebas
SIZE 600 400
EXTENT -87.9964 -19.0216 -63.114 1.19528

WEB
IMAGEPATH "C:/ms4w-php5/tmp/ms_tmp/"
IMAGEURL "/ms_tmp/"
END

LAYER
NAME "Departamentos"
STATUS ON
DATA "Lim_dep.shp"
TYPE POLYGON
CLASS
STYLE
COLOR 200 150 2
OUTLINECOLOR 0 0 0
END
END
END
END


En el archivo .map toda entrada es similar a etiquetas HTML porque tienen un inicio y un fin. El Mapfiles estonces está compuesto por objetos y otros que lo contiene.


La estructura de objetos del mapfile sería la siguiente (Fuente: Tutorial MapServer 4.X):


MAP
               |
+----+-----+----+----+----+
| |
WEB LAYER
                          |
        +----+-----+----+----+----+
| |
CLASS ...



Explicando el .map

Una sección relevante del .map es el objeto Web:
WEB
IMAGEPATH "C:/ms4w-php5/tmp/ms_tmp/"
IMAGEURL "/ms_tmp/"
END

Aquí se especifica las rutas donde se van a crear las imágenes renderizadas. Aquí le configuramos que se guarden en:
C:/ms4w-php5/tmp/ms_tmp/ (Cámbialo por uno de tu conviencia). Recuerda que esta carpeta debe de poder ser accedido públicamente a través de /ms_tmp/ . (El ms4w ya la configura automáticamente con un Alias en el Apache -- httpd.conf : Alias /ms_tmp/ /ms4w-php5/tmp/ms_tmp/ --)

Eso significa que si creamos una archivo :
C:/ms4w-php5/tmp/ms_tmp/prueba.gif
Se accede de la forma : http://localhost/
ms_tmp/prueba.gif

IMPORTANTE: Cada vez que accedemos a nuestro script PHP : Ejemplo01.php , se percatarán que se crea automáticamente una imagen GIF o JPG con un nombre aleatorio. Esa es la imagen que se muestra hacia el navegante y es capturada en la variable $url_imagen.

El MAP tiene los siguientes atributos
SIZE 600 400
EXTENT -87.9964 -19.0216 -63.114 1.19528

Especifica el tamaño de la imagen (el gif o jpg autogenerado ) y su extent.
El Extent especifica el límite de coordenadas en el cual se mostrará el mapa. En el Caso del Perú, como estamos en el OESTE - SUR ... corresponde los puntos: inferior-izquierdo (
-87.9964 -19.0216) y superior-derecho (-63.114 1.19528). Mi analogía con trigonometría de matemáticas , es como si estuvieramos en el tercer cuadrante.


El objeto Layer se encuentra contenido dentro del objeto MAP. Y el CLASS dentro del Layer

LAYER
NAME "Departamentos"
STATUS ON
DATA "Lim_dep.shp"
TYPE POLYGON
          CLASS   
STYLE
COLOR 200 150 2
OUTLINECOLOR 0 0 0
END
END
END

Vemos que nuestra capa llamada "Departamentos" carga un shape file de tipo polígono ... y lo coloremos con colores RGB (200 150 2) a través del objeto STYLE que se encuentra dentro del OBJETO CLASS.
STATUS ON: dice que la capa esté activa y se muestre por defecto.


El Resultado:


link anexo

Shape File : Lim_dep.shp