PHP Mapscript Parte 3: Trabajando con Mapserver sin MapFile (.map)

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 parte 3 del tutorial haremos algo interesante, trabajaremos SIN usar un Mapfile (.map). Como ya se habrán dado cuenta los datos se cargan según la configuración del .map que hemos estado trabajando últimamente, pero he visto que preguntan siempre en los foros que siempre les parece algo rígido, tener que estar entrando a un archivo de texto para estar agregando capas o cambiándole el color. Con esta parte 3 de este tutorial, se te abrirán nuevas puertas y el horizonte como programador Web SIG, te darás cuenta que podemos, sin problemas pero con algo de tiempo, crear nuestra propia interfaz Web de administración del Mapserver (aunque ya existen proyectos de este tipo pero aún en desarrollo).

Yo diría que el .map o Mapfile es como un "punto ini" (.ini). Ese significa que lo usamos para optimizar la velocidad del mapserver para poder cargar las capas por defecto la primera vez que entran a nuestra aplicación, y una vez hecho ésto, los vamos modificando según nos convenga.

Esta vez haremos algo simple, trataremos de hacer el tutorial #1 pero sin usar MapFile...

Eso significa que intentaremos crear un mapa como SI EXISTIERA el siguiente MapFile:

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

          CLASS
             STYLE
               COLOR 200 150 2
               OUTLINECOLOR 0 0 0
               END
          END

END


Este Mapfile que he puesto ES SOLO DE REFERENCIA y NO VA A SER UTILIZADO.

Aquí les pongo mi CÓDIGO EQUIVALENTE A LO ANTERIOR:

1 <?php
2 // ejemplo01.php trabajando sin mapfile
3 // Jaime M. Tan Nozawa 2007 Creative Co
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.
9 $jMap = ms_newMapObj("");
10
11 $jMap->set("name","Pruebas");
12 $jMap->set("shapepath","C:/ms4w-php5/carpetaDondeestantusShapes/");
13
14 $jMap->setSize(600,400);
15 $jMap->setExtent(-87.9964,-19.0216,-63.114,1.19528);
16
17
18 $jMap->web->set( "imagepath" , "C:/ms4w-php5/tmp/ms_tmp/" );
19 $jMap->web->set( "imageurl", "/ms_tmp/" );
20
21 // Creamos un Layer dentro de nuestro MapObj y seteamos sus propiedades
22 $jLayer = ms_newLayerObj($jMap);
23 $jLayer->set( "name", "Departamentos");
24 $jLayer->set( "type", MS_LAYER_POLYGON);
25 $jLayer->set( "status", MS_ON);
26 $jLayer->set( "data", "Lim_dep.shp");
27
28 //Creamos un classObj dentro del LayerObj
29 $jClass = ms_newClassObj($jLayer);
30
31 //Creamos un styleObj dentro del classObj
32 $jStyle = ms_newStyleObj($jClass);
33
34 $jStyle->color->setRGB(200, 150, 2);
35 $jStyle->outlinecolor->setRGB(0, 0, 0);
36
37 $jImagen = $jMap->draw();
38
39 // Creamos y capturamos la ruta de imagen renderizada.
40 $url_imagen = $jImagen->saveWebImage();
41 ?>


1) MapObj
En este caso, la creación del MapObj se realiza sin pasarle un parámetro, de esta forma no cargamos ningún .map:

$jMap = ms_newMapObj("");

Además hay un objeto que ahora lo configuro "al vuelo" es el objeto Web. Este objeto Web no tienes que instanciarlo, ya está creado automáticamente al crear un MapObj por eso ingreso las propiedades de frente:

18 $jMap->web->set( "imagepath" , "C:/ms4w-php5/tmp/ms_tmp/" );
19 $jMap->web->set( "imageurl", "/ms_tmp/" );


Otra propiedad NUEVA es SHAPEPATH. Esta propiedad es necesaria para poder hacer más fácil las cosas y no estar poniéndole toda la ruta cada vez que agregamos un layer y hacemos referencia a la ubicación del shapefiel. (fíjate en la propiedad DATA del Layer, ya no pongo rutas largas)

12 $jMap->set("shapepath","C:/ms4w-php5/carpetaDondeestantusShapes/");

Fíjate claramente como voy ingresando las propiedades, siempre con el método "set" para cualquier objeto dentro del Map:

int set(string propertiedad, valor)

con el set podemos modificar casi todas las propiedades de los objetos (a menos que tenga una especializada para una propiedad específica) . Si retorna un valor -1, significa error.

2) Objetos dentro del MAP
Cuando creo un layer dentro del MapObj necesariamente, al instanciarlo, tengo que pasarle el objeto al cual va a ser parte. En este caso creo una capa LayerObj que se encontrará dentro de un MapObj:

ms_newLayerObj($jMap);

Igual para el class o para el style .. que están contenidos siempre dentro de un objeto mayor

29 $jClass = ms_newClassObj($jLayer);

32 $jStyle = ms_newStyleObj($jClass);

3) Contantes:
Además de todo lo anterior, se han usado unas nuevas contantes. Para nuestro caso la constante de tipos de Layers. En nuestro ejemplo el tipo polígono.
Otros posibles valores son:

MS_LAYER_POINT, MS_LAYER_LINE, MS_LAYER_POLYGON, MS_LAYER_RASTER, MS_LAYER_ANNOTATION

El último tipo, hace referencia a una capa de anotaciones.
Algunas veces deseamos etiquetar solamente o sino poner
íconos , logos para adornar o facilitar la comprensión, ETC.

