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.