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.

 

icon_cross-reference

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

 

icon_comment

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

Geolocation tool configuration

 

Property

Description

Geographic Transformation Code/String

Geographic transformation code. Codes are listed in <ArcGIS_Desktop_Installation_Folder>\Documentation\geographic_transformations.pdf or you may use the VertiGIS Projection Helper

icon_comment

Please also consider to set the proper Transformation on the main map service.

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.

Update interval

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.

icon_comment

This function is supported by WebOffice core, WebOffice flex Client, WebOffice mobile and WebOffice map widget.

The map margin for the WebOffice mobile client, that is used for centering the position in the map, can be set in C:\Tomcat\webapps\<WebOffice application>\client_mobile\jss\properties_weboffice.xml in the parameter location.map.panLimit, the default is 10 %.

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).

icon_comment

Only WebOffice flex Client, WebOffice mobile client.

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.

icon_comment

The smallest possible required accuracy is 10m.

Only WebOffice flex Client, WebOffice mobile client and WebOffice map widget.

Maximum Wait Time [s]?

Specifies a maximum wait tome to achieve the required position accuracy.

icon_comment

Only WebOffice flex Client, WebOffice mobile client and WebOffice map widget.

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

 

Transformation

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

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

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.

 

icon_comment

Configure a Neighbor Search for the result of a geolocation. Be aware that this functionality is only supported in the WebOffice mobile client.

icon_cross-reference

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.