Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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. With no tolerance a user may click on a point layer and may not hit dead centre on a point's symbol so no results are returned. This is because the symbol is rendering a greater area than what the geometry covers. A tolerance will widen the search area to include the associated point's geometry. Likewise if we take an residential property that is situated next to a neighbouring ward we want to use no tolerance as widening the bounding box will return incorrect results.

...

Note

In general the MapPixelTolerance should never be set to less than 10 pixels and probably no more than 20. Typically map icons are around 20 pixels wide so setting the tolerance lower than 10 and Point layers may not return results. Higher than 20 and the bounding box used becomes too large and more results are returned than expected. As said, the value is dependent upon the size of the rendered symbols used and the anchor position for the each point 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.

...