Ⱥdocutils.nodesdocument)}( rawsourcechildren]hsection)}(hhh](htitle)}(hMetacat's Use of Geoserverh]hTextMetacat’s Use of Geoserver}(hhparenthhhsourceNlineNuba attributes}(ids]classes]names]dupnames]backrefs]utagnamehhh hhh[/var/lib/jenkins/jobs/metacat_beta/workspace/metacat/docs/user/metacat/source/geoserver.rsthKubh paragraph)}(hXGeoServer 2.0.2, an open source Web Mapping Service (WMS) written in Java, is bundled with Metacat and can be used to render spatial data as web-deliverable maps. Metacat uses OpenLayers (http://openlayers.org/) to provide a web-based user interface for interacting with the generated maps. You can use any WMS-compatible client (e.g., ArcGIS, QGIS, JUMP, UDig, OpenLayers, Mapbender, Map Builder).h](hGeoServer 2.0.2, an open source Web Mapping Service (WMS) written in Java, is bundled with Metacat and can be used to render spatial data as web-deliverable maps. Metacat uses OpenLayers (}(hGeoServer 2.0.2, an open source Web Mapping Service (WMS) written in Java, is bundled with Metacat and can be used to render spatial data as web-deliverable maps. Metacat uses OpenLayers (hh-hhhNhNubh reference)}(hhttp://openlayers.org/h]hhttp://openlayers.org/}(hhhh8ubah}(h]h!]h#]h%]h']refurih:uh)h6hh-ubh) to provide a web-based user interface for interacting with the generated maps. You can use any WMS-compatible client (e.g., ArcGIS, QGIS, JUMP, UDig, OpenLayers, Mapbender, Map Builder).}(h) to provide a web-based user interface for interacting with the generated maps. You can use any WMS-compatible client (e.g., ArcGIS, QGIS, JUMP, UDig, OpenLayers, Mapbender, Map Builder).hh-hhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hKhh hhubh,)}(hIMPORTANT: Regardless of whether you plan on using the mapping functionality you should, for security purposes, configure GeoServer so that it doesn't use the default password. For instructions, please see Geoserver Configuration.h]hIMPORTANT: Regardless of whether you plan on using the mapping functionality you should, for security purposes, configure GeoServer so that it doesn’t use the default password. For instructions, please see Geoserver Configuration.}(hhThhRhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hK hh hhubhfigure)}(hhh](himage)}(h.. figure:: images/screenshots/image051.jpg :align: center A map generated by Metacat's GeoServer. Points and "bounding boxes" represent the geographic extent of datasets stored in the KNB Metacat repository. h]h}(h]h!]h#]h%]h']uriimages/screenshots/image051.jpg candidates}*hrsuh)hehhbhh*hKubhcaption)}(hA map generated by Metacat's GeoServer. Points and "bounding boxes" represent the geographic extent of datasets stored in the KNB Metacat repository.h]hA map generated by Metacat’s GeoServer. Points and “bounding boxes” represent the geographic extent of datasets stored in the KNB Metacat repository.}(hhzhhxubah}(h]h!]h#]h%]h']uh)hvhh*hKhhbubeh}(h]id1ah!]h#]h%]h']aligncenteruh)h`hKhh hhhh*ubh,)}(hGeoServer supports a wide variety of vector GIS data sources, which can be styled using Styled Layer Descriptors (SLDs) and output as images (the default) or raw vector data (GML or KML).h]hGeoServer supports a wide variety of vector GIS data sources, which can be styled using Styled Layer Descriptors (SLDs) and output as images (the default) or raw vector data (GML or KML).}(hhhhhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhh hhubh,)}(h@Currently, GeoServer can be used with the following limitations:h]h@Currently, GeoServer can be used with the following limitations:}(hhhhhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhh hhubh bullet_list)}(hhh]h list_item)}(hGeoServer will only map documents that are publicly available. This is because the mapping server's support for permissions control is not as fine-grained as Metacat's. h]h,)}(hGeoServer will only map documents that are publicly available. This is because the mapping server's support for permissions control is not as fine-grained as Metacat's.h]hGeoServer will only map documents that are publicly available. This is because the mapping server’s support for permissions control is not as fine-grained as Metacat’s.}(hhhhubah}(h]h!]h#]h%]h']uh)h+hh*hKhhubah}(h]h!]h#]h%]h']uh)hhhhhhh*hNubah}(h]h!]h#]h%]h']bullethuuh)hhh*hKhh hhubh,)}(hXOMetacat developers plan to continue extending and improving Metacat's mapping capabilities. If you are interested in contributing to those efforts, or if you are interested in learning more about the architecture and future plans for the mapping software, please contact the Metacat development team (metacat-dev@ecoinformatics.org).h](hX1Metacat developers plan to continue extending and improving Metacat’s mapping capabilities. If you are interested in contributing to those efforts, or if you are interested in learning more about the architecture and future plans for the mapping software, please contact the Metacat development team (}(hX/Metacat developers plan to continue extending and improving Metacat's mapping capabilities. If you are interested in contributing to those efforts, or if you are interested in learning more about the architecture and future plans for the mapping software, please contact the Metacat development team (hhhhhNhNubh7)}(hmetacat-dev@ecoinformatics.orgh]hmetacat-dev@ecoinformatics.org}(hhhhubah}(h]h!]h#]h%]h']refuri%mailto:metacat-dev@ecoinformatics.orguh)h6hhubh).}(h).hhhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hK hh hhubh )}(hhh](h)}(hInstalling and Configuringh]hInstalling and Configuring}(hhhhhhhNhNubah}(h]h!]h#]h%]h']uh)hhhhhhh*hK'ubh,)}(hX The GeoServer webapp should be installed as a sibling of Metacat. If you do NOT wish to run GeoServer, the deployment can be skipped, but any skins that use maps will not render correctly. (NOTE: Geoserver recommends using a PermGen space setting of at least 128MB.).h]hX The GeoServer webapp should be installed as a sibling of Metacat. If you do NOT wish to run GeoServer, the deployment can be skipped, but any skins that use maps will not render correctly. (NOTE: Geoserver recommends using a PermGen space setting of at least 128MB.).}(hjhjhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hK(hhhhubh,)}(hXMetacat comes with a pre-configured data directory to be used by GeoServer. This includes a world-countries base layer and a default configuration that is already aware of Metacat's spatial cache. The Metacat configuration interface is used to configure GeoServer to use this shared data directory. To further configure GeoServer, use the Web-based configuration utility, which is available at: http://your.server.com/ (e.g., http://knb.ecoinformatics.org/geoserver).h](hXMetacat comes with a pre-configured data directory to be used by GeoServer. This includes a world-countries base layer and a default configuration that is already aware of Metacat’s spatial cache. The Metacat configuration interface is used to configure GeoServer to use this shared data directory. To further configure GeoServer, use the Web-based configuration utility, which is available at: }(hXMetacat comes with a pre-configured data directory to be used by GeoServer. This includes a world-countries base layer and a default configuration that is already aware of Metacat's spatial cache. The Metacat configuration interface is used to configure GeoServer to use this shared data directory. To further configure GeoServer, use the Web-based configuration utility, which is available at: hjhhhNhNubh7)}(hhttp://your.server.comh]hhttp://your.server.com}(hhhjubah}(h]h!]h#]h%]h']refurijuh)h6hjubh/ (e.g., }(h/ (e.g., hjhhhNhNubh7)}(h'http://knb.ecoinformatics.org/geoserverh]h'http://knb.ecoinformatics.org/geoserver}(hhhj1ubah}(h]h!]h#]h%]h']refurij3uh)h6hjubh).}(h).hjhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hK-hhhhubh,)}(h#Common configuration tasks include:h]h#Common configuration tasks include:}(hjMhjKhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hK5hhhhubh)}(hhh](h)}(h"Adding a Map to a Web Page or Skinh]h,)}(hj^h]h"Adding a Map to a Web Page or Skin}(hj^hj`ubah}(h]h!]h#]h%]h']uh)h+hh*hK7hj\ubah}(h]h!]h#]h%]h']uh)hhjYhhhh*hNubh)}(h2Configuring the Size and Initial Extent of the Maph]h,)}(hjuh]h2Configuring the Size and Initial Extent of the Map}(hjuhjwubah}(h]h!]h#]h%]h']uh)h+hh*hK8hjsubah}(h]h!]h#]h%]h']uh)hhjYhhhh*hNubh)}(h4Configuring the Layout of the HTML Mapping Interfaceh]h,)}(hjh]h4Configuring the Layout of the HTML Mapping Interface}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hK9hjubah}(h]h!]h#]h%]h']uh)hhjYhhhh*hNubh)}(h/Configuring the "Select Location Drop-down Menuh]h,)}(hjh]h1Configuring the “Select Location Drop-down Menu}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hK:hjubah}(h]h!]h#]h%]h']uh)hhjYhhhh*hNubh)}(hOConfiguring the Visual Portrayal of Geospatial Data (e.g., symbology and color)h]h,)}(hjh]hOConfiguring the Visual Portrayal of Geospatial Data (e.g., symbology and color)}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hK;hjubah}(h]h!]h#]h%]h']uh)hhjYhhhh*hNubh)}(h-Adding Other Spatial Datasets to the Web Map h]h,)}(h,Adding Other Spatial Datasets to the Web Maph]h,Adding Other Spatial Datasets to the Web Map}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhKNhhhhhh*ubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h!]h#]h%]h']colwidthK"uh)jZhjWubj[)}(hhh]h}(h]h!]h#]h%]h']colwidthKuh)jZhjWubj[)}(hhh]h}(h]h!]h#]h%]h']colwidthK=uh)jZhjWubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h,)}(hDocumenth]hDocument}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKQhjubah}(h]h!]h#]h%]h']uh)jhjubj)}(hhh]h,)}(hLocationh]hLocation}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKQhjubah}(h]h!]h#]h%]h']uh)jhjubj)}(hhh]h,)}(h Descriptionh]h Description}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKQhjubah}(h]h!]h#]h%]h']uh)jhjubeh}(h]h!]h#]h%]h']uh)jhj|ubah}(h]h!]h#]h%]h']uh)jzhjWubhtbody)}(hhh](j)}(hhh](j)}(hhh]h,)}(hThe named location fileh]hThe named location file}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKShjubah}(h]h!]h#]h%]h']uh)jhjubj)}(hhh]h,)}(h locations.jsph]h locations.jsp}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKShjubah}(h]h!]h#]h%]h']uh)jhjubj)}(hhh]h,)}(h;The list of pre-defined locations (name and lat/lon bounds)h]h;The list of pre-defined locations (name and lat/lon bounds)}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKShj ubah}(h]h!]h#]h%]h']uh)jhjubeh}(h]h!]h#]h%]h']uh)jhjubj)}(hhh](j)}(hhh]h,)}(hMain map rendering functionsh]hMain map rendering functions}(hj2hj0ubah}(h]h!]h#]h%]h']uh)h+hh*hKUhj-ubah}(h]h!]h#]h%]h']uh)jhj*ubj)}(hhh]h,)}(hmaps.jsh]hmaps.js}(hjIhjGubah}(h]h!]h#]h%]h']uh)h+hh*hKUhjDubah}(h]h!]h#]h%]h']uh)jhj*ubj)}(hhh]h,)}(h+Defines the map, widgets and their behaviorh]h+Defines the map, widgets and their behavior}(hj`hj^ubah}(h]h!]h#]h%]h']uh)h+hh*hKUhj[ubah}(h]h!]h#]h%]h']uh)jhj*ubeh}(h]h!]h#]h%]h']uh)jhjubj)}(hhh](j)}(hhh]h,)}(h The rendered map and page layouth]h The rendered map and page layout}(hjhj~ubah}(h]h!]h#]h%]h']uh)h+hh*hKWhj{ubah}(h]h!]h#]h%]h']uh)jhjxubj)}(hhh]h,)}(hmap.jsph]hmap.jsp}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKWhjubah}(h]h!]h#]h%]h']uh)jhjxubj)}(hhh]h,)}(h:Loads the map and controls the HTML layout of the widgets.h]h:Loads the map and controls the HTML layout of the widgets.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKWhjubah}(h]h!]h#]h%]h']uh)jhjxubeh}(h]h!]h#]h%]h']uh)jhjubeh}(h]h!]h#]h%]h']uh)jhjWubeh}(h]h!]h#]h%]h']colsKuh)jUhjRubah}(h]h!]h#]h%]h']uh)jPhhhhhh*hNubh,)}(hXNOTE: By default, the first time Metacat is restarted, it generates a "spatial cache" containing geographic information about documents in its repository. This default behavior is specified in lib/metacat.properties, where the regenerateCacheOnRestart parameter is set to true. The information in the spatial cache is stored in a GIS-compatible format (the ESRI Shapefile) and consists of the document name and its geographic coverage. When documents are inserted, deleted, and updated in the Metacat repository, Metacat automatically syncs the spatial cache to reflect the changes. Because generating the cache can take a considerable amount of time (several minutes in the case of a few thousand documents), Metacat resets the regenerateCacheOnRestart property to false after the spatial cache has been generated. Note that if you upgrade or reinstall Metacat, the spatial cache will be regenerated again.h]hXNOTE: By default, the first time Metacat is restarted, it generates a “spatial cache” containing geographic information about documents in its repository. This default behavior is specified in lib/metacat.properties, where the regenerateCacheOnRestart parameter is set to true. The information in the spatial cache is stored in a GIS-compatible format (the ESRI Shapefile) and consists of the document name and its geographic coverage. When documents are inserted, deleted, and updated in the Metacat repository, Metacat automatically syncs the spatial cache to reflect the changes. Because generating the cache can take a considerable amount of time (several minutes in the case of a few thousand documents), Metacat resets the regenerateCacheOnRestart property to false after the spatial cache has been generated. Note that if you upgrade or reinstall Metacat, the spatial cache will be regenerated again.}(hjhjhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKZhhhhubh )}(hhh](h)}(h"Adding a Map to a Web Page or Skinh]h"Adding a Map to a Web Page or Skin}(hjhjhhhNhNubah}(h]h!]h#]h%]h']uh)hhjhhhh*hKiubh,)}(hNTo add a map to a Web page, simply include the map interface using an iframe::h]hMTo add a map to a Web page, simply include the map interface using an iframe:}(hMTo add a map to a Web page, simply include the map interface using an iframe:hjhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKjhjhhubj?)}(h~h]h~}(hhhjubah}(h]h!]h#]h%]h']jNjOuh)j>hKlhjhhhh*ubh,)}(hThe map URL, ``/metacat/style/common/spatial/map.jsp``, is the default map interface. If you plan to customize the map interface, copy the map.jsp file into your skin's directory (either the default or customized skin directory).h](h The map URL, }(h The map URL, hjhhhNhNubhliteral)}(h)``/metacat/style/common/spatial/map.jsp``h]h%/metacat/style/common/spatial/map.jsp}(hhhj ubah}(h]h!]h#]h%]h']uh)jhjubh, is the default map interface. If you plan to customize the map interface, copy the map.jsp file into your skin’s directory (either the default or customized skin directory).}(h, is the default map interface. If you plan to customize the map interface, copy the map.jsp file into your skin's directory (either the default or customized skin directory).hjhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hKphjhhubj?)}(h@cp -r style/common/spatial/map.jsp /style/skins//spatialh]h@cp -r style/common/spatial/map.jsp /style/skins//spatial}(hhhj9ubah}(h]h!]h#]h%]h']jNjOuh)j>hKwhjhhhh*ubh,)}(haYou can access the customized map with the URL: ``/metacat/style/skins//spatial/map.jsp``h](h0You can access the customized map with the URL: }(h0You can access the customized map with the URL: hjGhhhNhNubj)}(h1``/metacat/style/skins//spatial/map.jsp``h]h-/metacat/style/skins//spatial/map.jsp}(hhhjPubah}(h]h!]h#]h%]h']uh)jhjGubeh}(h]h!]h#]h%]h']uh)h+hh*hKyhjhhubeh}(h]"adding-a-map-to-a-web-page-or-skinah!]h#]"adding a map to a web page or skinah%]h']uh)h hhhhhh*hKiubh )}(hhh](h)}(h2Configuring the Size and Initial Extent of the Maph]h2Configuring the Size and Initial Extent of the Map}(hjqhjohhhNhNubah}(h]h!]h#]h%]h']uh)hhjlhhhh*hK|ubh,)}(hX!Before you configure the size and initial extent of the map, make sure that you have copied the map layout page into your skin's directory (See :doc:`configuration` for directions). Once the file has been copied, you can modify the map's initial extent in: ``${skin.dir}/spatial/map.jsp``.h](hBefore you configure the size and initial extent of the map, make sure that you have copied the map layout page into your skin’s directory (See }(hBefore you configure the size and initial extent of the map, make sure that you have copied the map layout page into your skin's directory (See hj}hhhNhNubsphinx.addnodes pending_xref)}(h:doc:`configuration`h]hinline)}(hjh]h configuration}(hhhjubah}(h]h!](xrefstdstd-doceh#]h%]h']uh)jhjubah}(h]h!]h#]h%]h']reftypedoc refdomainj refexplicit reftarget configurationrefdoc geoserverrefwarnuh)jhh*hK}hj}ubh_ for directions). Once the file has been copied, you can modify the map’s initial extent in: }(h] for directions). Once the file has been copied, you can modify the map's initial extent in: hj}hhhNhNubj)}(h``${skin.dir}/spatial/map.jsp``h]h${skin.dir}/spatial/map.jsp}(hhhjubah}(h]h!]h#]h%]h']uh)jhj}ubh.}(h.hj}hhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hK}hjlhhubh,)}(hTo change the map's initial extent, edit the bounding box. The default is to show the entire globe. The ``initMap()`` function should also be given the skin name so that spatial search results can be correctly styled.h](hjTo change the map’s initial extent, edit the bounding box. The default is to show the entire globe. The }(hhTo change the map's initial extent, edit the bounding box. The default is to show the entire globe. The hjhhhNhNubj)}(h ``initMap()``h]h initMap()}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubhd function should also be given the skin name so that spatial search results can be correctly styled.}(hd function should also be given the skin name so that spatial search results can be correctly styled.hjhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hKhjlhhubj?)}(hh]h}(hhhjubah}(h]h!]h#]h%]h']jNjOuh)j>hKhjlhhhh*ubh,)}(hpThe size (height/width) of the map can be controlled by the ``#map`` CSS entry included in the ``map.jsp`` page.h](hhj<hhhNhNubah}(h]h!]h#]h%]h']uh)hhj9hhhh*hKubh,)}(hVThe size and initial extent of the map can be edited in : ${skin.dir}/spatial/map.jsp.h]hVThe size and initial extent of the map can be edited in : ${skin.dir}/spatial/map.jsp.}(hjLhjJhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhj9hhubh,)}(hThe map.jsp is a simple container that can be included in other more complex pages if desired. It contains the map, widgets and location dropdown list.h]hThe map.jsp is a simple container that can be included in other more complex pages if desired. It contains the map, widgets and location dropdown list.}(hjZhjXhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhj9hhubeh}(h]4configuring-the-layout-of-the-html-mapping-interfaceah!]h#]4configuring the layout of the html mapping interfaceah%]h']uh)h hhhhhh*hKubh )}(hhh](h)}(h0Configuring the "Select Location" Drop-down Menuh]h4Configuring the “Select Location” Drop-down Menu}(hjshjqhhhNhNubah}(h]h!]h#]h%]h']uh)hhjnhhhh*hKubh,)}(hX7The locations that appear in the "Select Location" drop-down menu are specified in the ``locations.jsp`` file. The locations.jsp can be copied from the common spatial template into your skin directory. Each location is defined as an HTML ``h]hL}(hhhjubah}(h]h!]h#]h%]h']jNjOuh)j>hKhjnhhhh*ubeh}(h].configuring-the-select-location-drop-down-menuah!]h#]0configuring the "select location" drop-down menuah%]h']uh)h hhhhhh*hKubh )}(hhh](h)}(hOConfiguring the Visual Portrayal of Geospatial Data (e.g., symbology and color)h]hOConfiguring the Visual Portrayal of Geospatial Data (e.g., symbology and color)}(hjhjhhhNhNubah}(h]h!]h#]h%]h']uh)hhjhhhh*hKubh,)}(hXGeospatial data sets are styled through the use of Styled Layer Descriptors (SLD). The default SLDs used for the data points and data bounding boxes are in ``/lib/spatial/geoserver/data/styles/`` and are named data_points_style.sld and data_bounds_style.sld, respectively.h](hGeospatial data sets are styled through the use of Styled Layer Descriptors (SLD). The default SLDs used for the data points and data bounding boxes are in }(hGeospatial data sets are styled through the use of Styled Layer Descriptors (SLD). The default SLDs used for the data points and data bounding boxes are in hjhhhNhNubj)}(h'``/lib/spatial/geoserver/data/styles/``h]h#/lib/spatial/geoserver/data/styles/}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubhM and are named data_points_style.sld and data_bounds_style.sld, respectively.}(hM and are named data_points_style.sld and data_bounds_style.sld, respectively.hjhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hKhjhhubh,)}(hbYou can find a more detailed tutorial on using SLD with GeoServer in the GeoServer documentation::h]haYou can find a more detailed tutorial on using SLD with GeoServer in the GeoServer documentation:}(haYou can find a more detailed tutorial on using SLD with GeoServer in the GeoServer documentation:hjhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhjhhubj?)}(hhttp://docs.geoserver.org/h]hhttp://docs.geoserver.org/}(hhhj ubah}(h]h!]h#]h%]h']jNjOuh)j>hKhjhhhh*ubeh}(h]Kconfiguring-the-visual-portrayal-of-geospatial-data-e-g-symbology-and-colorah!]h#]Oconfiguring the visual portrayal of geospatial data (e.g., symbology and color)ah%]h']uh)h hhhhhh*hKubh )}(hhh](h)}(h,Adding Other Spatial Datasets to the Web Maph]h,Adding Other Spatial Datasets to the Web Map}(hj'hj%hhhNhNubah}(h]h!]h#]h%]h']uh)hhj"hhhh*hKubh,)}(hX!If you have vector GIS data sets, such as weather or topographical information, on your server that you'd like to include in the interactive map, you must first register the data set with GeoServer. After the data set has been registered, you can add the layer to the map. You can also add spatial layers that have been made publically available through WMS (There are hundreds of spatial data sets available. Check out wms-sites.com for good catalog). Instructions for adding publically available layers are included at the end of this section.h]hX#If you have vector GIS data sets, such as weather or topographical information, on your server that you’d like to include in the interactive map, you must first register the data set with GeoServer. After the data set has been registered, you can add the layer to the map. You can also add spatial layers that have been made publically available through WMS (There are hundreds of spatial data sets available. Check out wms-sites.com for good catalog). Instructions for adding publically available layers are included at the end of this section.}(hj5hj3hhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhj"hhubh,)}(h/To register the data set and add it to the map:h]h/To register the data set and add it to the map:}(hjChjAhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhj"hhubhenumerated_list)}(hhh](h)}(hPoint your browser to ``http://your.server/geoserver``, log in to GeoServer, and navigate to the "Data Stores" configuration page under ``Data > Stores``.h]h,)}(hPoint your browser to ``http://your.server/geoserver``, log in to GeoServer, and navigate to the "Data Stores" configuration page under ``Data > Stores``.h](hPoint your browser to }(hPoint your browser to hjXubj)}(h ``http://your.server/geoserver``h]hhttp://your.server/geoserver}(hhhjaubah}(h]h!]h#]h%]h']uh)jhjXubhV, log in to GeoServer, and navigate to the “Data Stores” configuration page under }(hR, log in to GeoServer, and navigate to the "Data Stores" configuration page under hjXubj)}(h``Data > Stores``h]h Data > Stores}(hhhjtubah}(h]h!]h#]h%]h']uh)jhjXubh.}(hjhjXubeh}(h]h!]h#]h%]h']uh)h+hh*hKhjTubah}(h]h!]h#]h%]h']uh)hhjQhhhh*hNubh)}(hMCreate a new vector data source from a Shapefile in the "metacat" workspace. h]h,)}(hLCreate a new vector data source from a Shapefile in the "metacat" workspace.h]hPCreate a new vector data source from a Shapefile in the “metacat” workspace.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhjubah}(h]h!]h#]h%]h']uh)hhjQhhhh*hNubeh}(h]h!]h#]h%]h']enumtypearabicprefixhsuffixjuh)jOhj"hhhh*hKubha)}(hhh](hf)}(h.. figure:: images/screenshots/image055.png :align: center Creating a new shapefile using GeoServers web-based administrative interface. h]h}(h]h!]h#]h%]h']uriimages/screenshots/image055.pnghs}hujsuh)hehjhh*hKubhw)}(hMCreating a new shapefile using GeoServers web-based administrative interface.h]hMCreating a new shapefile using GeoServers web-based administrative interface.}(hjhjubah}(h]h!]h#]h%]h']uh)hvhh*hKhjubeh}(h]id3ah!]h#]h%]h']hcenteruh)h`hKhj"hhhh*ubjP)}(hhh](h)}(hThe Description, if specified, is mostly used internally to provide other administrators with information about the DataStore. Click Submit.h]h,)}(hThe Description, if specified, is mostly used internally to provide other administrators with information about the DataStore. Click Submit.h]hThe Description, if specified, is mostly used internally to provide other administrators with information about the DataStore. Click Submit.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhjubah}(h]h!]h#]h%]h']uh)hhjhhhh*hNubh)}(hkNavigate to the "Layers" configuration page under Data > Layers. Add a new Layer from your new data source.h]h,)}(hkNavigate to the "Layers" configuration page under Data > Layers. Add a new Layer from your new data source.h]hoNavigate to the “Layers” configuration page under Data > Layers. Add a new Layer from your new data source.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhjubah}(h]h!]h#]h%]h']uh)hhjhhhh*hNubh)}(hYou should also define a spatial reference system (SRS) number for the new layer. Most lat/long data is "4326". If your data is in another projection, determine its spatial reference system using the help links provided. h]h,)}(hYou should also define a spatial reference system (SRS) number for the new layer. Most lat/long data is "4326". If your data is in another projection, determine its spatial reference system using the help links provided.h]hYou should also define a spatial reference system (SRS) number for the new layer. Most lat/long data is “4326”. If your data is in another projection, determine its spatial reference system using the help links provided.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhj ubah}(h]h!]h#]h%]h']uh)hhjhhhh*hNubeh}(h]h!]h#]h%]h']jjjhjjstartKuh)jOhj"hhhh*hKubha)}(hhh](hf)}(h.. figure:: images/screenshots/image057.png :align: center GeoServer's FeatureType configuration. The SRS settings discussed in step 5 are highlighted. h]h}(h]h!]h#]h%]h']uriimages/screenshots/image057.pnghs}huj:suh)hehj,hh*hKubhw)}(h\GeoServer's FeatureType configuration. The SRS settings discussed in step 5 are highlighted.h]h^GeoServer’s FeatureType configuration. The SRS settings discussed in step 5 are highlighted.}(hj>hj<ubah}(h]h!]h#]h%]h']uh)hvhh*hKhj,ubeh}(h]id4ah!]h#]h%]h']hcenteruh)h`hKhj"hhhh*ubjP)}(hhh](h)}(hStyle the layer using a style from the drop-down menu on the Publishing tab, or create a new SLD to create a new style object and corresponding SLD (this option provides more control over the style).h]h,)}(hStyle the layer using a style from the drop-down menu on the Publishing tab, or create a new SLD to create a new style object and corresponding SLD (this option provides more control over the style).h]hStyle the layer using a style from the drop-down menu on the Publishing tab, or create a new SLD to create a new style object and corresponding SLD (this option provides more control over the style).}(hj[hjYubah}(h]h!]h#]h%]h']uh)h+hh*hKhjUubah}(h]h!]h#]h%]h']uh)hhjRhhhh*hNubh)}(hFTry out the styled data set as a WMS layer using a the Layer Preview. h]h,)}(hETry out the styled data set as a WMS layer using a the Layer Preview.h]hETry out the styled data set as a WMS layer using a the Layer Preview.}(hjshjqubah}(h]h!]h#]h%]h']uh)h+hh*hKhjmubah}(h]h!]h#]h%]h']uh)hhjRhhhh*hNubeh}(h]h!]h#]h%]h']jjjhjjj+Kuh)jOhj"hhhh*hKubha)}(hhh](hf)}(h.. figure:: images/screenshots/image058.png :align: center GeoServer's Layer Preview allows you to see an OpenLayer rendering of the new layer. h]h}(h]h!]h#]h%]h']uriimages/screenshots/image058.pnghs}hujsuh)hehjhh*hKubhw)}(hTGeoServer's Layer Preview allows you to see an OpenLayer rendering of the new layer.h]hVGeoServer’s Layer Preview allows you to see an OpenLayer rendering of the new layer.}(hjhjubah}(h]h!]h#]h%]h']uh)hvhh*hKhjubeh}(h]id5ah!]h#]h%]h']hcenteruh)h`hKhj"hhhh*ubjP)}(hhh](h)}(hCopy the default ``map.js`` file that assembles the map in OpenLayers (``style/common/spatial/map.js``) to your skin's spatial directory.h]h,)}(hCopy the default ``map.js`` file that assembles the map in OpenLayers (``style/common/spatial/map.js``) to your skin's spatial directory.h](hCopy the default }(hCopy the default hjubj)}(h ``map.js``h]hmap.js}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubh, file that assembles the map in OpenLayers (}(h, file that assembles the map in OpenLayers (hjubj)}(h``style/common/spatial/map.js``h]hstyle/common/spatial/map.js}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubh%) to your skin’s spatial directory.}(h#) to your skin's spatial directory.hjubeh}(h]h!]h#]h%]h']uh)h+hh*hKhjubah}(h]h!]h#]h%]h']uh)hhjhhhh*hNubh)}(hfEdit the init() method to include your new layer in the map - either as an overlay or as a base layer.h]h,)}(hfEdit the init() method to include your new layer in the map - either as an overlay or as a base layer.h]hfEdit the init() method to include your new layer in the map - either as an overlay or as a base layer.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhjubah}(h]h!]h#]h%]h']uh)hhjhhhh*hNubh)}(h^Point your browser to the map interface. Your new layer should appear with the existing ones. h]h,)}(h]Point your browser to the map interface. Your new layer should appear with the existing ones.h]h]Point your browser to the map interface. Your new layer should appear with the existing ones.}(hjhjubah}(h]h!]h#]h%]h']uh)h+hh*hKhj ubah}(h]h!]h#]h%]h']uh)hhjhhhh*hNubeh}(h]h!]h#]h%]h']jjjhjjj+Kuh)jOhj"hhhh*hKubeh}(h],adding-other-spatial-datasets-to-the-web-mapah!]h#],adding other spatial datasets to the web mapah%]h']uh)h hhhhhh*hKubh )}(hhh](h)}(hBAdding External Spatial Data Made Publically Available through WMSh]hBAdding External Spatial Data Made Publically Available through WMS}(hj6hj4hhhNhNubah}(h]h!]h#]h%]h']uh)hhj1hhhh*hKubh,)}(hThere are hundreds of sources of spatial data made publically available through WMS (check out http://wms-sites.com for a good catalog). To add these data sources to your map, add the layers in your skin's ``spatial/map.js`` file.h](h_There are hundreds of sources of spatial data made publically available through WMS (check out }(h_There are hundreds of sources of spatial data made publically available through WMS (check out hjBhhhNhNubh7)}(hhttp://wms-sites.comh]hhttp://wms-sites.com}(hhhjKubah}(h]h!]h#]h%]h']refurijMuh)h6hjBubh] for a good catalog). To add these data sources to your map, add the layers in your skin’s }(h[ for a good catalog). To add these data sources to your map, add the layers in your skin's hjBhhhNhNubj)}(h``spatial/map.js``h]hspatial/map.js}(hhhj_ubah}(h]h!]h#]h%]h']uh)jhjBubh file.}(h file.hjBhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hKhj1hhubeh}(h]Badding-external-spatial-data-made-publically-available-through-wmsah!]h#]Badding external spatial data made publically available through wmsah%]h']uh)h hhhhhh*hKubeh}(h]installing-and-configuringah!]h#]installing and configuringah%]h']uh)h hh hhhh*hK'ubh )}(hhh](h)}(hSpatial Queriesh]hSpatial Queries}(hjhjhhhNhNubah}(h]h!]h#]h%]h']uh)hhjhhhh*hKubh,)}(hTo find out which documents in the Metacat repository lie in a specified geographic region, query the spatial cache using Metacat's spatial_query action. Metacat can perform any query supported by the WFS/WMS standards.h]hTo find out which documents in the Metacat repository lie in a specified geographic region, query the spatial cache using Metacat’s spatial_query action. Metacat can perform any query supported by the WFS/WMS standards.}(hjhjhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhjhhubh,)}(h)An example of a spatial query string is::h]h(An example of a spatial query string is:}(h(An example of a spatial query string is:hjhhhNhNubah}(h]h!]h#]h%]h']uh)h+hh*hKhjhhubj?)}(hfhttp://localhost/metacat/metacat?action=spatial_query&xmin=-117.5&xmax=-64&ymin=3&ymax=46&skin=defaulth]hfhttp://localhost/metacat/metacat?action=spatial_query&xmin=-117.5&xmax=-64&ymin=3&ymax=46&skin=default}(hhhjubah}(h]h!]h#]h%]h']jNjOuh)j>hKhjhhhh*ubh,)}(hXWhere ``xmin``, ``xmax``, ``ymin`` and ``ymax`` represent the western, eastern, southern and northern bounding coordinates (the "bounding box"), respectively. The spatial query action returns all documents that overlap or that are contained inside the specified spatial coordinates. The result set is returned as HTML using the style of the specified skin (in this example, default).h](hWhere }(hWhere hjhhhNhNubj)}(h``xmin``h]hxmin}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubh, }(h, hjhhhNhNubj)}(h``xmax``h]hxmax}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubh, }(hjhjubj)}(h``ymin``h]hymin}(hhhjubah}(h]h!]h#]h%]h']uh)jhjubh and }(h and hjhhhNhNubj)}(h``ymax``h]hymax}(hhhj ubah}(h]h!]h#]h%]h']uh)jhjubhXT represent the western, eastern, southern and northern bounding coordinates (the “bounding box”), respectively. The spatial query action returns all documents that overlap or that are contained inside the specified spatial coordinates. The result set is returned as HTML using the style of the specified skin (in this example, default).}(hXP represent the western, eastern, southern and northern bounding coordinates (the "bounding box"), respectively. The spatial query action returns all documents that overlap or that are contained inside the specified spatial coordinates. The result set is returned as HTML using the style of the specified skin (in this example, default).hjhhhNhNubeh}(h]h!]h#]h%]h']uh)h+hh*hKhjhhubeh}(h]spatial-queriesah!]h#]spatial queriesah%]h']uh)h hh hhhh*hKubeh}(h]metacat-s-use-of-geoserverah!]h#]metacat's use of geoserverah%]h']uh)h hhhhhh*hKubah}(h]h!]h#]h%]h']sourceh*uh)hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjP error_encodingUTF-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh* _destinationN _config_files]pep_referencesN pep_base_url https://www.python.org/dev/peps/pep_file_url_templatepep-%04drfc_referencesN rfc_base_urlhttps://tools.ietf.org/html/ tab_widthKtrim_footnote_reference_spacefile_insertion_enabled raw_enabledKsyntax_highlightlong smart_quotessmartquotes_localesNcharacter_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xformembed_stylesheetcloak_email_addressesenvNgettext_compactubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j+ j( jjjijfj6j3jkjhjjjjj.j+j}jzj# j u nametypes}(j+ NjNjiNj6NjkNjNjNj.Nj}Nj# Nuh}(j( h jhjfjj3jljhj9jjnjjj+j"jzj1j jhhbj jjjjLj,jju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startKid_startKparse_messages](hsystem_message)}(hhh]h,)}(h:Enumerated list start value not ordinal-1: "3" (ordinal 3)h]h>Enumerated list start value not ordinal-1: “3” (ordinal 3)}(hhhj ubah}(h]h!]h#]h%]h']uh)h+hj ubah}(h]h!]h#]h%]h']levelKtypeINFOsourceh*lineKuh)j hj"hhhh*hKubj )}(hhh]h,)}(h:Enumerated list start value not ordinal-1: "6" (ordinal 6)h]h>Enumerated list start value not ordinal-1: “6” (ordinal 6)}(hhhj ubah}(h]h!]h#]h%]h']uh)h+hj ubah}(h]h!]h#]h%]h']levelKtypej sourceh*lineKuh)j hj"hhhh*hKubj )}(hhh]h,)}(h:Enumerated list start value not ordinal-1: "8" (ordinal 8)h]h>Enumerated list start value not ordinal-1: “8” (ordinal 8)}(hhhj ubah}(h]h!]h#]h%]h']uh)h+hj ubah}(h]h!]h#]h%]h']levelKtypej sourceh*lineKuh)j hj"hhhh*hKubetransform_messages] transformerN decorationNhhub.