Information for Developers

Useful information for developers interested in GeoNode.

The GeoNode is an open service built on open source software. We encourage you to build new applications using the its components and the resources it provides. This page is a starting point for developers interesting in taking full advantage of the GeoNode. It also includes links to the project's source code so anyone can build and customize their own GeoNode.

GeoNode Software

All the code that runs the GeoNode is open source. The code is available at http://github.com/geonode/geonode/. The issue tracker for the project is at http://projects.opengeo.org/CAPRA.

The GeoNode is built using several open source projects, each with its own community. If you are interested in contributing new features to the GeoNode, we encourage you to do so by contributing to one of the projects on which it is built:

  • GeoExt - The JavaScript toolkit for rich web mapping applications
  • OpenLayers - Pure JavaScript library powering the maps of GeoExt
  • GeoWebCache - Cache engine for WMS Tiles
  • GeoServer - Standards based server for geospatial information

What are OGC Services?

The data in this application is served using open standards endorsed by the Open Geospatial Consortium; in particular, WMS (Web Mapping Service) is used for accessing maps and WFS (the Web Feature Service) is used for accessing data. You can use these services in your own applications using libraries such as OpenLayers, GeoTools, and OGR (all of which are open-source software and available at zero cost).

What is GeoWebCache?

GeoWebCache provides mapping tiles that are compatible with a number of mapping engines, including Google Maps, Bing Maps and OpenLayers. All the data hosted by the GeoNode is also available through GeoWebCache. GeoWebCache improves on WMS by caching data and returning it much more quickly.

OpenLayers Example Code

To include a GeoNode map layer in an OpenLayers map, first find the name for that layer. This is found in the layer's name field (not title) of the layer list. For this example, we will use the Nicaraguan political boundaries background layer, whose name is risk:nicaragua_admin. Then, create an instance of OpenLayers.Layer.WMS:

var geonodeLayer = new OpenLayers.Layer.WMS("GeoNode Risk Data", "http://demo.geonode.org/geoserver/wms",{ layers: "risk:nicaragua_admin" });

Google Maps Example Code

To include a GeoNode map layer in a Google Map, include the layer namein the URL template.

var tilelayer = new GTileLayer(null, null, null, {tileUrlTemplate: 'http://demo.geonode.org/geoserver/gwc/service/gmaps?layers=risk:nicaragua_admin&zoom={Z}&x={X}&y={Y}', isPng:true, opacity:0.5 } );

Shapefile/GeoJSON/GML Output

To get data from the GeoNode web services use the WFS protocol. For example, to get the full Nicaraguan admin boundaries use:

http://demo.geonode.org/geoserver/wfs?request=GetFeature&typeName=risk:nicaragua_admin&outputformat=SHAPE-ZIP

Changing output format to json, GML2, GML3, or csv will get data in those formats. The WFS protocol also can handle more precise queries, specifying a bounding box or various spatial and non-spatial filters based on the attributes of the data.

GeoTools Example Code

Create a DataStore and extract a FeatureType from it, then run a Query. It is all documented on the wiki at http://geotools.org/.

GeoNode's Web Services

GeoNode's Web Services are available from the following URLs:

Dynamic tiles via WMS: WMS 1.1.1
Vector data via WFS: WFS 1.1.0
Metadata search via CSW: CSW 2.0.2
Cached tiles via WMTS: WMTS 1.0.0