This article describes how you can configure a file location provider in the Survey123 field app. This allows you to feed the Survey123 app with locations from a file where you can store, for example, a track. This technique is useful for testing and for demonstrations.
This functionality is only available in Survey123 version 3.10 or newer
As you may already know, the Survey123 field app can be configured with a custom location provider. This is typically used to connect your app to external GNSS receivers via Bluetooth or a network connection. These connections feed the Survey123 field app with NMEA messages, carrying location information from the GNSS receiver.
You can also configure a location provider from a file, which is exactly what you need to do to simulate locations in Survey123. The file format Survey123 expects is (no surprise!) a NMEA log file. Most GNSS receivers can export NMEA logs, so if you get out in the field and want to replay your locations in Survey123, you can easily use those files as a location provider. If you do not have a GNSS receiver, there are a handful of utilities that you can use to create a NMEA file.
You create a NMEA file, as you walk or travel, from Survey123. It is extremely simple:
The NMEA file will get stored in the Survey123 directory automatically. You can now use them to replay them at any time. Lets see how next.
If you already have your NMEA file loaded into your device, all that's left to do now is target your NMEA file from the Survey123 app.
Here is how:
Once the file location provider has been set, your location will loop through the coordinates in your NMEA file. Speed, direction of travel, fix time and other properties will be honored.
Tip: Use the loop at the end of file and update rate settings in the file provider about page to better control how your NMEA file is played.
While creating NMEA files right from within the Survey123 field app is very easy, there may be times when you can't really walk or drive the track you want to replay. Lets explore next other practical options to create NMEA files and move them into your device so you can use them from the Survey123 field app.
One particular tool I like to use to create NMEA files is https://nmeagen.org/. Here is a video showing how easy it is:
If you have a shapefile with a line representing a path, you can use the Feature Vertices To Points—Data Management toolbox | Documentation tool in ArcGIS Pro to create a point layer, then run the Add Geometry Attributes—Data Management toolbox | Documentation tool and export the coordinates to a CSV file. The CSV file can then be transformed into a NMEA file using nmeagen.org.
If you plan to run Survey123 on Windows or macOS, keep your file in a known folder so you can browse to it in the field app. If you plan to use an Android or iOS mobile device, then you need to copy your file onto the device.
In iOS, you can move the NMEA file into your device using iTunes as shown in the animation below. With this workflow, you will need to connect your phone with your computer through a cable.
Alternatively, in iOS, you can email the NMEA file to yourself as an attachment and then save it locally on your phone or tablet.
Here are the steps:
Once you have the NMEA file in your computer, you are ready to configure the file location provider as described above to use it.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.