Skip To Content

Preview Function

Preview Function

The Preview function provides a map view of live data described by metatdata records in the Geoportal. Instructions for navigating the map are provided below. The Preview can be launched from the search result page from the Preview link in a search result, through the web browser URL window, or from an embedded URL in another web page. It is also contained in the search result Details page, displaying only if the metadata describes a live data resource. The Preview page has four sections:

  1. Service field: URL of the service or referenced website that is loaded in the Preview window
  2. Embed field: html element that can be copied and input as a customization to other web pages
  3. Preview window: window in center of page that will display the map service, an uploaded image, the organization's website, or another element if possible. Some metadata documents do not provide enough information to populate the Preview window, or reference a service that does not support an image (for example, a CS-W service). Currently, the Preview will display ArcGIS Server services (will show a map for MapServer services), OGC WMS services, KMZ, Sensor Observations Services, and ArcIMS services.
  4. REST API metadata information: displays the REST API metadata entry.
There are four ways to access the Preview:
  1. When viewing a list of search results in the Search page, the search results will have a Preview link. Clicking on the Preview link will load the Preview page for that metadata record.
  2. If the Details link is clicked for a search result that describes live data, then the Details page will also display a Preview link at the top.
  3. Outside of the Geoportal, you can access the Preview for a specific service by entering the following into your browser:


    <Geoportal Instance Name>/catalog/livedata/<service url>


  4. It is also possible to embed the Preview in another webpage. Simply copy the information from the Embed field into the webpage (can be a page outside the Geoportal web application structure), and save the file.

Navigating the Preview Map

The Preview map is built using the javascript API. Navigation behavior will be like the javascript api map available as an example on the ESRI resource center.

  • Preview Map navigation controls, using the mouse:
    • Drag to pan
    • SHIFT + click to recenter
    • SHIFT + click + drag to define an extent in which to zoom
    • Mouse scroll forward to zoom in
    • Mouse scroll backward to zoom out
    • Double click to center and zoom in
  • Preview Map navigation controls, using the keyboard:
    • Up, down, left, right Arrow keys to pan
    • + key to zoom in a level
    • - key to zoom out a level
  • Map navigation buttons:
    • Full Extent button will zoom to the full extent of the world
    • Previous Extent button will take you to the extent accessed just before the current extent, if applicable
    • Next Extent button will take you forward to the extent accessed just after the current extent, if applicable
    • Base Map checkbox: the basemap configured to display on the search page will also display for WMS, GeoRSS, and KML services. The Base Map checkbox will not display for ArcIMS or ArcGIS Server services because for these types of services, the service layer obscures what would be the basemap even if the extent of the service is smaller than the extent of the basemap (this empty space renders as whitespace). The OGC-based services, in contrast, actually overlay upon the map. For OGC-based services, if you uncheck the Base Map checkbox the base map layer underneath the service being previewed will be turned off.