HomeGuidesRecipesAPI
HomeGuidesAPILog In
Guides
These docs are for v16. Click to read the latest docs for v31.

Geolocation

The Geolocation question type is for getting the latitude and longitude of the current user typically using a mobile device out in the field.

This question has only one additional property called “High accuracy” that is available under Properties tab.

1919

If this is on then the GPS will be used in the device if available. If it is off or there is no GPS available then mobile tower triangulation or IP address known locations will be used. This depends on the browser’s logic and is in order of accuracy.

953

🚧

Note:

IP addresses will mostly just give you the center of the town you are in.

Geo location answer has a property called Field which selects which part of the coordinates you want. This property comes with three options "Latitude, Longitude", "Latitude" or "Longitude". The first option ("Latitude, Longitude") is the standard notation for coordinates and can be passed directly to other systems like Google maps.

This option will also not be formatted in the users culture for numbers it will always be in the format "0.0,0.0".

899

Produce/Windows App

Question displays as two text boxes for latitude and longitude which can be user entered numbers (mainly if you had an external GPS device).

There is also a button called Use current location that will capture the current user’s location.

1773

📘

Note - browser compatibility

IE8 browser does not have geolocation functionality and getting the current location will always fail but they can be entered manually.

📘

Note - security

Due to browser security limitations, automatic geolocation is unavailable if the site is not secured by HTTPS. On unsecured sites the location can be entered manually.

Mobile Apps

In the mobile apps, the Geolocation question will display as a static map.

1008

The map view is call from Google's Static Maps web service and for reliable display requires an API Key. For further information on how to generate a suitable key see: https://developers.google.com/maps/documentation/maps-static/intro

To register the key with SmartIQ you need to add or edit option below in the Global_Options table in your SmartIQ database for the relevant BusinessUnitGuid. Set the OptionValue to the key you have generated.

GOOGLE_MAPS_STATIC_API_KEY