Customizing the GPS question

The GPS question's Response required option is selected by default. This means that the GPS question cannot be passed until the GPS position information has been captured. Deselecting this option allows the interview to continue even if the position information cannot be captured.

The AcceptOnlyGPSBasedLocation parameter is set to True by default, which forces the question to accept only positions that include altitude along with latitude and longitude. Set the value to False to support devices that cannot deliver altitude information (including WiFi positioning).

The AutoSubmitGPSQuestion parameter is set to True by default, which displays the GPS Location page with a success or failure message that the interviewer must dismiss before continuing. Setting the parameter to Falsetransparently auto-submits the page for the interviewer. Setting this option toFalse also makes it impossible to pass the GPS question with the Back button. As a result, this parameter should only be used as the first or last interview question.

If the GPS question is re-asked during a survey (by moving back in the survey and then forward), the GPS location information will not be recaptured unless the response is set to empty before re-asking the question. Set GPSQuestion.Response.Value = "" where GPSQuestion is the GPS question name in the script item. This setting forces the GPS question to capture new coordinates when re-asked.

Note Value can be omitted from the setting as it is often automatically removed after saving and reopening the MDD file (the GPSQuestion.Response setting is the same as GPSQuestion.Response.Value.

Each of the properties can be set in the script item that is inserted by the GPS question library item. The GPS library item includes status and error message information (currently in English). The status and error messages are contained in the GPSTexts block that is available in the UNICOM Intelligence Author Questions pane. The message text can be translated as part of the interview. If the GPS question is used regularly, it may save translation costs to translate these texts in the source metadata file. For a description of the Author wizard files and locations, see the UNICOM Intelligence Developer Documentation Library .

The default reporting script depends on the GPS question being named GPSQuestion. Therefore, authors should be instructed to avoid modifying the name of the GPS question if the reporting script will be used.

The GPS library item adds a Location helper field to the GPS question. TheLocation question can be used to store the human-readable location address. The example reporting script contains an example of how to populate the Location helper field.

When UNICOM Intelligence Professional is used for scripting, rather than Author, the Author wizard source .mdd file is recommended as the source for Professional scripting. Open the GPS.mdd file from: