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 False transparently auto-submits the page for the interviewer. Setting this option to False 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.

.Value can be omitted from the setting as it is often automatically removed after saving and reopening the MDD file (theGPSQuestion.Response setting is the same asGPSQuestion.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 might save translation costs to translate these texts in the source metadata file.

The default reporting script depends on the GPS question being namedGPSQuestion. Do not change 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 UNICOM Intelligence Author, use the UNICOM Intelligence Author wizard source .mdd file as the source for Professional scripting. Open the GPS.mdd file from:

Copy the metadata and routing sections into the Professional panes.