Cartoview Documentation

Transcription

1 Cartoview Documentation Release Cartologic February 08, 2017

2

3 Contents 1 About Cartoview GeoNode and Cartoview Installation Guide Recommended Minimum System Requirements Windows Installation Pre Installation Geonode and Cartoview Installation Deployment for Production Windows Firewall Configuration Replace localhost with IP Address or Domain Name Linux/Ubuntu Installation Installation of multiple instances Tutorials For Users Cartoview Application Manager GeoNode Portal Integration with other third party applications For Developers Types of Cartoview Apps Cartoview Apps Development Package ESRI Web App Templates as Cartoview Apps Expose localhot to the Internet For Administrators GeoNode Administration CartoView Administration Django Administration Resources ODK Survey Arbiter Data Collection External References 87 i

4 ii

5 Welcome to CartoView. Cartoview is a web application store which enables the rapid deployment of easy-to-manage and easy-to-use Web Mapping Applications. CartoView extends GeoNode to deploy web apps. Developers can upload their mapping applications to Cartoview app store. Their apps will become immidiately available to all Cartoview deployments. GeoNode users will start using Cartoview apps to author and publish their web mapping applications directly from the browser, without any programming. The documentation of the project is organized into the following sections: About Cartoview Installation Guide Tutorials Resources External References Contents 1

6 2 Contents

7 CHAPTER 1 About Cartoview Cartoview is a web platform which enables the rapid deployment of easy-to-manage and easy-to-use Web Mapping Applications. A simple windows installer will provide both Geonode and Cartoview for your windows server. Download the installer from Cartologic s Site 1.1 GeoNode and Cartoview GeoNode is an Open Source, Content Management System (CMS) for geospatial data. It is a web-based application and platform for developing geospatial information systems (GIS) and for deploying spatial data infrastructures (SDI). CartoView extends GeoNode to provide the ability to create, share, and visualize GIS Web Mapping Applications. Cartoview enables communities of users to share geospatial applications, to collaborate on these applications and to exchange the underlying data as Open Geospatial Consortium (OGC) compliant web services. CartoView has been built utilizing open source software and open standards to make it available for all GIS operators and to maximize interoperability.cartoview expands GeoNode to enable, publishing and authoring GIS web applications. CartoView is developed and maintained by CartoLogic 3

8 4 Chapter 1. About Cartoview

9 CHAPTER 2 Installation Guide The following is a guide to get Geonode and Cartoview up and running in most common operating systems (Windows, Linux/Ubuntu). 2.1 Recommended Minimum System Requirements For the deployment of Geonode and Cartoview on a single server, please find the bare minimum system requirements in Geonode s Documentation. 2.2 Windows Installation Pre Installation 1. Download and Install PostgreSQL and PostGIS. Note: Cartoview requires PostgreSQL and PostGIS release 9.3 or later to be installed. If they are already installed on your system, please proceed to Java Installation. Download the installer of PostgreSQL from EnterpriseDB. Recommended release is 9.3 or later 32 bits or 64 bits. Please choose the one that is compatible with your system. The installation process is straight forward. Just run the downloaded installer, follow the wizard instructions and accept all the default parameters. Specify the installation folder Specify the installation data folder Specify the database administrator password Note: Keep this password safe because we will need it later during the installation of PostGIS. Accept the default port (5432) and click the Next button. Accept the default locals and click the Next button Proceed with the installation, click the Next button 5

10 Fig. 2.1: Download PostgreSQL Fig. 2.2: Install PostgreSQL 6 Chapter 2. Installation Guide

11 2.2. Windows Installation 7

12 8 Chapter 2. Installation Guide

13 2.2. Windows Installation 9

