Using GISFaces™ is easy. With the instructions below, you should be up and running in no time.



  • Download the latest GISFaces release.
  • The downloaded .zip file contains the library .jar, JavaDoc .jar, examples .war, and documentation .pdf files.
  • Copy the gisfaces .jar file to your project's WEB-INF/lib directory.
  • No configuration or setup is required.

Create a web page:

  • The easiest way to get started is to use an .xhmtl page from the examples .war file.
  • The simple.xhtml page from the examples .war file is shown below.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" ""> <html xmlns="" xmlns:f="" xmlns:h="" xmlns:gis=""> <h:head> <title>GISFaces Example Map</title> </h:head> <h:body> <h:form> <h:panelGroup id="panel1" layout="block" styleClass="gisfacesMapPanel"></h:panelGroup> <gis:map mapPanel="panel1" background="streets" latitude="39.828175" longitude="-98.5795" zoom="4"></gis:map> </h:form> </h:body> </html>


  • Add the namespace xmlns:gis="" to your page.
  • Add a gis:map component to your page.
  • Add zero or more gis:service components to the gis:map component.
  • Add zero or more gis:layer components to a gis:service component.

Run all examples from the provided .war file:

  • Deploy the gisfaces examples .war file to your local Java container. Try Glassfish or Tomcat if you need one.
  • Open a browser using an address similar to http://localhost:8080/gisfaces-examples-1.9.0
  • Run the example map of your choice!