Geolocation
The Geolocation tool uses the functionality of the Geolocation API to determine the user's current position on the map. It allows determining the position using the browser functionality. This means that the Geolocation function only retrieves the information that a browser provides using the Geolocation API.
If location determination is used within a WiFi, this functionality may not be available or may display an incorrect position. The Geolocation tool is intended for devices with GPS functionality.
•More information about using the Geolocation API can be found at the following link from W3C. •In case of questions whether the information that WebOffice 10.9 R3 displays is correct, it is recommended to compare it with a website that is based on the same technology and accesses the same information - i.e. any Geolocation API website, e.g. https://www.w3schools.com/html/html5_geolocation.asp or https://browserleaks.com/geo |
•Normally, a web application like WebOffice 10.9 R3 cannot access information from a GPS sensor like native apps. •Be aware that the Geolocation tool can only be used if the WebOffice project URL is accessed via HTTPS. The Geolocation tool is denied for HTTP connections. •Make sure that all map services included in the map collection are configured via HTTPS URL. Otherwise (using mixed content), the browser may refuse to determine the location in WebOffice 10.9 R3. |
Geolocation tool configuration
Property |
Description |
||
---|---|---|---|
Geographic transformation code. Codes are listed in <ArcGIS_Desktop_Installation_Folder>\Documentation\geographic_transformations.pdf or you may use the VertiGIS Projection Helper
|
|||
Show initial Position |
Shows the current user location as center of the initial map (true) or not (false). Note that if chosen true, the initial extent setting from the project configuration setting will be overruled. |
||
Initial Scale |
Scale for the map if the tool should zoom to the user location initially. |
||
Maximum delay for initial query? |
Maximum delay (in milliseconds) for the initial location query. If the answer is not received in this time the project starts with the default extent of the project configuration. |
||
Show Marker? |
Defines if a marker should show the initial position or if the initial extent is displayed (if configured) without showing a marker symbol. |
||
Precision Treshold |
If the precision [m] of the current position is worse (greater then) the configured threshold then the map center will not get repositioned to the geolocation coordinates. The user will get a notification that the geolocation can not be displayed due to inadequate precision instead. |
||
Show Accuracy Circle? |
Defines if the geolocation accuracy should get displayed as circle. Display as a circle is not useful for geographic projection systems and for maps in map units other than meters. |
||
Write Accuracy? |
Defines if the geolocation accuracy should get written on the map at the current location. |
||
Defines the interval (in seconds) the location is updated if the tool is in tracking mode. If 0 is configured, the tracking mode will be deactivated.
|
|||
Cache position (mobile Client)? |
Specifies if the last valid position is cached and used, if the next position queries provide an invalid or inaccurate position information (mobile client only).
|
||
Required Position Accuracy [m]? |
Specifies a required accuracy for the position. The client queries for a position, until this configured accuracy limit is met, or the maximum wait time is exceeded. The default value of 0m means no polling, the first received position is used.
|
||
Maximum Wait Time [s]? |
Specifies a maximum wait tome to achieve the required position accuracy.
|
||
Use tool? |
Specify whether this Tool is available in the WebOffice client (true) or not (false). |
||
HTML client disabled? |
Specifies whether the tool is disabled (true) in the WebOffice html client or not (No). |
||
CORE client disabled? |
Specifies whether the tool is disabled (true) in the WebOffice core client or not (false). |
||
FLEX client disabled? |
Specifies whether the tool is disabled (true) in the WebOffice flex client or not (false). |
Geolocation tool properties
The Geolocation tool represents the position in WGS84. If you realize some mismatch/offset in the position result in WebOffice 10.9 R3 clients, you will have to define the proper transformation to WGS84 on the main map service in ArcMap. After that restart the map service.
Configuration of a transformation to WGS84 on the main map service
Coordinate display for geolocation in the WebOffice flex Client
Furthermore, with the configuration of the subnode Projection, it is possible to configure WebOffice 10.9 R3 in such a way that the display of the location coordinates (geolocation) is output in a projection preconfigured by the administrator, taking into account the configured transformation. Thus the display of the current location in the respective country coordinates is possible.
The node thus defines all parameters necessary for the definition of the target projection. If the desired target projection is not available as EPSG identifier, the complete projection string (escaped!) must be specified.
Coordinate display for geolocation in the WebOffice flex Client
Property |
Description |
---|---|
Projection ID/String |
Provide EPSG code if available. Provide projection parameters otherwise (copy and paste from the .prj file recommended). |
Name |
Projection name |
Geographic Transformation Code/String |
Geographic transformation code. Can be reviewed in ArcGIS_Desktop_Installation_Folder\Documentation\geographic_transformations.pdf. If a custom transformation is used, the transformation string with parameters can be used. Copy and paste from the .gtf file is recommended. Link VertiGIS Projection and Geotransformation Helper: https://resources.weboffice.vertigis.com/Util/projection_helper.html |
Result precision |
Specifies how many digits after the comma should be used for display of double values. |
Output format |
Define output format for coordinates -decimal output as double. The number of decimal places is determined by the Result precision. -degree output in degrees (DD°MM'SS.NN''). The number of decimal places for the seconds is determined by the Result precision. -degree_decimal_minutes output in degrees and minutes but without seconds (DD°MM.NN'). The number of decimal places for the minutes is determined by the Result precision. (Hint: a higher number of decimal places than in format degree is required to achieve a comparable precision.) |
<latitude longitude> in clipboard? |
Specifies whether the coordinates get formatted <latitude longitude> (Yes) or <longitude latitude> (No) in the clipboard. Only affects geographic coordinate systems (e.g. WGS84). |
Projection category |
Group category for projection lists displayed for the following tools: Search/reproject coordinates. |
Configure a Neighbor Search for the result of a geolocation. Be aware that this functionality is only supported in the WebOffice mobile client. |
See chapter Navigation Control for details about the tool appearance in the WebOffice core client. See chapter Location for details about the tool appearance in the WebOffice mobile client. See chapter Geolocation for details about the tool appearance in the WebOffice flex client. |