14 When you reach this point the installation of PostgreSQL is completed. Please make sure that the Stack Builder check box is checked and click Finish to proceed with the installation of PostGIS. Fig. 2.3: PostgreSQL installation completed Select PostgreSQL 9.4(x64) on port 5432 from the combo box and click Next. Expand the category Spatial Extensions, select and check the PostGIS 2.2 item from the list, choose the one which is compatible with your system (32 bits or 64 bits). Review your selection and choose a download directory, then click the Next button to begin downloading PostGIS installer. The following dialog will indicate that the downloading of PostGIS installer finished successfully. Click Next to start installing PostGIS. Review the license terms and if you accept them, click on the I Agree button to continue with the installation of PostGIS. Create spatial database is optional, however it is recommended. Specify the PostgreSQL installation location in which PostGIS will be installed. Provide the PostgreSQL connection information (The one you saved in previous step). Specify the name of the spatial database to be created at the end of the installation process. Accept the default is recommended. Just click on the Yes button. Just click on the Yes button. Just click on the Yes button. PostGIS setup was competed successfully. Just click on the Close button to return to the Stack Builder. 10 Chapter 2. Installation Guide

15 2.2. Windows Installation 11

16 12 Chapter 2. Installation Guide

17 2.2. Windows Installation 13

18 14 Chapter 2. Installation Guide

19 2.2. Windows Installation 15

20 16 Chapter 2. Installation Guide

21 Installation of PostgreSQL database and PostGIS spatial extension has been completed successfully. Just click on the Finish button to complete the installation process. Note: Verify that your Postgres and PostGIS is running using pgadminiii. 2. Download and install the latest release of Java Runtime 64-Bit from Oracle Note: Cartoview requires Java runtime 64-Bit release 7 or later to be installed. If it is already installed on your system, please proceed to Cartoview Installation. Important: Now you are ready to proceed with the installation of Geonode and Cartoview. 2.3 Geonode and Cartoview Installation Note: This installer contains Geonode 2.4 and Cartoview Cartoview has been tested with PostGIS 2.1 and Geonode 2.4 Download the latest release of Geonode_Cartoview Installer from Cartologic. The installation process is straight forward. Just run the downloaded installer and follow the wizard instructions. Accepting the defaults is strongly recommented. Specify the PostgreSQL installation folder. Provide PostgreSQL connection information Geonode and Cartoview Installation 17

22 Fig. 2.4: Java Runtime installer download page Fig. 2.5: Java Runtime installation wizard A few brief dialogs confirm the last steps of the installation process. Click Close on the last dialog and this will complete Java installation process. 18 Chapter 2. Installation Guide

23 Fig. 2.6: Java Runtime installation completed 2.3. Geonode and Cartoview Installation 19

24 20 Chapter 2. Installation Guide

25 Provide the Geonode database name. This database will host information related to the Geonode website e.g. users, permissions etc. Provide the GIS database name. This database will host the GIS data. Specify installation folder for Geonode_Cartoview, however accepting the default is recommended. Provide start menu folder name, however accepting the default is again recommended. Setup is ready to install Geonode and Cartoview on your machine. Just click the Install button and be patient! Setup has finished installing Geonode and Cartoview on your computer. Just click the Finish button to launch the home page in your browser. Congratulations! You have successfully installed Geonode and Cartoview on your machine. This is the Admin Configuration page. Click the Start Geonode button to launch the Geonode and Cartoview home page. Sign in as admin/admin and start enjoying the experience of Geonode and Cartoview on Windows platform. Upload and style layers, create metadata, compose maps, share layers and maps with others, create and install Apps using Cartoview etc. 2.4 Deployment for Production Danger: Make sure that you have changed the default admin passwords for Django, Apache, Tomcat and Geoserver before you expose your site to the web. All default passwords are listed at the admin page installed with Cartoview Deployment for Production 21

26 22 Chapter 2. Installation Guide

27 2.4. Deployment for Production 23

28 24 Chapter 2. Installation Guide

29 2.4. Deployment for Production 25

