Difference between revisions of "Developing a Web Map Server Using GeoServer"

From CUOSGwiki
Jump to navigationJump to search
 
(26 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
=Introduction:=
  
=Introduction:=
−
This is a quick and dirty guide to getting Geoserver up running and displaying data, if you wish for a more detailed and in depth tutorial go to the geoserver manual [http://docs.geoserver.org/latest/en/user/index.html]. Geoserver is a free, opensource WMS tool that allows users to upload data to a server and then serve it out to other users. The purpose of this tutorial is to show the user how to start, run, upload data, style their map, and serve it to other users.
 +
This is simple guide to getting GeoServer running on your computer and displaying data. If you wish for a more detailed and in depth tutorial go to the GeoServer manual [http://docs.geoserver.org/latest/en/user/index.html]. GeoServer is a free, open source web mapping service (WMS) tool for users to upload data and display to other users. The purpose of this tutorial is to show the user how to start, run, upload data, style their map, and serve it to other users. Before you begin your installation of GeoServer, make sure you have an updated JRE/JDK. [https://adoptium.net/]
   
−
=Setting Up and Using Geoserver:=
 +
=Setting Up and Using GeoServer:=
   
−
Installing Geoserver:
 +
Installing GeoServer:
−
* Geoserver can be downloaded from the following link [http://geoserver.org/display/GEOS/Download]
 +
* GeoServer can be downloaded from the following link [https://geoserver.org/]
  +
* Under "Download" select the 2.21.1 "Stable" option.
−
* Follow along with the instillation wizard, and install geoserver in your chosen directory.
 
  +
* Once redirected, select "Windows Installer" (for Windows computer) in "Packages." This will automatically start the download.
⚫
* Make sure to download the manual for geoserver from the following link [http://docs.geoserver.org/stable/en/user/]
  
−
* Once the installation wizard has completed you can now run geoserver.
 +
* Follow along with the installation wizard, and install GeoServer in your chosen directory.
  ⚫
* Make sure to download the manual for GeoServer from the following link [http://docs.geoserver.org/stable/en/user/]
  +
* Once the installation wizard has completed, you can now run GeoServer.
   
−
''Note: It is recommended that you install geoserver on its own machine or within a virtual machine. This will make sure that nothing conflicts with it, and give the software more space to run.''
+
''Note: It is recommended that you install GeoServer on its own machine or within a virtual machine. This will make sure that nothing conflicts with it, and give the software more space to run.''
   
−
Starting Geoserver:
 +
Starting GeoServer:
   
−
To run geoserver, navigate to the bin folder in whatever directory you installed geoserver, and click on the startup icon. This will launch a command prompt showing diagnostic information, now that the command prompt has appeared you can access the server. Open your preferred browser and go to http://localhost:8080/geoserver/web, this will take you to the geoserver web administration page. There will be a login option at the top right had side of the page, if you set up a unique username and password during the installation enter it there, if not use the default admin as the username and geoserver as the password. This will bring you to your homepage, where you have access to all of geoservers functions and where all of your data is stored.
 +
To run GeoServer, navigate to the bin folder in whatever directory you installed the software, and click on the startup icon. This will launch a command prompt showing diagnostic information, now that the command prompt has appeared you can access the server. Open your preferred browser and go to http://localhost:8080/geoserver/web, this will take you to the GeoServer web administration page. There will be a login option at the top right had side of the page, if you set up a unique username and password during the installation enter it there, if not use the default admin as the username and geoserver as the password. This will bring you to your homepage, where you have access to all of GeoServer's functions and where all of your data is stored.
   
 
[[File:WebAdminHOme.png|750px]]
  
[[File:WebAdminHOme.png|750px]]
Line 20: Line 22:
 
'' Figure 1: The web administration home page once you have logged into geoserver. ''
  
'' Figure 1: The web administration home page once you have logged into geoserver. ''
   
−
=Adding Data To Geoserver:=
 +
=Adding Data To GeoServer:=
   
 
In this case all data was downloaded from Geobase.ca [http://www.geobase.ca/geobase/en/search.do?produit=fed&language=en]
 
In this case all data was downloaded from Geobase.ca [http://www.geobase.ca/geobase/en/search.do?produit=fed&language=en]
   
−
To add data to geoserver the first thing that needs to be done is a new workspace needs to be created.
 +
To add data to GeoServer, you first need to create a new workspace.
  +
* Click on the “Create workspaces” option in the center of the page, or navigate to the left panel on the webpage and select “Workspaces” and then “Add new workspace.”
−
* First navigate to the workspace directory in geoserver(using the links at the side of the web administration page).
  
 
* Click the add a new workspace button in the top left hand corner.
  
* Click the add a new workspace button in the top left hand corner.
 
* Choose a unique workspace name and URI(make sure there are no spaces in the workspace name).
  
* Choose a unique workspace name and URI(make sure there are no spaces in the workspace name).
Line 31: Line 33:
   
 
[[File:Workspacecreation.png|750px]]
  
[[File:Workspacecreation.png|750px]]
−  
 
'' Figure 2: The workspace creation page. ''
  
'' Figure 2: The workspace creation page. ''
   
 
Now that the workspace has been created, a layer store must be created, which will allow the user to upload and publish a layer.
  
Now that the workspace has been created, a layer store must be created, which will allow the user to upload and publish a layer.
−
* First navigate to the stores directory(using the links at the side of the web administration page).
 +
* First navigate to the stores directory (using the links at the side of the web administration page).
 
* Click the add new store button in the top left hand corner.
  
* Click the add new store button in the top left hand corner.
−
* Chose your data source type, in this examples case it was a shapefile.
 +
* Chose your data source type, in this example it is a shapefile.
 
* Fill in your data's description and then navigate to the data that you wish to upload.
  
* Fill in your data's description and then navigate to the data that you wish to upload.
 
* Then hit the save button at the bottom of the page.
  
* Then hit the save button at the bottom of the page.
Line 45: Line 46:
 
'' Figure 3: The data store creation page. ''
  
'' Figure 3: The data store creation page. ''
   
−
Now that the data has been loaded to geoserver it has to be published. Once you have clicked save and your data store has been created, you will be brought to the new layer page. This page will show you the data that has been upload and give you the option to publish that data. Click on the publish tab this will bring you to the layer configuration page, once you have configured your data appropriately click the save data button and now your data has been published to geoserver. Once you have published your data navigate to the layer tab on the left hand side of the page, find your data and click preview to see your data.
 +
Now that the data has been loaded to GeoServer, it has to be published. Once you have clicked save and your data store has been created, you will be brought to the new layer page. This page will show you the data that has been uploaded and give you the option to publish that data. Click on the publish tab this will bring you to the layer configuration page, once you have configured your data appropriately click the save data button and now your data has been published to GeoServer. Once you have published your data, navigate to the layer tab on the left hand side of the page, find your data and click preview to see your data.
   
 
'' Notes ''
  
'' Notes ''
 
'' * Make sure that the SRS is force declared. ''
 
'' * Make sure that the SRS is force declared. ''
−
'' * Compute the bounding boxes by clicking on the compute from data and compute from native bounding boxs. ''
 +
'' * Compute the bounding boxes by clicking on the compute from data and compute from native bounding boxes. ''
   
 
[[File:Publish.png|750px]]
  
[[File:Publish.png|750px]]
Line 55: Line 56:
 
'' Figure 4: The data publishing page. ''
  
'' Figure 4: The data publishing page. ''
   
−
Now that you have added your data to the server, the next step in this process is to style it, so that when you request the map from the server it will have all the appropriate map elements. To add data go through the same process as described above, but make sure to change your data types.
 +
Now that you have added your data to the server, the next step in this process is to style it, so that when you request the map from the server it will have all the appropriate map elements. To add data, go through the same process as described above, but make sure to change your data types.
   
 
=Adding Style Elements:=
  
=Adding Style Elements:=
   
−
When styling in geoserver a language called Styled Layer Descriptor (SLD) is used, this is an XML based language. Styling is accomplished using an XML SLD Style Document. These documents reference specific layers on the geoserver and describe how they should be displayed. The XML SLD language is somewhat complex, so if the user has no experience using the language, just follow along with the Style Document example in Figure 5. More examples of SLD Style Documents can be found in the SLD cookbook. [http://docs.geoserver.org/stable/en/user/styling/sld-cookbook/index.html#sld-cookbook] The style documents are broken down into points, lines, polygons, rasters, and text each having their own styles.
 +
When styling in GeoServer, a language called Styled Layer Descriptor (SLD) is used; styling is accomplished using an XML-based SLD Style Document. These documents reference specific layers on the GeoServer data store and describe how they should be displayed. The XML SLD language is somewhat complex, so if the user has no experience using the language, just follow along with the Style Document example in Figure 5. More examples of SLD Style Documents can be found in the SLD cookbook. [https://docs.geoserver.org/latest/en/user/styling/sld/cookbook/index.html] The style documents are broken down into points, lines, polygons, rasters, and text.
   
 
To edit the style of a layer, the layers default style must be determined.
  
To edit the style of a layer, the layers default style must be determined.
 
* First navigate to the layers link on the left hand side of the web administration page.
  
* First navigate to the layers link on the left hand side of the web administration page.
−
* Click on the layer name, of the layer you wish to change the style.
 +
* Click on the layer name of the layer you wish to change the style.
 
* Click on the publishing tab in the edit layer page.
  
* Click on the publishing tab in the edit layer page.
 
* Scroll down to the default style under the WMS settings and it will tell you what the default style is.
  
* Scroll down to the default style under the WMS settings and it will tell you what the default style is.
Line 71: Line 72:
 
'' Figure 5: Showing the default style of the federal districts layer. ''
  
'' Figure 5: Showing the default style of the federal districts layer. ''
   
−
Now that the default style of the layer you wish to edit has been determined navigate down to the style link on the left hand side of the web administration page. Click on the style name as determined in figure 5, which was polygons, this will bring up the SLD code for this style. Now you can edit this SLD code to change how the layer looks.
 +
Now that the default style of the layer you wish to edit has been determined, navigate down to the style link on the left hand side of the web administration page. Click on the style name, as determined in Figure 5, which was polygons, this will bring up the SLD code for this style. Now you can edit this SLD code to change how the layer looks.
   
 
== Editing Existing Style Elements ==
  
== Editing Existing Style Elements ==
−
'' Note: This tutorial will focus only on editing polygon styles, for more style examples visit [http://docs.geoserver.org/stable/en/user/styling/sld-cookbook/index.html#sld-cookbook] ''
 +
'' Note: This tutorial will focus only on editing polygon styles, for more style examples visit [https://docs.geoserver.org/stable/en/user/styling/sld/cookbook/polygons.html] ''
   
 
One of the easiest things to do is to change the color of the polygons that you are editing. In this example the polygons will be changed from grey to a dark blue(#000080) color.
  
One of the easiest things to do is to change the color of the polygons that you are editing. In this example the polygons will be changed from grey to a dark blue(#000080) color.
Line 84: Line 85:
 
The color of the polygons was changed on line 24, <CssParameter name="fill">#000080</CssParameter>. This line determines the fill color for the polygons, it was changed from a grey, to a dark blue.
 
The color of the polygons was changed on line 24, <CssParameter name="fill">#000080</CssParameter>. This line determines the fill color for the polygons, it was changed from a grey, to a dark blue.
   
−
Once the color has been changed in the SLD code, click the validate button at the bottom of the page. This will make sure there are no errors in the code, if the code is good a message will appear at the top of the page. Once the code has been validated, go to the top of the page and in the workspace box choose your layer, and hit submit. Now the SLD code has been associated with your layer, you can go to the layer preview and look at the change in color.
 +
Once the color has been changed in the SLD code, click the validate button at the bottom of the page. This will make sure there are no errors in the code. If the code is good a message will appear at the top of the page. Once the code has been validated, go to the top of the page and in the workspace box and choose your layer, and hit submit. Now the SLD code has been associated with your layer, you can go to the layer preview and look at the change in color.
   
 
[[ File: LayerPreview.png|500px ]]
  
[[ File: LayerPreview.png|500px ]]
Line 90: Line 91:
 
'' Figure 7: Layer preview of the federal districts layer, with a dark blue color. ''
  
'' Figure 7: Layer preview of the federal districts layer, with a dark blue color. ''
   
−
Now that the color of the polygon has been changed, lets add labels to the polygons.
+
Now that the color of the polygon has been changed, let's add labels to the polygons.
   
 
[[File: Label.png|500px ]]
  
[[File: Label.png|500px ]]
Line 96: Line 97:
 
'' Figure 8: SLD code for adding labels to polygons. ''
 
'' Figure 8: SLD code for adding labels to polygons. ''
   
−
As can be seen in figure 8 the polygon labels are determined by the text symbolize from line 31 - 35. This section of code tell the server that there is a label that needs to be added to the polygons, and then through line 33 <ogc:PropertyName>ENNAME</ogc:PropertyName>, tells the server what attribute field from the layer to use as the labels. In this case it was ENNAME or English Names for federal electoral districts. At this point the color of the map was also changed to a lighter green using the code #40FF40 to make the labels easier to see.
 +
As can be seen in Figure 8, the polygon labels are determined by the text symbolization from line 31 - 35. This section of code tells the server that there is a label that needs to be added to the polygons, and then line 33 <ogc:PropertyName>ENNAME</ogc:PropertyName> tells the server what attribute field from the layer to use as the labels. In this case it was ENNAME, or English Names, for federal electoral districts. At this point the color of the map was also changed to a lighter green using the code #40FF40 to make the labels easier to see.
   
 
[[File: LabelPreview.png|500px]]
  
[[File: LabelPreview.png|500px]]
Line 104: Line 105:
 
==Get Legend Graphic==
  
==Get Legend Graphic==
   
−
The GetLegendGraphic is a requests that allows you to see the legend for a specific map that has been made. For example if I wanted to see the legend for the Federal Electoral Districts I would use the following url.
 +
The GetLegendGraphic is a request that allows you to see the legend for a specific map that has been made. For more imformation visit this GeoServer page. [https://docs.geoserver.org/stable/en/user/services/wms/get_legend_graphic/index.html] For example, if I wanted to see the legend for the Federal Electoral Districts I would use the following URL.
   
 
http://localhost:8080/geoserver/wms?REQUEST=GetLegendGraphic&VERSION=1.0.0&FORMAT=image/png&WIDTH=20&HEIGHT=20&LAYER=FED_CA_1_0_0_ENG
  
http://localhost:8080/geoserver/wms?REQUEST=GetLegendGraphic&VERSION=1.0.0&FORMAT=image/png&WIDTH=20&HEIGHT=20&LAYER=FED_CA_1_0_0_ENG
   
−
This url can be used to get the legend for any of the maps that you may have on geoserver, the only thing that will need to be changed is what is at the end of the link where it says Layer=, that will just have to be set to whatever layer the user wishes to see. As of this moment there is no easy way to get the legend to display on a users map when they use the GetMap fucntion, but the user can click on different features in the map and the server will display information about those features on the bottom on the map. For example if I click on one of the federal electoral districts, it would tell me which one, the size, things like that as long as all of that data is associated with the layer.
 +
This URL can be used to get the legend for any of the maps that you may have on GeoServer, the only thing that will need to be changed is what is at the end of the link where it says Layer=, that will just have to be set to whatever layer the user wishes to see. As of this moment, there is no easy way to get the legend to display on a user's map when they use the GetMap function, but the user can click on different features in the map and the server will display information about those features on the bottom on the map. For example, if I click on one of the federal electoral districts, it would tell me things like the district name, the size, etc., as long as all of that data is associated with the layer.
   
 
=Serving a Map=
  
=Serving a Map=
   
−
To serve a map using geoserver there are three basic tools that can be used. The first is the GetMap function which allows the user to call up maps. The WMS reflector which does pretty much the same thing as the GetMap function, but shortens it down making it easier to handle. The first two options can only be used on the IP address that you are running geoserver on. Finally there is the cascading WMS option which allows a user to access a map remotely.
 +
To serve a map using GeoServer there are three basic tools that can be used. The first is the GetMap function which allows the user to call up maps. The WMS reflector does pretty much the same thing as the GetMap function, but shortens it down, making it easier to handle. The first two options can only be used on the IP address that you are running GeoServer on. Finally there is the cascading WMS option which allows a user to access a map remotely.
   
 
==GetMap==
  
==GetMap==
Line 198: Line 199:
   
   
−
The below link would lead to a image showing the federal electoral districts from geoserver, with a width of 506 pixels, a height of 512 pixels, and in png format. This link can be modified to meet an get map request, make sure to change the layer name and remove the parentheses. This link will only work on the same network that you have geoserver on.
+
The below link would lead to a image showing the federal electoral districts from GeoServer, with a width of 506 pixels, a height of 512 pixels, and a png file format. This link can be modified to meet an get map request, make sure to change the layer name and remove the parentheses. This link will only work on the same computer that you have GeoServer on (i.e. the "localhost" address points the computer back to itself).
   
 
http://localhost:8080/geoserver/wms? (Normally used to get to the web administration page)
  
http://localhost:8080/geoserver/wms? (Normally used to get to the web administration page)
Line 204: Line 205:
 
&service=WMS (The service that has been requested)
  
&service=WMS (The service that has been requested)
   
−
&Version=1.1.0 (The version of geoserver that is being used)
 +
&Version=1.1.0 (The version of GeoServer that is being used)
   
 
request=GetMap (The operation that has been requested)
  
request=GetMap (The operation that has been requested)
Line 230: Line 231:
 
== WMS Reflector ==
  
== WMS Reflector ==
   
−
The WMS reflector is a function that shortens the GetMap request, so instead of typing the extremely long link above the user would type in a much shorter one.
 +
The WMS reflector is a function that shortens the GetMap request, so instead of typing the extremely long link above, the user would type in a much shorter one.
   
 
A reflect request of the above GetMap function would look like this.
  
A reflect request of the above GetMap function would look like this.
 
* http://localhost:8080/geoserver/wms/reflect?layers=FED_CA_1_0_0_ENG
  
* http://localhost:8080/geoserver/wms/reflect?layers=FED_CA_1_0_0_ENG
   
−
This will bring up the map of the federal electoral districts at a default width of 512 pixels. This method is much easier than typing in the long GetMap function but does takes away some of the control.
 +
This will bring up the map of the federal electoral districts at a default width of 512 pixels. This method is much easier than typing in the long GetMap function, but does takes away some of the control.
   
 
[[File: reflector.png|500px]]
  
[[File: reflector.png|500px]]
Line 243: Line 244:
 
== Serving your web map ==
  
== Serving your web map ==
   
−
Now that you are able to view your maps on geoserver on the local network it would be useful to be able to view map on a computer that is not on your home network. To serve maps that can be viewed beyond your own network, the user will need some sort of web server/web site that they can serve their maps out too.
 +
Now that you are able to view your maps using GeoServer on the local computer, it would be useful to be able to view map on a computer that is not on your home network. To serve maps that can be viewed beyond your own network, the user will need some sort of web server/web site that they can serve their maps out to.
   
 
=Conclusion=
  
=Conclusion=
   
−
Geoserver is an extremely useful tool for viewing spatial data over the web. This tutorial has taught you how to install, set up, add data, style your data, and finally serve it out. These are just basic functions of geoserver, for more information on geoserver and its capabilities read the geoserver manual.
 +
GeoServer is an extremely useful tool for viewing spatial data over the web. This tutorial has taught you how to install, set up, add data, style your data, and finally serve it out. These are just basic functions of GeoServer, for more information on GeoServer and its capabilities read the GeoServer manual.
   
 
=References=
  
=References=
   
−
Geoserver User Manual [http://docs.geoserver.org/stable/en/user/]
 +
GeoServer User Manual [http://docs.geoserver.org/stable/en/user/]
   
 
Geobase: Federal Electoral Districts [http://www.geobase.ca/geobase/en/data/admin/fed/description.html]
  
Geobase: Federal Electoral Districts [http://www.geobase.ca/geobase/en/data/admin/fed/description.html]
  +
  +
*

Latest revision as of 12:59, 11 October 2022

Introduction:

This is simple guide to getting GeoServer running on your computer and displaying data. If you wish for a more detailed and in depth tutorial go to the GeoServer manual [1]. GeoServer is a free, open source web mapping service (WMS) tool for users to upload data and display to other users. The purpose of this tutorial is to show the user how to start, run, upload data, style their map, and serve it to other users. Before you begin your installation of GeoServer, make sure you have an updated JRE/JDK. [2]

Setting Up and Using GeoServer:

Installing GeoServer:

  • GeoServer can be downloaded from the following link [3]
  • Under "Download" select the 2.21.1 "Stable" option.
  • Once redirected, select "Windows Installer" (for Windows computer) in "Packages." This will automatically start the download.
  • Follow along with the installation wizard, and install GeoServer in your chosen directory.
  • Make sure to download the manual for GeoServer from the following link [4]
  • Once the installation wizard has completed, you can now run GeoServer.

Note: It is recommended that you install GeoServer on its own machine or within a virtual machine. This will make sure that nothing conflicts with it, and give the software more space to run.

Starting GeoServer:

To run GeoServer, navigate to the bin folder in whatever directory you installed the software, and click on the startup icon. This will launch a command prompt showing diagnostic information, now that the command prompt has appeared you can access the server. Open your preferred browser and go to http://localhost:8080/geoserver/web, this will take you to the GeoServer web administration page. There will be a login option at the top right had side of the page, if you set up a unique username and password during the installation enter it there, if not use the default admin as the username and geoserver as the password. This will bring you to your homepage, where you have access to all of GeoServer's functions and where all of your data is stored.

WebAdminHOme.png

Figure 1: The web administration home page once you have logged into geoserver.

Adding Data To GeoServer:

In this case all data was downloaded from Geobase.ca [5]

To add data to GeoServer, you first need to create a new workspace.

  • Click on the “Create workspaces” option in the center of the page, or navigate to the left panel on the webpage and select “Workspaces” and then “Add new workspace.”
  • Click the add a new workspace button in the top left hand corner.
  • Choose a unique workspace name and URI(make sure there are no spaces in the workspace name).
  • Then hit the submit button.

Workspacecreation.png Figure 2: The workspace creation page.

Now that the workspace has been created, a layer store must be created, which will allow the user to upload and publish a layer.

  • First navigate to the stores directory (using the links at the side of the web administration page).
  • Click the add new store button in the top left hand corner.
  • Chose your data source type, in this example it is a shapefile.
  • Fill in your data's description and then navigate to the data that you wish to upload.
  • Then hit the save button at the bottom of the page.

DataStore.png

Figure 3: The data store creation page.

Now that the data has been loaded to GeoServer, it has to be published. Once you have clicked save and your data store has been created, you will be brought to the new layer page. This page will show you the data that has been uploaded and give you the option to publish that data. Click on the publish tab this will bring you to the layer configuration page, once you have configured your data appropriately click the save data button and now your data has been published to GeoServer. Once you have published your data, navigate to the layer tab on the left hand side of the page, find your data and click preview to see your data.

Notes * Make sure that the SRS is force declared. * Compute the bounding boxes by clicking on the compute from data and compute from native bounding boxes.

Publish.png

Figure 4: The data publishing page.

Now that you have added your data to the server, the next step in this process is to style it, so that when you request the map from the server it will have all the appropriate map elements. To add data, go through the same process as described above, but make sure to change your data types.

Adding Style Elements:

When styling in GeoServer, a language called Styled Layer Descriptor (SLD) is used; styling is accomplished using an XML-based SLD Style Document. These documents reference specific layers on the GeoServer data store and describe how they should be displayed. The XML SLD language is somewhat complex, so if the user has no experience using the language, just follow along with the Style Document example in Figure 5. More examples of SLD Style Documents can be found in the SLD cookbook. [6] The style documents are broken down into points, lines, polygons, rasters, and text.

To edit the style of a layer, the layers default style must be determined.

  • First navigate to the layers link on the left hand side of the web administration page.
  • Click on the layer name of the layer you wish to change the style.
  • Click on the publishing tab in the edit layer page.
  • Scroll down to the default style under the WMS settings and it will tell you what the default style is.

DefaultStyle.png

Figure 5: Showing the default style of the federal districts layer.

Now that the default style of the layer you wish to edit has been determined, navigate down to the style link on the left hand side of the web administration page. Click on the style name, as determined in Figure 5, which was polygons, this will bring up the SLD code for this style. Now you can edit this SLD code to change how the layer looks.

Editing Existing Style Elements

Note: This tutorial will focus only on editing polygon styles, for more style examples visit [7]

One of the easiest things to do is to change the color of the polygons that you are editing. In this example the polygons will be changed from grey to a dark blue(#000080) color.

DarkBlue.png

Figure 6: Example of SLD code, changing the color of a polygon to dark blue.

The color of the polygons was changed on line 24, <CssParameter name="fill">#000080</CssParameter>. This line determines the fill color for the polygons, it was changed from a grey, to a dark blue.

Once the color has been changed in the SLD code, click the validate button at the bottom of the page. This will make sure there are no errors in the code. If the code is good a message will appear at the top of the page. Once the code has been validated, go to the top of the page and in the workspace box and choose your layer, and hit submit. Now the SLD code has been associated with your layer, you can go to the layer preview and look at the change in color.

LayerPreview.png

Figure 7: Layer preview of the federal districts layer, with a dark blue color.

Now that the color of the polygon has been changed, let's add labels to the polygons.

Label.png

Figure 8: SLD code for adding labels to polygons.

As can be seen in Figure 8, the polygon labels are determined by the text symbolization from line 31 - 35. This section of code tells the server that there is a label that needs to be added to the polygons, and then line 33 <ogc:PropertyName>ENNAME</ogc:PropertyName> tells the server what attribute field from the layer to use as the labels. In this case it was ENNAME, or English Names, for federal electoral districts. At this point the color of the map was also changed to a lighter green using the code #40FF40 to make the labels easier to see.

LabelPreview.png

Figure 9: Demonstrating the labels for the federal electoral districts layer.

Get Legend Graphic

The GetLegendGraphic is a request that allows you to see the legend for a specific map that has been made. For more imformation visit this GeoServer page. [8] For example, if I wanted to see the legend for the Federal Electoral Districts I would use the following URL.

http://localhost:8080/geoserver/wms?REQUEST=GetLegendGraphic&VERSION=1.0.0&FORMAT=image/png&WIDTH=20&HEIGHT=20&LAYER=FED_CA_1_0_0_ENG

This URL can be used to get the legend for any of the maps that you may have on GeoServer, the only thing that will need to be changed is what is at the end of the link where it says Layer=, that will just have to be set to whatever layer the user wishes to see. As of this moment, there is no easy way to get the legend to display on a user's map when they use the GetMap function, but the user can click on different features in the map and the server will display information about those features on the bottom on the map. For example, if I click on one of the federal electoral districts, it would tell me things like the district name, the size, etc., as long as all of that data is associated with the layer.

Serving a Map

To serve a map using GeoServer there are three basic tools that can be used. The first is the GetMap function which allows the user to call up maps. The WMS reflector does pretty much the same thing as the GetMap function, but shortens it down, making it easier to handle. The first two options can only be used on the IP address that you are running GeoServer on. Finally there is the cascading WMS option which allows a user to access a map remotely.

GetMap

The GetMap function allows the user to call up a map from their browser, by requesting that the server generate said map.

There are a few required parameters that are used for the GetMap function

Parameter Required Description
Service Yes Service is WMS
Version Yes The version can be one of 1.0.0, 1.1.0, 1.1.1, 1.3.
Request Yes GetMap
Layers Yes The layer that is to be displayed on the map.
Styles Yes The styles in which the layers are to be rendered.
srs Yes The spatial reference system.
bbox Yes The bounding box for the map extent.
Width Yes The width output of the map in pixels.
Height Yes The height output of the map in pixels.
Format Yes Format for the map output. [9]

















The below link would lead to a image showing the federal electoral districts from GeoServer, with a width of 506 pixels, a height of 512 pixels, and a png file format. This link can be modified to meet an get map request, make sure to change the layer name and remove the parentheses. This link will only work on the same computer that you have GeoServer on (i.e. the "localhost" address points the computer back to itself).

http://localhost:8080/geoserver/wms? (Normally used to get to the web administration page)

&service=WMS (The service that has been requested)

&Version=1.1.0 (The version of GeoServer that is being used)

request=GetMap (The operation that has been requested)

&layers=FederalElectoralDistricts:FED_CA_1_0_0_ENG (The layer that has been requested)

&styles= (The styles in which the layers are to be rendered, usually left blank)

&srs=EPSG:3979 (The spatial reference)

&bbox=3658201.4942857143,658872.9742857143,9019156.614285715,6083004.862857142 (The bounding box)

&width=506 (The width requested)

&height=512 (The height requested)

&format=image%2Fpng (The image format requested)



500pxls Figure 10: An example of the GetMap function for the federal electoral districts layer.

WMS Reflector

The WMS reflector is a function that shortens the GetMap request, so instead of typing the extremely long link above, the user would type in a much shorter one.

A reflect request of the above GetMap function would look like this.

This will bring up the map of the federal electoral districts at a default width of 512 pixels. This method is much easier than typing in the long GetMap function, but does takes away some of the control.

Reflector.png

Figure 11: An example of the reflector function for the federal electoral districts layer.

Serving your web map

Now that you are able to view your maps using GeoServer on the local computer, it would be useful to be able to view map on a computer that is not on your home network. To serve maps that can be viewed beyond your own network, the user will need some sort of web server/web site that they can serve their maps out to.

Conclusion

GeoServer is an extremely useful tool for viewing spatial data over the web. This tutorial has taught you how to install, set up, add data, style your data, and finally serve it out. These are just basic functions of GeoServer, for more information on GeoServer and its capabilities read the GeoServer manual.

References

GeoServer User Manual [10]

Geobase: Federal Electoral Districts [11]

Retrieved from "https://dges.carleton.ca/CUOSGwiki/index.php?title=Developing_a_Web_Map_Server_Using_GeoServer&oldid=18834"