Common Web Map Client

The Common Web Map (CWM) client supports displaying and interacting with information on a map in a web browser.

Zoom In

Click to zoom the map in by one scale increment.

Zoom Out

Click to zoom the map out by one scale increment.

Zoom To BC

Click to zoom the map out to the extent of BC

Zoom to Previous

Click to zoom to the previous map extent

Zoom to Next

Click to zoom to the next map extent

Search

Click to display the Search for Location / Feature panel.

Search For Location

Search for a geographic location defined by a placename, address, mapsheet or coordinate.

The search type Auto automatically determines the location type from entered text, or a specific location type can be selected from the drop-down.

Locations are entered in the following ways:

Coordinate
- Geographic - as Lat,Lon or Lon,Lat. Either Decimal degrees (DD) or Degrees-Minutes-Seconds (DMS) can be used.
  DD Example: 49.5, -125.4
  
  DM Example: 49 30', -125 20'
  
  DMS Example: 49 30' 45", -125 20' 30"
- BC-Albers - as X Y
  Example: 1047118 495805
- UTM - as X Y and Zone number
  Example: 329751 5483095 zone 10
Mapsheet name, in one of the following systems:
- BCGS 1:20,000
  Example: 92B053
- NTS 1:50,000
  Example: 92B05
- NTS 1:250,000
  Example: 92B
Placename or locality.
Examples: "Kamloops", "Trout Lake"
Address as a street number and name, with optional city.
Example: "1000 Douglas St"
Street intersections are entered as "name1 and name2".
Example: "Fort and Cook"

Placename and address matching is case-insensitive and supports fuzzy matching.

Once the location type has been determined, Search Autocomplete shows matching location(s) in a list as text is entered.

Use the arrow keys or scroll bar to scroll through the locations
Click on a location name to zoom to it.
Hit Enter to zoom to the highlighted location
Click to zoom to the highlighted location
Click to clear the search.

Search For Features

Search for features on a layer spatially and by attribute value.

Select a layer to search
Choose whether to limit the search to within the visible extent of the map, or to search the entire layer
Select the maximum number of features to report. Layers may have very large numbers of features, so the maximum number is limited.
Add an attribute condition by selecting an attribute to filter on
Select the comparison operator for the condition
- Operator is EQUAL to, is LESS than, is GREATER than are case-insensitive
- Other operators are case-sensitive
Enter a value to be used in the condition

More than one attribute condition can be specified. Conditions are ANDed together.

Click to add a new condition to the search criteria
Click to remove a condition

When the Search layer and condition is specified, the search can be performed

Click to search for features matching the search criteria

The result features are displayed in the Searched Features sidepanel.

Click to expand features to show attribute names and values.
Hover over a feature title to highlight it on the map.
Click a feature title to zoom to it.
Click to copy the feature as an AOI geometry.

Bookmarks

Click to display the Bookmarks panel.

Bookmarks are named map extents which can be zoomed to. Bookmarks are saved in browser local storage.

Enter a new name and click to add a Bookmark.
Hover over a Bookmark entry to see its extent.
Click a Bookmark entry to zoom to it.
Click to delete a Bookmark.

Navigation

Allows the mouse to be used to zoom and pan the map.

To zoom in, double-click the mouse.
To pan, press the mouse and drag.
To zoom to an extent, hold Shift and drag the mouse.

AOI Geometry Toolbar

Click to display the Area Of Interest Geometry toolbar. This provides tools to create and manipulate geometry.

AOI Metrics

This panel is displayed when the AOI Toolbar is active.

It shows the Count, Area and Perimeter of the AOI geometries.

It lists the AOI geometries, and allows managing them with the following controls:

Hover over a geometry to highlight it
Click a geometry to zoom to it
Click to set a geometry as the Primary
Click to delete a geometry

Zoom to AOI Geometry

Click to zoom the map to the current AOI geometry set.

Draw Rectangle

Draw a rectangle by clicking the mouse to set a corner and dragging out the extent. The rectangle is added as an AOI geometry.

Draw Polygon

Draws a polygon

Click the mouse to create vertices.
Double-click to complete the shape and add it as an AOI geometry.
To draw using stream digitizing, hold Shift, click and drag the mouse.
To zoom in and out while drawing use the mouse wheel
To pan while drawing hold Ctrl, click and drag the mouse.

Draw Line

Draws a line (linear path).

Click the mouse to create vertices.
Double-click to complete the shape and add it as an AOI geometry.
To draw using stream digitizing, hold Shift, click and drag the mouse.
To zoom in and out while drawing use the mouse wheel
To pan while drawing hold Ctrl, click and drag the mouse.

Draw Point

Draws a point.

Click the mouse to create the point.

Draw Circle

Draws a circle.

Click and drag the mouse to place the centre of the circle and define its radius.

Edit AOI

Edits AOI geometries by adding, moving or deleting vertices.

Click on an AOI geometry to edit it. The edit geometry highlights. Vertex handles appear when the mouse is hovered over segments.
To move a vertex, hover over the vertex and drag the vertex handle with the mouse.
To add a vertex, hover over an edge and drag the tentative vertex handle.
To delete a vertex, hover over it and press Delete.
To stop editing and keep the modified geometry, click anywhere other than an edge of the geometry.

Clear AOI

Click to clear all AOI geometries.

Undo Change

Click to undo a change to the AOI geometry.

Redo Change

Click to redo a change to the AOI geometry.

COGO

Click to display a panel to enter, display and edit geometry in COGO (Coordinate Geometry) format.

Import

Click to display a dialog to import geometries from a variety of spatial formats. The data format is auto-detected from the file type or data content.

Import geometry data in the following ways:

Tab From File

Click to choose a file to upload

Tab From Data

Enter data into the text text area, or paste data using CtrlV

The data projection (coordinate system) is auto-detected. If the coordinate system is UTM, the UTM Zone must be provided on the Choose Projection dialog. Choose the zone from a list, or by uploading a PRJ file.

Click to show the format, coordinate system and number and size of features read.
Click to import the data
Otherwise click to close the dialog

Export

Click to display a dialog to export geometries in a variety of spatial formats. Geometry is exported in the geographic coordinate system (WGS84).

Edit the Description if needed (it is used in some but not all formats)
Choose the Format to use for export. Available formats are:
- KML - Keyhole Markup Language, as used in Google Earth
- GPX - GPS Exchange format
- GeoJSON - Javascript notation
- Well-Known Text - WKT, a widely-used text geometry format
- Simple Text - a text listing of the geometry coordinates
- GeoMark - the URL of a BC Government GeoMark created for the geometry
Click to display the exported geometry in the selected format in the Data Text textbox.
The exported text can be copied using or CtrlC. The copied text can be pasted into an external application for use.

Geometry Calculator

Click to display a panel to perform calculations on geometries.

The display shows the Primary and Secondary AOI geometries defined.

Hover over a geometry to highlight it
Click a geometry to zoom to it
Click to set a geometry as the Primary
Click to delete a geometry

Memory Save

Click to save the Primary geometry to memory.

Memory Recall

Click to recall the geometry from memory as a new geometry.

Memory Clear

Click to clears the geometry memory.

Union

Click to computes the geometric union of all geometries. The geometric union merges all geometries into a single geometry. The result geometry can be edited or have other calculations performed on it.

Intersect

Click to computes the geometric intersection of all geometries. The intersection is a geometry representing the common areas or lines of all the input geometries. The result geometry can be edited or have other calculations performed on it.

Subtract

Click to subtract the secondary geometries from the primary geometry. The result is a geometry which contains all the areas/lines/points which occur in the primary geometry but not in the secondary geometries. The result geometry can be edited or have other calculations performed on it.

Buffer

Computes a buffer polygon around the primary geometry to a specified distance. If the buffer distance is positive, the buffer expands (dilates) the geometry; if negative, it contracts (erodes) it.

Enter the buffer distance (in metres). The distance can be either positive or negative.
Click to replace the geometry with the computed buffer

Simplify

Reduces the number of vertices in a geometry while maintaining the approximate shape of the original geometry. Uses the Douglas-Peucker simplification algorithm, which requires a distance tolerance to control how many vertices are eliminated.

Enter a simplification distance tolerance (in metres)
Click to replace the geometry with the simplified version

Validate Topology

Click to check if the primary geometry is topologically correct. This detects if polygons contain self-intersections or overlaps. If a topology error is found an indicator is displayed showing the location of the error.

Close Polygon

Click to close a linestring to form a polygon.

Clean Polygon

Click to clean a polygonal geometry. This ensures that the geometry is a topologically valid polygon.

Dangling linework is closed and trimmed
Self-intersections are removed
Partially contained holes are excised

Markup

Click to display a toolbar to create Markup on the map.

Zoom to Markup

Click to zoom to the Markup geometries.

Draw Rectangle

Draw a rectangle by clicking the mouse to set a corner and dragging out the extent.

Draw Polygon