30 2.4.1 Windows Firewall Configuration Note: Cartoview is installed by default on localhost. In order to deploy Cartoview on your production server and make it accessible to other users, you will need to change the hostname and configure all necessary ports. Configure Windows Firewall Create a new Inbound Rule to group the configuration of the necessary ports needed for the installed software. Initially, search and launch the Windows Firewall with Advanced Security tool and click on the New Rule button. Select Port as the type of Firewall Rule to be applied and click Next. Specify the protocol and ports to which the rule applies and click Next. Tip: Software Port Geonode 4040 GeoServer 4041 PostgreSQL 5432 SSL 555 Specify the action to be taken when a connection matches the conditions specified in the rule and click Next. (Allow the connection) 26 Chapter 2. Installation Guide

31 2.4. Deployment for Production 27

32 28 Chapter 2. Installation Guide

33 2.4. Deployment for Production 29

34 Specify the profiles for which this rule applies. Accepting the defaults is recommended. Finally click Next to proceed to the next step. (All the options checked). Specify the name and description of this rule and click Finish to complete the process. 2.5 Replace localhost with IP Address or Domain Name 1. Apache 2.4 Open the Apache configuration file..\goenode\apache24\conf\httpd.conf. Replace localhost with IP Address or Domain Name only for the highlighted lines. 1 WSGIPassAuthorization On 2 WSGIPythonHome "C:/Program Files (x86)/geonode/python" 3 4 <Proxy *> 5 Order allow,deny 6 Allow from all 7 </Proxy> 8 9 ProxyRequests Off 10 ProxyPreserveHost On ProxyPass /geoserver max=200 ttl=120 retry= Chapter 2. Installation Guide

35 2.5. Replace localhost with IP Address or Domain Name 31

36 13 14 ProxyPassReverse /geoserver 2. Geonode 2.4 Open the Geonode configuration file..\geonode\geonode\geonode\local_settings.py Replace localhost with IP Address or Domain Name only for the highlighted lines. 1 SITEURL = " 2 3 OGC_SERVER = { 4 'default' : { 5 'BACKEND' : 'geonode.geoserver', 6 'LOCATION' : ' 7 'PUBLIC_LOCATION' : ' 8 'USER' : 'admin', 9 'PASSWORD' : 'geoserver', 10 'MAPFISH_PRINT_ENABLED' : True, 11 'PRINT_NG_ENABLED' : True, 12 'GEONODE_SECURITY_ENABLED' : True, 13 'GEOGIG_ENABLED' : False, 14 'WMST_ENABLED' : False, 15 'BACKEND_WRITE_ENABLED': True, 16 'WPS_ENABLED' : False, 17 'LOG_FILE': '%s/geoserver/data/logs/geoserver.log' % os.path.abspath(os.path.join(projec 18 # Set to name of database in DATABASES dictionary to enable 19 'DATASTORE': 'datastore', 20 } 21 } 3. Tomcat 8.0 Open the Tomcat Geoserver configuration file..\geonode\tomcat 8.0\webapps\geoserver\WEB-INF\web.xml Replace localhost with IP Address or Domain Name for the highlighted line. 1 <context-param> 2 <param-name>geonode_base_url</param-name> 3 <param-value> 4 </context-param> Open the Tomcat Geoserver configuration file..\geonode\tomcat 8.0\webapps\geoserver\data\security\auth\geonodeAuthProvider\config.xml Replace localhost with IP Address or Domain Name for the highlighted line. 1 <org.geonode.security.geonodeauthproviderconfig> 2 <id>-54fbcd7b:1402c24f6bc:-7fe9</id> 3 <name>geonodeauthprovider</name> 4 <classname>org.geonode.security.geonodeauthenticationprovider</classname> 5 <baseurl> 6 </org.geonode.security.geonodeauthproviderconfig> 4. Restart Services Restart the Windows services GEONODE_APACHE_4040 GEONODE_TOMCAT_ Chapter 2. Installation Guide