----
Bueno eso es todo, no pongo resultados porque sería el mismo que el de la parte 1. Pueden ustedes probar cambiar cualquiera de las propiedades pasándole parámetros GET o usando SESIONES. O mejor aún, hacemos una interfaz simple para configurar las propiedades. Bueno ya todo está en tu imaginación.
Para acabar siempre con una imagen , aquí les dejo un gráfico explicativo del .map (extraído del Libro WebMapping) que lo encontré navegando dentro del preview del libro.


disfrútenlo... y no olviden escribir y postear sus comentarios.

--NOTA de ACTUALIZACIÓN--
RETO DEL TUTORIAL: Recrear el mapa del tutorial parte 2 pero sin usar un MapFile.

PHP-Mapscript de Mapserver. Parte 2: Volviendo dinámico el MapFile (Continuación)

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.

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  ?>

Explicación ...

a) $jCapas=$jMap->getAllLayerNames();

Con el método (clase MapObj) getAllLayerNames obtenemos un array ($jCapas) en el cual dispondremos los nombres de cada capa (Layers) de nuestro MapFile. Por tanto haciendo un foreach haríamos un recorrido del array:

foreach ($jCapas as $idx => $layer)

b) Objeto LayerObj

$capaObj=$jMap->getLayerByName($layer);

Con el método (clase MapObj) getLayerByName obtenemos un objeto LayerObj($capaObj) a partir de su parámetro donde ingresas el nombre de la capa. Como ya hemos conseguido los nombres de cada capa a través del método anterior entonces no tenemos problemas. En otras palabras, el foreach anterior recorre capa a capa, y este método obtiene el objeto LayerObj (Ver Cuadro del tutorial parte 1).

La propiedad

$capaObj->status

obtiene en sí el estado de la capa , ON/OFF/DEFAULT. Los valores en el mapscript son contantes de entorno de la API. En este caso puede obtener los valores: MS_ON, MS_OFF, MS_DEFAULT.

Existen otras contantes booleanas que se usan en otras situaciones: MS_TRUE, MS_FALSE, MS_YES, MS_NO

Más Propiedades:

$capaObj->name : El nombre de la capa (String)
$capaObj->transparency : Transparencia de la capa (Int)
$capaObj->maxscale : Escala máxima de visualización (double)
$capaObj->minscale : Escala mínima de visualización (double)
$capaObj->classitem : Cadena classitem que se explicó al inicio(string)

Y así todas las propiedades que puedes agregar en el MapFile


c) Objeto ClassObj

Cada Objeto LayerObj puede tener muchos Objetos ClassObj dentro,pero siempre al menos uno. El ClassObj sirve para categorizar nuestra capa por filtros según el campo del CLASSITEM y filtrado con el EXPRESSION. Si se omite el EXPRESSION significa que solo había un único ClassObj.

$Class = $capaObj->getClass($i)

En nuestra caso estoy usando el método getClass (de la clase ObjLayer) que te retorna una objeto ClassObj que se almacena en la variable $Class. El $i es un número entero que debe representar que CLASS nos referimos. Cero (0) sería el primer class y obligatorio pues todo Layer debe tener siempre un Class.
Para variar ahora no usé foreach sino un for para hacer el recorrido.

Más propiedades del objeto ClassObj:

$Class->name : Nombre de la clase

Más métodos del objeto ClassObj:

$Class->getExpression() : Retorna un String que obtiene el FILTRO a usar


d) styleObj

Este objeto puedes definir el color de background; grosor y color lineas;tamaño de fuente; etc...

Yo estoy en este caso usando

$Class->getStyle(0)

Método de la clase ClassObj que obtiene un objeto styleObj. Debido a que siempre he usado
un solo Style por Layer pongo el número 0 , pero si hubiera más habrían números correlativos

Propiedades:

$Class->getStyle(0)->color : Propiedad que contine el Objeto colorObj.
Este objeto color tiene propiedades RGB (red,green,blue)

$Class->getStyle(0)->backgroundcolor : Color del fondo (colorObj)
$Class->getStyle(0)->outlinecolor : color del borde del CLASS (colorObj)
$Class->getStyle(0)->size : Tamaño de la fuente (int)

Es todo para ese código anterior, ¿fácil?

4. Modificando las propiedades

Comencemos con algo simple, modifiquemos el extent del mapa
(hacemos un aparente zoom) y el color de un Class de un layer:

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  $jMap->setExtent(-80.17494,-14.0216,-72.93546,-9.19528);
12  
13  $jColor = $jMap->getLayerByName('Departamentos')->getClass(0)->getStyle(0)->color;
14
15  $jColor->setRGB(100,150,120);
16  
17  $jImagen = $jMap->draw();
18  // Creamos y capturamos la ruta de imagen renderizada.
19  $url_imagen = $jImagen->saveWebImage();
20  ?>

$jMap->setExtent(-80.17494,-14.0216,-72.93546,-9.19528) ;

En este caso estamos usando el método setExtent para MODIFICAR
el extent del mapa y por tanto hacemos un zoom hacia una región
obteniendo las coordenadas de los puntos extremos.

setExtent(double minx, double miny, double maxx, double maxy)

Con las sieguiente línea:
$jColor =$jMap->getLayerByName('Departamentos')->getClass(0)->getStyle(0)->color;

Como se explicó antes he obtenido la propiedad colorObj
del estilo 0, de la clase 0, de la capa llamada 'Departamentos' de objeto Map.

Una vez hecho esto MODIFICARE el color de ese STYLE:

$jColor->setRGB(100,150,120 );

Más adelante estaré trabajando en un tutorial más interesante,
que lo llamaré: Mapserver sin MapFile (.map).

@__ @

Resultado: