HomeHomeDatacrossing DSSDatacrossing DSSThe GRIDThe GRIDApplicationApplicationDocumentationDocumentation
PATH: » Documentation » mscross ITA  ENG  FRA  
 
Staff Pubblicazioni Bibliografia Versioni msCross Links Google Map Eventi FAQ
 

msCross: AJAX (WEB 2.0) WEB GIS Client

msCross e` un Client WEB GIS scritto in AJAX (WEB 2.0), nato inizialmente come interfaccia Javascript per UMN Mapserver.
Con le successive versioni si sono adottati alcuni standard diffusi dal Open Geospatial Consortium come WFS e WMS, che rendono msCross compatibile con numerosi software GIS server.
Le tecnologie di sviluppo utilizzate fanno capo al paradigma AJAX, quindi con un occhio di riguardo alla compatibilita` cross-browser e in generale all'interoperabilita`.
L'obiettivo di msCross e` quello di aiutare gli sviluppatori nella creazione di applicazioni WEB GIS avanzate, utilizzando strumenti completamente Free Software e un'interfaccia API programmabile molto potente in stile Google Map.
msCross e` contenuto in un singolo file sorgente, molto leggero e semplicissimo da usare.
Il progetto SourceForge di msCross si trova qui: http://sourceforge.net/projects/mscross

Importante:
Se sei interessato a partecipare attivamente allo sviluppo di msCross scrivi all'indirizzo datacrossing@crs4.it

E` stata testata coi seguenti browser:
  1. Mozilla Firefox >= 1.0.5
  2. Internet Exploer >= 6.0
  3. Opera >= 8.51
Caratteristiche:
  1. Free Software, distribuito sotto licenza GPL (Open Source)
  2. Funziona lato client
  3. Cross-browser / cross-platform
  4. Immediato utilizzo (un solo file javascript, non richiede installazione)
  5. Facilmente personalizzabile ed estendibile
  6. Usa la tecnologia AJAX (Asynchronous JavaScript and XML)
  7. Supporto interfaccia CGI di UMN Mapserver
  8. Supporto di Overlay puntuali "sensibili"
  9. Supporto OGC WFS client (Web Feature Service di Open Geospatial Consortium: pdf) per il caricamento di layer di punti
  10. new Supporto OGC WMS client (Web Map Service, Open Geospatial Consortium: pdf)
  11. new Completa personalizzazione delle toolbar
  12. new Modalita` di debugging
Sviluppi futuri:
  1. Overlay di linee e poligoni
  2. Query features alfanumeriche tramite protocollo WMS
 Screenshot 1
Un esempio di webgis

Screenshot 2
Esempio di Overlay (WFS)

Screenshot 3
Visualizzazione simulazioni

Screenshot 4
Protocollo OGC WMS

Download

  1. mscross.js v1.1.9 (date: 20070218)
  2. mscross.js v1.1.8 (date: 20061012)
  3. mscross.js v1.1.7 (date: 20061007)
  4. mscross.js v1.1.6 (date: 20060830)
  5. mscross.js v1.1.5 (date: 20060706)
  6. mscross.js v1.1.4 (date: 20060628)
  7. mscross.js v1.1.2 (date: 20060502)
  8. mscross.js v1.0 (date: 20060207)
  1. Standard Icons (date:20060905)

Esempio 1 (Mappa principale + reference)

<html>
  <head>
   <title>msCross Sample Test</title>
   <script src="mscross.js" type="text/javascript"></script>
  </head>
  <body>

   <div style="width: 460px; height: 400px;" id="map_tag"></div>
   <div style="width: 190px; height: 400px;" id="ref_tag"></div>

   <script type="text/javascript">
     //<![CDATA[
     myMap1 = new msMap( document.getElementById('map_tag') );
     myMap1.setCgi( '/cgi-bin/mapserv' );
     myMap1.setFullExtent( Xmin, Xmax, Ymin );
     myMap1.setMapFile( '/home/user/map_files/mymapfile.map' );
     myMap1.setLayers( 'layer1 layer2 layer3' );

     myMap2 = new msMap( document.getElementById('ref_tag') );
     myMap2.setCgi( '/cgi-bin/mapserv' );
     myMap2.setActionNone();
     myMap2.setFullExtent( Xmin, Xmax, Ymin );
     myMap2.setMapFile( '/home/user/map_files/mymapfile.map' );
     myMap2.setLayers( 'layer4 layer5' );

     myMap1.setReferenceMap(myMap2);
     myMap1.redraw(); myMap2.redraw();
     //]]>
   </script>
  </body>
</html>
Sostituire le parti in rosso con i propri parametri.

Esempio 2 (Mappa + Point Overlay Layer via protocollo WFS di Mapserver)

<html>
  <head>
   <title>msCross Sample Test</title>
   <script src="mscross.js" type="text/javascript"></script>
  </head>
  <body>

   <div style="width: 460px; height: 400px;" id="map_tag"></div>
   <script type="text/javascript">
     //<![CDATA[
     myMap1 = new msMap( document.getElementById('map_tag') );
     myMap1.setCgi( '/cgi-bin/mapserv' );
     myMap1.setFullExtent( Xmin, Xmax, Ymin );
     myMap1.setMapFile( '/home/user/map_files/mymapfile.map' );
     myMap1.setLayers( 'layer1 layer2 layer3' );
     myMap1.setBorder(50);

     a = 'http://www.google.com/mapfiles/markerG.png';
     b = 'http://www.google.com/mapfiles/shadow50.png';
     myIcon = new msIcon(a, b, 1, 2);
     mySkin = null;

     myMap1.loadPointsOverlayWFS('http://wms_server.com/wms', 'layer4 layer5', myIcon, mySkin);
     myMap1.redraw();
     //]]>
   </script>
  </body>
</html>
Sostituire le parti in rosso con i propri parametri.

Descrizione dell'interfaccia API (non completo)

Istanzia l'oggetto msMap

var myMap = new msMap(DivTag [, ControlType]);

ControlType: e` una costante stringa che specifica la posizione della toolbar
  - standard, standardRight
  - standardLeft
  - standardUp
  - standardCornerLeft
  - standardCornerRigh