37 5. Geoserver Launch Geoserver s home page at Login as admin/geoserver Click on Global button Define the Proxy Base URL parameter as: Linux/Ubuntu Installation Follow Geonode instructions for installing Geonode on your Ubuntu machine. Get Cartoview code from GitHub and install it as Django App in the Geonode project. 2.7 Installation of multiple instances Documentation not available yet! 2.6. Linux/Ubuntu Installation 33

38 34 Chapter 2. Installation Guide

39 CHAPTER 3 Tutorials The tutorials are based around performing tasks within the GeoNode and Cartoview platform, like registering new users, uploading layers and documents, creating, authoring and publishing maps. Additional tasks and processes related to the Cartoview Application Manager, like downloading, installing, authoring and launching Web Mapping Apps, are also extensively covered. The tutorials are written in a workshop like format and are organized into three sections targeting the groups of Users, Administrators and Developers. For Users For Developers For Administrators 3.1 For Users Welcome to the GeoNode and Cartoview Users Training documentation. This workshop will guide you on how to use the GeoNode and Cartoview platform, go in depth into what we can achieve with the platform and how to integrate it with third-party software. At the end of this section you will master many of the GeoNode and Cartoview tasks from the perspective of the user Cartoview Application Manager What is Cartoview Cartoview is a web platform which enables the rapid deployment of easy-to-manage and easy-to-use Web Mapping Applications. It is an expansion of the well-known GeoNode platform and it s all about installing, authoring and utilizing Web Mapping Applications within this platform. It integrates with the GeoNode Project to extend the platform and provide users with the experience of using Web Mapping Applications along with their Layers, Maps and Documents. It makes extensive use of the infrastructure, security and management tools of GeoNode in order to solve user problems and challenges. It enables user to apply workflows on data management and maintenance of their content (e.g. layers, maps and documents). It offers functionality to install, uninstall, author and manage Web Mapping Apps. Furthermore, it enables user to create App instances for specific business requirements utilizing the layers, maps, documents, users and groups which are available within the framework of GeoNode. Where to find Cartoview apps A number of Cartoview Apps has been developed by Cartologic and are freely available for download at Cartoview App Center. However if you are a developer and you are interested in joining this effort, feel free to download and 35

40 install Cartoview from here and start developing your own apps. We even encourage you to submit your Apps at Cartologic and after a review process, code cleaning and approval they will be available to the community. Cartoview Apps Panel Click on the Apps link to launch the Cartoview Apps Panel. This is the home page of Cartoview. From here you can launch the installed apps, install new apps, create app instances, manage the apps etc. Note: It is required to sign in with an administrator account in order to perform Cartoview Apps management tasks. Cartoview Apps Manager Click on the Manage Apps button in the upper right corner of the page. This will launch the Cartoview Apps Manager where you can install new apps, uninstall or suspend existing, edit the apps launcher or download apps from the App Market. Cartoview Apps Download Click on the Cartoview Apps button on the upper right corner of the page to launch the Cartoview Apps Market where you can download apps. Select the App that you want and hit the Download button to start download. Make sure that you take a note where this will be saved on your local disk. The app is packaged into a zip file and the Cartoview installer is capable enough to unpack and install it. 36 Chapter 3. Tutorials

41 3.1. For Users 37

42 Cartoview Apps Installation Click on the Install new Apps button on the upper left corner of the Cartoview Apps Manager. Click on the Choose file button, navigate to the App.zip file and select it. Click the Install button and wait for the installer to complete the installation and redirect to the Cartoview Apps Manager. Once done, the newly installed App should appear at the bottom of the Apps list. Cartoview Apps Launcher Click on the Edit App Launcher and change the order of the Apps as they are sorted on the Cartoview Apps Manager list. Drag and drop the apps in the preferred order and click the Save Changes button at the bottom of the dialog box. Create new App Instance From the Cartoview Apps Manager select an App and click on the Create new button. Fill the parameter form, select required maps and layers and finally click the Save button at the bottom of the page to save the new instance. 38 Chapter 3. Tutorials

43 3.1. For Users 39

44 Explore App Instances From the Cartoview Apps Manager select an App and click on the Explore button. A list of the App instances created based on this App will appear. Click on any instance to launch the App Instance Explorer page. On the App Instance Explorer page the user can Share, Rate and Comment on the App Instance, while it is possible to navigate back to the App Instance parameter form and modify the initial parameters if needed. Additionally, the App instance permissions can be changed from this page. Launch Application Finally, click on the Launch Application button in the upper right corner, to launch the application and enjoy the experience. Make use of the available functionality, like zooming, panning, identifying or searching for specific geographical feature or location. 40 Chapter 3. Tutorials

45 3.1. For Users 41

46 3.1.2 GeoNode Portal Geonode Introduction What is GeoNode? GeoNode is a geospatial content management system, a platform for the management and publication of geospatial data. It brings together mature and stable open-source software projects under a consistent and easy-to-use interface allowing non-specialized users to share data and create interactive maps. Data management tools built into GeoNode allow for integrated creation of data, metadata, and map visualizations. Each dataset in the system can be shared publicly or restricted to allow access to only specific users. Social features like user profiles and commenting and rating systems allow for the development of communities around each platform to facilitate the use, management, and quality control of the data the GeoNode instance contains. It is also designed to be a flexible platform that software developers can extend, modify or integrate against to meet requirements in their own applications. A tour of GeoNode In order to get started, let s look at the GeoNode interface and get a feel on how to navigate around. The GeoNode web interface is the primary method of interacting with GeoNode as a user. From this interface, one can view and modify existing spatial layers and maps, as well as find information on other GeoNode users. 42 Chapter 3. Tutorials

47 Without being logged in, you are limited to read-only access of public layers. 1. Navigate to you your GeoNode instance, available here: Fig. 3.1: Welcome page This page shows a variety of information about the current GeoNode instance. At the top of the page, a toolbar exists showing quick links to view layers, maps, documents (metadata), people ADD LINK, and a search field. Below this is a listing of recently updated layers, including abstract, owner, rating, and download button (if available). 2. Click the Layers link in the toolbar to go to the Explore Layers page. This page shows all layers known to GeoNode, available in either List or Grid viewing. Layers can be sorted by Most Recent, Most Popular, or Most Shared. Also available are a list of categories, with which layers can be connected with. 3. Find a layer and click on its name. 4. A layer viewing page will display, with the layer itself superimposed on a hosted base layer (in this case MapQuest OpenStreetMap). Explore this page, noting the various options available to you. 5. Now click the Maps link in the tool bar to go to the Explore Maps page. This page shows all maps known to GeoNode, available with similar viewing options as with the layers. 6. Type San Andres in the Search Box at the top of the page and hit Enter. This page contains a wealth of options for customizing a search for various information on this GeoNode instance. While a simple search box is available at the top of every page, this search from allows for much more fine-tuned searches For Users 43

48 Fig. 3.2: Explore Layers page 44 Chapter 3. Tutorials

49 Fig. 3.3: Viewing a layer 3.1. For Users 45

50 Fig. 3.4: Explore Maps page 46 Chapter 3. Tutorials

51 Fig. 3.5: Search results 3.1. For Users 47

52 Now that you are familiar with the basic interface, the next step is to create your own account so you manage some GeoNode resources of your own. Accounts and users GeoNode is primarily a social platform, and thus a primary component of any GeoNode instance is the user account. This section will guide you through account registration, updating your account information, and viewing other user accounts. Creating a new account Before you can save or edit any layers on a GeoNode instance, you need to create an account. 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. Fig. 3.6: Sign in screen 2. On the next page, fill out the form. Enter a user name and password in the fields. Also, enter your address for verification. 3. You will be returned to the welcome page. An 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 Click Confirm. You will be returned to the homepage. Managing your profile Your profile contains personal information. 1. Click on your user name in the top right of the screen. A drop-down list will show. Click on Profile to enter the Profile settings page. 2. The next page shows your profile, which is currently empty. 3. Click the Edit profile information link. 48 Chapter 3. Tutorials

53 Fig. 3.7: Registering for a new account Fig. 3.8: Confirming your address 3.1. For Users 49

54 Fig. 3.9: Link to your profile Fig. 3.10: Profile page 50 Chapter 3. Tutorials

55 Fig. 3.11: Link to edit your profile 4. On this page, your personal information can be set, including your avatar. Enter some details in the Profile box as well as your city and country info. Fig. 3.12: Editing your profile 5. When finished, click Update profile. 6. From the profile page you can also change your password. Just click on the Change Password link and the relevant form will appear. 7. When finished, click Change my Password to save changes and return to the profile page. Viewing other user accounts 1. Now that your account is created, you can view other accounts on the system. To see information about other users on the system, click the People link on the top toolbar. You will see a list of users registered on this system. 2. Click on the user name for a particular user. You will see the user s profile For Users 51

56 Fig. 3.13: Link to save your profile updates Fig. 3.14: Change password Fig. 3.15: List of users 52 Chapter 3. Tutorials

57 Fig. 3.16: User profile 1. You can also click Activities to see the activity feed. Fig. 3.17: List of users 2. Click the Layers tab at the bottom of the page to preview layers uploaded by this user. 1. You can also click the Maps tab to preview maps owned by this user. 1. Finally, you can click the Documents tab to preview documents owned by this user For Users 53

58 Fig. 3.18: List of layers owned by a user Fig. 3.19: List of maps owned by a user 54 Chapter 3. Tutorials

59 Fig. 3.20: List of documents owned by a user Managing Layers After user accounts, the next primary component of GeoNode is the layer. Layers are a published resource representing a raster or vector spatial data source. Layers also can be associated with metadata, ratings, and comments. In this section, you will learn how to create a new layer by uploading a local data set, add layer info, change the style of the layer, and share the results. Uploading a layer Now that we have taken a tour of GeoNode and viewed existing layers, the next step is to upload our own. In your data pack is a directory called data. Inside that directory is a shapefile called san_andres_y_providencia_administrative.shp. This is a data set containing... This will be the first layer that we will upload to GeoNode. 1. Navigate to the GeoNode welcome page. 2. Click the Layers link on the top toolbar. This will bring up the Layers menu. Fig. 3.21: Main toolbar for GeoNode 3. Click Upload Layers in the Layers toolbar. This will bring up the upload form 4. Fill out the form. Click the Choose Files button. This will bring up a local file dialog. Navigate to your data folder and select the san_andres_y_providencia_administrative.* files For Users 55

60 Fig. 3.22: Layers menu Fig. 3.23: Layers toolbar 56 Chapter 3. Tutorials

61 Fig. 3.24: Upload Layers form 3.1. For Users 57

62 Fig. 3.25: Files ready for upload 58 Chapter 3. Tutorials

63 5. GeoNode has the ability to restrict who can view, edit, and manage layers. On the right side of the page, under Who can view and download this data, select Any registered user. This will ensure that anonymous view access is disabled. 6. 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. Fig. 3.26: Permissions for new layer 7. Click Upload to upload the data and create a layer. A dialog will display showing the progress of the upload. Your layer has been uploaded to GeoNode. Layer information After upload, click Edit Metadata to update metadata about the layer. Change any information as desired, and then click Update at the very bottom of the form. After the update, the layer will display in a preview window. This page contains lots of options for managing this layer. Let s look at a few of them: 3.1. For Users 59

64 Fig. 3.27: Upload in progress 60 Chapter 3. Tutorials

65 Fig. 3.28: Layer metadata 3.1. For Users 61

