GeoNode Quickstart

Open Source Geospatial Content Management System

GeoNode is a web-based application and platform for developing geospatial information systems (GIS) and for deploying spatial data infrastructures (SDI).

In this Quickstart guide you will learn the following:

  1. to register a new account to get started
  2. add a new layer
  3. create a map using your new layer
  4. share your map with others

Start GeoNode on your Live DVD or local VM and redirect your browser at http://localhost/ (this is the default port). The page will look like shown in the image below.

Warning

If GeoNode isn’t available by default, you will need to start Apache2 HTTPD and Tomcat8 Web Servers

$> sudo service apache2 restart
$> sudo service tomcat8 restart
Services Start

Services Start

Welcome page

Welcome page

1. Register a new account

From the interface shown above, one can view and modify existing spatial layers and maps, as well as find information on other GeoNode users. But, without being logged in, you are limited to read-only access of public layers. In order to create a map and add layers to it, you have to have create an account first.

  1. From any page in the web interface, you will see a Sign in link. Click that link, and in the dialog that displays, click the Register now link.

    Sign in Form

    Sign in Form

  2. On the next page, fill out the form. Enter a user name and password in the fields. Also, enter your email address for verification.

    Register Form

    Register Form

  3. By clicking Sign up you will be returned to the homepage. Now you’ve registered an account, you are able to add layers to it as well as create maps and share those with other users.

Note

In case e-mail confirmation has been enabled by configuration (see Advnaced Tutorial and GeoNode documentation for that), you will be returned to the welcome page. An email will be sent confirming that you have signed up. While you are now logged in, you will need to confirm your account. Navigate to the link that was sent in the email.

2. Add a new layer

Layers are a published resource representing a raster or vector spatial data source. Layers also can be associated with metadata, ratings, and comments.

  1. To add a layer to your account, navigate to the welcome page. There the following toolbar can be seen:

    Toolbar

    Toolbar

  2. By clicking the Layers link you will be brought to the Layers menu where a new subtoolbar can be seen. This toolbar allows you to Explore, Search and Upload layers.

    Upload Button

    Upload Button

  3. Now click Upload Layers and you’ll see the upload form.

    Upload Form

    Upload Form

  4. You have two possibilities to add your files. You can either do that by using drag & drop or you choose to browse them. Be aware that you have to upload a complete set of files, consisting of a shp, a prj, a dbf and a shx file. If one of them is missing, GeoNode will warn you before you upload them.

  5. You shold now be able to see all the files you want to upload.

    Files to be Uploaded

    Files to be Uploaded

  6. GeoNode has the ability to restrict who can view, edit, and manage layers. On the right side of the page you can see the Permission section, where you can limit the access on your layer. Under Who can view and download this data, select Any registered user. This will ensure that Anonymous view access is disabled. In the same area, under Who can edit this data, select your username. This will ensure that Only You are able to edit the data in the layer.

    Permissions

    Permissions

  7. To upload data, click the Upload button at the bottom.

Warning

If the upload fails due to an e-mail issue, that means that the GeoNode Notifications subsystem must be disabled, since your VM most probably is not connected to the Internet and/or it is not able to send e-mail.

$> cd /home/geonode/my_geonode/
$> vim my_geonode/local_settings.py

    ...
    # notification settings
    NOTIFICATION_ENABLED = False
    ...
    # INSTALLED_APPS += (NOTIFICATIONS_MODULE, )
    ...
    #Define email service on GeoNode
    EMAIL_ENABLE = False
    ...

$> sudo service apache2 restart

3. Create a new map

The next step for you is to create a map and add the newly created layers to this map.

  1. Click the Maps link on the top toolbar. This will bring up the list of maps.

    Create new Map Button

    Create new Map Button

  2. Currently, there aren’t any maps here. To add one click the Create a New Map button and a map composition interface will display.

    Maps Editor

    Maps Editor

    In this interface there is a toolbar, layer list, and map window. The map window contains the MapQuest OpenStreetMap layer by default. There are other service layers available here as well: Blue Marble, Bing Aerial With Labels, MapQuest, and OpenStreetMap.

  3. Click on the New Layers button and select Add Layers.

    Add Layers

    Add Layers

  4. Now you should be able to see all the availabel layers. In your case, this should only be the ones you’ve added before (San Andreas?).

  5. Select all of the layers by clicking the top entry and Shift-clicking the bottom one. Click Add Layers to add them all to the map.

    Add Layers

    Add Layers

  6. The layers will be added to the map. Click Done (right next to Add Layers at the bottom) to return to the main layers list.

  7. To save the map click on the Map button in the toolbar, and select Save Map.

    Save Map

    Save Map

  8. Enter a title and abstract for your map.

    Edit Map Metadata

    Edit Map Metadata

  9. Click Save. Notice that the link on the top right of the page changed to reflect the map’s name.

    Save Map

    Save Map

    This link contains a permalink to your map. If you open this link in a new window, your map will appear exactly as it was saved.

4. Share your map

Now let’s publish our map and make it available to the world.

  1. Click the Maps link on the top toolbar. This will bring up the list of maps.

    Explore Maps Button

    Create new Map Button

  2. Click on the Map To publish. Make any final adjustments to the map composition as desired, including zoom and pan settings.

  3. To save the map click on the Map button in the toolbar, and select Publish Map.

    Publish Map

    Publish Map

  4. The title and abstract as previously created should still be there. Make any adjustments as necessary, and click Save.

    Edit Map Metadata

    Edit Map Metadata

  5. A new dialog will appear with instructions on how to embed this map in a web page, including a code snippet. You can adjust the parameters as necessary.

    Embed the Map

    Embed the Map

Your map can now be shared by embedding it on any HTML!

Note

Notice that you can easily retrieve the full page link of your Map by simply attaching the keyword embed at the end of the URL.

As an instance if you open a Map and click on View Map, by just changing the URL

from (this is just an example)

http://localhost/maps/22/view

to

http://localhost/maps/22/embed

You will get the full page view of your map

Full Page View of the Map

Full Page View of the Map

Try a small Exercise with HTML

  1. Open a text editor like shown in the figure below

    GEdit Text Editor

    GEdit Text Editor

  2. Write some very basic HTML code using the snippet provided by the Publish Map action above

    HTML Embedding the Map

    HTML Embedding the Map

    <html>
      <body>
        <H1>This is my new Map!</H1>
        <p align="center">
          <iframe
               src="http://localhost/maps/22/embed"
               width=800
               height=450
               style="border:0">
          </iframe>
          <br>
          <i>This is cool, isn't it?</i>
        </p>
      </body>
    </html>
    
  3. Click on Save As like shown in the figure below

    GEdit Text Editor - Save As

    GEdit Text Editor - Save As

  4. Save it to the Desktop by specifying a name and the extension .html

    GEdit Text Editor - Save to Desktop

    GEdit Text Editor - Save to Desktop

  5. Click the *Show Desktop” button on the side bar, like shown below

    Show Desktop

    Show Desktop

  6. Double-Click on the file you just saved

    Double-Click on the HTML File

    Double-Click on the HTML File

  7. Look the results on the Web Browser, which will be automatically opened

    HTML Embedded Map

    HTML Embedded Map

To be continued

Now you’ve gotten a quick insight in the possibilities of GeoNode. To learn more about GeoNode and its features, visit the official webpage www.geonode.org.

Stay in touch with the GeoNode community through the #geonode IRC channel using http://webchat.freenode.net/ or by asking your question in our google group!