Imposta il path del CGI MapServer

msMap.setCgi(url);

Imposta il MapFile da passare a MapServer

msMap.setMapFile(path);

Imposta l'extent completo della mappa

msMap.setFullExtent(Xmin, Xmax, Ymin);

Imposta la lista dei layers da visualizzare

msMap.setLayers(string);

Imposta la dimensione dei bordi della mappa in pixel (zona non visibile)

msMap.setBorder(integer);

Carica un layer di punti (overlay) via protocollo WFS (i dati sono trasferiti in formato GML (XML)). Insieme ai dati geografici vengono anche scambiati gli attributi alfanumerici, visualizzabili tramite click del mouse sul punto

msMap.loadPointsOverlayWFS(server url, layers, msIcon, msInfoSkin);

xxx

setActionZoombox()

xxx

msMap.setActionPan()

xxx

xxx msMap.setActionZoomIn()

xxx

xxx msMap.setActionZoomOut()

Disabilita la Toolbar dei comandi da una mappa

msMap.setActionNone();

Ridisegna la mappa

msMap.redraw();

Imposta il modo di funzionamento di Mapserver

msMap.setMode(Mode);

Mode: Parametro "mode" di Mapserver
  - map
  - legend

Imposta una mappa Reference, nella quale sara` rappresentato il box dell'extent della mappa

msMap.setReferenceMap(msMap);

Collegamento tra 2 oggetti msMap

msMap.attachMap(msMap);

Cambia le icone della Toolbar

msMap.setIcon(id, url);

Imposta argomenti arbitrari passati al CGI MapServer

msMap.setArgs(string);

Imposta il formato immagine nel protocollo WMS

msMap.setWmsImageFormat(string);

Imposta lo Spatial Reference System (proiezione) per le richieste WMS

msMap.setWmsProjection(string);

Attiva la modalita` debug, cliccare sul bottone Degub per conoscere l'url della richiesta

msMap.debug();

Progetti attinenti

  1. WMS-MAP
  2. quickWMS
  3. ka-Map
Valid CSSValid HTML 4.01 TransitionalPHP PoweredMapServer Powered CRS4, 09010 PULA (CA - Italy) email: datacrossing@crs4.it