66 Fig. 3.29: Layer preview 62 Chapter 3. Tutorials

67 Downloads At the top right corner of the page there are two buttons titled Download Layer and Download Metadata. These buttons provide access to the ability to extract geospatial data and metadata from within GeoNode. In this way, GeoNode allows for two way data access; one can import as well as export data. 1. Click the Download Layer button. You will see a list of options of the supported export formats. 1. Click the option for Zipped Shapefile. Fig. 3.30: Available export formats 2. GeoNode will process the request and bring up a Save As dialog. Save this file to your computer, and note how it is the same content as was uploaded. Metadata 1. Scroll down the page toward the bottom. Five tabs are available: Info, Attributes, Share, Ratings, and Comments. The info tab is already highlighted, and presents basic information about the layer, of the kind that was seen on the layer list page. 2. Click the Attributes tab. This lists the attributes of the layer, including statistics such as mean and standard deviation (where applicable). 3. Click the Ratings tab. This tab allows you (and others viewing this page) to rate this layer. Ratings can be based on quality, accuracy, or any other metric. Click on the appropriate star to rate this layer. 4. Click the Comments tab. This tab allows you to leave a comment for other viewing this layer For Users 63

68 Fig. 3.31: Layer Info tab Fig. 3.32: Layer Ratings tab 64 Chapter 3. Tutorials

69 Fig. 3.33: Layer Comments tab 5. Click the Add Comment button and enter a comment. Fig. 3.34: Adding a new comment 6. When finished, click Submit Comments Sharing layers GeoNode has the ability to restrict or allow other users to access a layer. Anonymous access 1. Go to the layer preview of the first layer uploaded, and copy the URL to that preview page For Users 65

70 Fig. 3.35: New comment posted Note: The URL should be something like: 2. Now log out of GeoNode by clicking on your profile name and selecting Log out. 3. Now paste the URL copied about into your browser address bar and navigate to that location. 4. You should be redirected to the login page. This is because when this layer was first uploaded, we set the view properties to be any registered user. Once logged out, we are no logner a registered user and so are not able to see or interact with the layer. Sharing with other users Adding more layers We ve uploaded one layer so far. There is one more layer in the data directory associated with this workshop called san_andres_y_providencia_poi.shp. 1. Upload this layer, referring to the directions on uploading a layer. As a difference, leave the permissions set to their default values. Managing Maps The next primary component of GeoNode is the map. Maps are comprised of various layers and their styles. The Layers can be either local, served by the local GeoServer or remote, served by other map service providers such as Open Street Map, Google, Bing or MapQuest. The GeoNode Map viewer provides tools for map navigation, layers management, ordering and styling, identifying features, etc. In this section, we will create a map based on the layers uploaded in the previous section, combine them with some existing layers and a remote web service layer, and then share the resulted map for public viewing. Creating a map Adding layers 66 Chapter 3. Tutorials

71 Fig. 3.36: Log out 3.1. For Users 67

72 Fig. 3.37: Unable to view this protected layer 68 Chapter 3. Tutorials

73 Fig. 3.38: Uploading the layer 3.1. For Users 69

74 Fig. 3.39: Finished upload 70 Chapter 3. Tutorials

75 1. Click the Maps link on the top toolbar. This will bring up the list of maps. Fig. 3.40: Maps page 2. Click the Create a New Map button to launch the map composition interface. In this interface there is a toolbar, layer list, and map window. The map window contains the MapQuest Open- StreetMap 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. 4. Select all of the San Andreas layers by clicking the top entry and Shift-clicking the bottom one. Click Add Layers to add them all to the map. Note: This selection includes not only the two layers uploaded in the previous section, but also the layers that were already hosted on GeoNode at the beginning of the workshop. 5. 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. Saving the map 1. While we still have some work to do on our map, let s save it so that we can come back to it later. Click on the Map button in the toolbar, and select Save Map. 2. Enter a title and abstract for your map For Users 71

