Navigation:  Introduction to WebOffice map widget > Supported Parameters > Tool Parameters > activetools > LOCATION > Polling

Polling is a mechanism of the geolocation tool used for getting a more precise location result. Polling has to be configured on the geolocation tool in the WebOffice project configuration (two parameters Required Position Accuracy [m] and Maximum Wait Time [s]). The concept of polling is to ask in a cycle of 5 seconds for the current location:

•If the result is within a configured accuracy, polling will stop and the location will be shown.

•If the result is not within a configured accuracy, polling will continue as long the location will be in the configured accuracy.

oIf the configured accuracy will never be reached, polling stops after a configured maximum wait time.

 

 

To activate polling, configure a Required Position Accuracy (m). The default value 0 means, that polling will not be used. If you configure e.g. 25 m, the geolocation tool will ask all 5 seconds for the current location. If the result is not within 25 m, polling will continue to ask again all 5 seconds for the current location.

The Maximum Wait Time [s] defines the time, as long polling tries to get the current location. This parameter is important, if the geolocation tool will not find a location within the configured accuracy (e.g. 25 m). In the example of the screenshot (maximum wait time = 45 s), the geolocation tool tries to find the current location for 45 seconds. After that time polling stops and the geolocation tool shows the most precise location that was found.

 

 

 

Note: Consider that the geolocation tool will only show results, if the location is within the max accuracy (parameter &max_accuracy_mw=)

Note: The required position accuracy of the polling mechanism also depends on the accuracy of the mobile device. For devices using iOS and Android an accuracy of 25 m should be sufficiently.