Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Overview

iShare returns results based upon a location - whether that be a click on a map or a given address in My House. If you imagine that a point click equates to a small bounding box on the earth's surface then tolerance is the measure by which we can expand that bounding box.

iShare Maps / GIS Pixel Tolerance

Info Click results are returned based upon the following: when a user clicks on a map they are actually selecting an individual pixel. iShare takes that pixel and with a Scale a bounding box is calculated. Any geometries found to overlap with this bounding box are returned as results. Unfortunately for point layers we might not click on the exact pixel that covers the point's geometry. For example a layer may be rendered with a 20px symbol image for each point object. The symbol is anchored to the point's geometry by the image's mid-point by default. This means that if a user doesn't click on the exact centre of the symbol they will not hit the actual geometry of the object. In order to correct this a map pixel tolerance is set which widens the bounding box to cover the physical area that the symbol represents.

Check that the iShare Settings for MapPixelTolerance is reasonable. Open Studio and select Settings, on the General Settings tab scroll down until you see the Web entries. Here you will see the MapPixelTolerance setting. This is the number of pixels the bounding box is calculated to cover at any one scale.

The MapPixelTolerance should never be set to less than 10 pixels and probably no more than 20. Lower than 10 and Point symbols may not return results. Higher than 20 and the bounding box used becomes too large and more results are returned than expected. The value is dependent upon the size of the rendered symbols used and the anchor position for the each point layer. The majority of points will use a mid-point anchor with a symbol image normally no bigger than 20 pixels. In that case '10' would be an appropriate value to use.

Unfortunately there is a danger when clicking close to Polygon boundaries more results than desired may be returned. This is something that we are looking to resolve in future versions.

My House Precision

For Point layers the Find Nearest setting is used and a Distance, specified in metres, equates to the tolerance. For Polygon layers you need to use the Show My setting and specify TOLERANCEUNITS as METERS in the LAYER definition in the .MAP file. The tolerance (distance) is hard coded at 0.01. So the result is that a one centimetre bounding box is used around the address location.

My Nearest Precision

These should always use the Find Nearest setting for both Point and Polygon layers where the Distance, specified in metres, equates to the tolerance.


  • No labels