76 Fig. 3.41: Create maps interface Fig. 3.42: Add layers link 72 Chapter 3. Tutorials

77 Fig. 3.43: Selecting layers 3.1. For Users 73

78 Fig. 3.44: Layers added to the map 74 Chapter 3. Tutorials

79 Fig. 3.45: Save map link 3.1. For Users 75

80 Fig. 3.46: Save map dialog 76 Chapter 3. Tutorials

81 3. Click Save. Notice that the link on the top right of the page changed to reflect the map s name. Fig. 3.47: Saved map name 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. Styling layers In this interface, we can pause in our map creation and change the style of one of our uploaded layers. GeoNode allows you to edit layer styles graphically, without the need to resort to programming or requiring a technical background. We ll be editing the san_andres_y_providencia_poi layer. 1. In the layer list, uncheck all of the layers except the above, so that only this one is visible (not including the base layer). 2. Zoom in closer using the toolbar or the mouse. 3. In the layer list, click to select the remaining layer and then click the palette icon (Layer Styles). This will bring up the style manager. 4. This layer has one style (named the same as the layer) and one rule in that style. Click the rule (Untitled 1) to select it, and then click on Edit below it. 5. Edit the style. You can choose from simple shapes, add labels, and even adjust the look of the points based on attribute values and scale. 6. When done, click Save, then click on the word Layers to return to the layer list For Users 77

82 Fig. 3.48: Only one layer visible Fig. 3.49: Zoomed in to see the layer better 78 Chapter 3. Tutorials

83 Fig. 3.50: Styles manager Fig. 3.51: Edit style rule link 3.1. For Users 79

84 Fig. 3.52: Editing basic style rules Fig. 3.53: Editing style labels 80 Chapter 3. Tutorials

85 Fig. 3.54: Styled layer Share your map Now let s finish our map. 1. Check the box next to the highway layer to activate it. If it is not below the POI layer in the list, click and drag it down. 2. Make any final adjustments to the map composition as desired, including zoom and pan settings. 3. Click the Map button in the toolbar, and then click Publish Map. 4. The title and abstract as previously created should still be there. Make any adjustments as necessary, and click Save. 5. A new dialog will appear with instructions on how to embed this map in a webpage, including a code snippet. You can adjust the parameters as necessary. Your map can now be shared Integration with other third party applications Using GeoNode and Cartoview with other applications Note: This documentation is kindly provided to the community by the GeoNode Team For Users 81

86 Fig. 3.55: Adjusting map composition Fig. 3.56: Publish map link Fig. 3.57: Map publishing options 82 Chapter 3. Tutorials

87 3.2 For Developers Cartoview for Developers documentation Types of Cartoview Apps Documentation not ready yet. 1. Single Apps Documentation not ready yet. 2. Multinstance Apps Documentation not ready yet Cartoview Apps Development Documentation not ready yet Package ESRI Web App Templates as Cartoview Apps Documentation not ready yet Expose localhot to the Internet Use ngrok to expose local web developent server to the internet. ngrok is a reverse proxy that creates a secure tunnel from a public endpoint to a locally running web service. ngrok captures and analyzes all traffic over the tunnel for later inspection and replay. For more information visit GitHub 3.3 For Administrators Documentation related to Cartoview for Administrators GeoNode Administration Documentation not ready yet CartoView Administration Documentation not ready yet Django Administration Documentation not ready yet For Developers 83

88 84 Chapter 3. Tutorials

89 CHAPTER 4 Resources 4.1 ODK Survey Configure GIS data collection applications to create surveys by using ODK with Cartoview and GeoNode. More details for ODK 4.2 Arbiter Data Collection Configure maintenance and data collection applications by using Arbiter with Cartoview and GeoNode. More details for Arbiter 85

90 86 Chapter 4. Resources

91 CHAPTER 5 External References GeoNode Training GeoNode Documentation 87