Using Map.query()

Fusion contains several widgets that allow the user to interactively select features in your map, but it is also possible to programmatically select features as well. This can be done in a couple of ways:

• writing some server-side code that performs the query, or
• using the query() method of the Map widget.

In this recipe, we'll look specifically at using the client side Map.query() method.

Map.query( options )

The options parameter to Map.query is an object that contains some of the following attributes:

persistent

boolean, default is true. Determines if the features selected by the query will be persistent beyond this query - i.e. they will stay on the map until the user clears the query results.

geometry

string, default is an empty string (no geometry). A Well Known Text string that defines the geometry to restrict the query to. The acceptable WKT format for geometries that work with this method are:

• POLYGON((x y, x y, x y, ...))
• LINESTRING(x y, x y, x y, ...)
• POINT(x y)

maxFeatures

integer, the default is 0 (no maximum). This restricts the query to return only a certain number of results. MapGuide only at this time, although there is no reason why it couldn't be implemented for MapServer too

layers

string, default is an empty string (do not limit to specific layers). This is a comma separated list of layer names to restrict the query to, often used to limit queries a single layer.

selectionType

string, default is 'INTERSECTS'. This controls how the server interacts with the geometry property. Not sure what other selectionTypes there are, need to research this

filter

string, default is an empty string (no filter). This is an SQL WHERE clause style string (attribute = 'value', attribute <= number) that is used to limit features in a query. MapGuide only at this time. MapServer supports attribute queries but not in the same way as MapGuide - and MapServer doesn't have a way of combining both geometry and filter at this time

extendSelection

boolean, default is false. This controls whether the current query will extend the current result set or replace it. MapGuide only at this time

computedProperties

boolean, default is false. This controls whether to compute additional properties about the geometries of the features that are in the result set, including perimeter and area of polygons, lengths of lines etc.

Example

var map = Fusion.getWidgetById('map');
map.registerForEvent(Fusion.Event.MAP_SELECTION_ON, mySelectionHandler);
var options = {};
options.geometry = 'POLYGON((0 0,0 1,1 1,1 0,0 0))';
options.layers = 'parcels'
options.filter = 'parcelid = 10010';
map.query(options);