This tutorial will show the basic uses of Composer. In this tutorial you will:
The final step, styling the map, is covered in the separate Web map styling with YSLD.
While any data can be substituted when following along with this tutorial, the following data will specifically be shown, all from the Natural Earth dataset:
Also download the following file, originally taken from the Natural Earth III extra data:
Creating a new project workspace¶
The first step in making a map with Composer is to create a project workspace. The project workspace will contain all of the data, layers, and the map, separating them from the rest of the resources in Composer.
First, log in to Composer with your administrator credentials.
The default GeoServer administrator credentials are
Click the New link and select New Project Workspace.
Enter the details of the project workspace:
- Project Name:
When finished, click Create.
- Project Name:
You will see a dialog saying Workspace tutorial created and then you will be taken to the Maps tab of the project workspace.
Adding data and publishing layers¶
With the project workspace created, we’re now ready to load data.
Click the Add Data link at the top right of the page.
A dialog will appear for importing data to GeoServer. Either click Browse and select each of the files, or drag each of the files onto this dialog.
Click Upload to upload the files to GeoServer.
After the upload is complete click Next: Load to review file contents. Select all of the resources and click Import Selected Layers.
Imported layers can be added to an existing map or used to create a new map. Click Close.
When finished with uploads, click Close to close out of the import wizard. You will see the two data sources listed on the Data tab: A directory of shapefiles containing the three shapefile resources, and a raster data source containing the DEM resource. Note specifically that for each data store, the resource is marked as Published.
Click the Layers tab to see the published resources.
Find the ne_10m_roads layer and click the Settings button. This will bring up the layer settings.
Change the layer settings to the following:
When finished, click Update Layer Settings.
Repeat the process of changing layer settings for the other three layers. Use the following information:
View each of the layers by clicking the Style button for each layer.
Adding layers to a map¶
Now that our layers are loaded into Composer, we will now compile them into a single map.
Return to the tutorial project workspace.
Click New Map.
Fill out the form with the following settings:
- Map Name:
Composer / YSLD tutorial map
- Map Name:
Click Add Layers.
Select the four layers by checking the box next to each one, and then click Create Map with Selected.
The map will be created. Click the icon for the map to bring up the Style Editor.
In the layer list in the middle of the screen, drag the layers so that they are listed in the following order:
With the map created, the next step is to improve the styling. Please continue on at the YSLD tutorial to see how these layers can be styled.