Interviewer > Customizing the applications > GPS feature > Customizing the GPS question
 
Customizing the GPS question
GPS question properties
Response required
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.
AcceptOnlyGPSBasedLocation
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).
AutoSubmitGPSQuestion
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.
GPSQuestion.Response.Value
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 = "" whereGPSQuestion is the GPS question name in the script item. This setting forces the GPS question to capture new coordinates when re-asked.
Setting the properties
.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 may save translation costs to translate these texts in the source metadata file. Refer to the UNICOM Intelligence Developer Documentation Library for a description of the UNICOM Intelligence Author wizard files and locations.
The default reporting script depends on the GPS question being namedGPSQuestion. 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 UNICOM Intelligence Author, the UNICOM Intelligence Author wizard source .mdd file is recommended as the source for Professional scripting. Open the GPS.mdd file from:
[INSTALL_FOLDER]\IBM\SPSS\<version>\Author\Library\Questions\Question Types
and copy the metadata and routing sections into the appropriate Professional panes.
See also
Prerequisites for interviewing with a GPS question
Reporting on location
Known issues
GPS feature