Skip navigation
All Places > Survey123 for ArcGIS > Blog > Author: MVertzonis-esristaff

To date, many users who require high accuracy location capture have found ways to do so with Survey123 – typically by using additional software to make the position from their external receiver output data through to their device’s internal position source. From version 3.3 onward, Survey123 can directly communicate with many external GNSS receivers, significantly improving both the connection experience and the quality of data captured.

 

 

The most common type of receiver available for Survey123 users is a Bluetooth GNSS receiver, but you can also connect to USB receivers and receivers that are available over a network connection. The key requirement is that the receiver outputs NMEA sentences.

 

In general, direct GNSS support is the same in Survey123 on all platforms (Windows, Android, iOS, Mac, Ubuntu) but for iOS we also need to liaise with each hardware manufacturer individually. So far we have worked with our friends at Bad Elf, Eos, Leica and SXBlue to ensure that Survey123 on iOS will work with their receivers. If you have other receivers that you need to use with Survey123 on iOS please let us know, but in the meantime, please get started by using your receiver with Windows or Android.

 

Prepare for high-accuracy data collection

Before choosing to use an external receiver with your survey, think about what additional metadata you need to display or collect. In some cases, it might be enough to incorporate accuracy into a constraint so that data cannot be captured unless a certain level of accuracy is met.

 

In other cases, you may want to show the accuracy on the survey so the user can decide what to do, and in others, you might want to just capture all the data behind the scenes showing nothing to the user and keeping it for someone to analyze at a later data.

 

You can use note, decimal or hidden questions to show or store metadata values in a survey. For more information see https://doc.arcgis.com/en/survey123/desktop/create-surveys/high-accuracy-prep.htm

 

Connect your receiver to your device

Steps to connect:

  1. Turn on your receiver and place it near your device.
  2. Go to your devices Bluetooth settings, and wait for your receiver’s name to appear in the list.
  3. Tap the receiver to pair it with your device.

 

Warning: During our testing, we have found the biggest contributor to success (or failure) when using an external receiver, is connection to your device. Whilst you’re testing you may be tempted to try connection on a few devices, possibly swapping receivers around. If you have having any trouble connecting within Survey123 – we strongly recommend checking the Bluetooth connection in your device settings. Most receivers will only connect to one device at a time – take a look around your office and be sure no one else is trying to connect to your receiver!

Of course, in the real world these issues shouldn’t arise – typically you will have one receiver that you connect to one device - but it’s hard not to tinker with new toys in the office before going out in the field and I wouldn’t want experimentation to be your downfall!

 

Configure Survey123 to use the receiver

Steps to configure:

  1. Open Survey123 and on the main menu choose Settings
  2. Choose Location
  3. Choose Add Provider, and wait for your connected receiver’s name to appear in the list
  4. Tap the receiver to add it

 

 

Once the receiver is selected you are shown the settings for that receiver. You can give it a recognizable name, change how you are alerted when a connection is poor or is lost, and configure antenna height and preferred altitude measurements. We have found changing the name very useful, we all have our preferred alerts and once you set up your hardware on a pole, the antenna height is great to set and forget. Altitude is a tricky one – frankly - only touch this if you really know what your doing. In most cases, the external receiver will sort this out for you.

 

Go back to the location page and see that your receiver is now connected.

 

 

 

If you want to see more information about the data being received, press the satellite icon in the title bar. This icon is also visible whilst you’re in the survey. Here you get three pages: location data, skyplot and the NMEA data stream.

 

 

Use external receiver to capture location in a survey

This is the easy part. Once your receiver is connected, location is captured in exactly the same way in a survey as before. Only now you might notice the satellite icon flashing in the title bar. The satellite icon changes based on it the connectivity state. This icon initially only displays a satellite, adding three beams when searching for a position.

 

 

When positions are being received, the satellite periodically blinks.

 

 

We have had feedback where users have captured data and their location was unexpectedly captured at location 0,0. Waiting just a brief moment longer – until the satellite icon is blinking - will ensure you get a reasonable location recorded even when you don’t have a geopoint question in your survey.

 

Accuracy reporting

Some organizations require reporting of the accuracy of location data to specific standards. You can use Survey123 to report whatever metadata (and subsequent accuracy calculations) you like. The attached sample survey demonstrates how to not only record the 95% confidence interval of a location, but also to constrain location capture to only when a minimum accuracy is achieved. The calculations in this survey are based upon conversion factors from the National Standard for Spatial Data Accuracy (pages 3-10 and 3-11).

 

RTK and post processing

This section is intended to point you right back to the GNSS hardware supplier of your choice. In some cases, hardware suppliers will direct you to use an app on your device to process the positions before they are passed through to Survey123. In these cases, you will need to continue using the internal location provider setting in Survey123.  The GNSS hardware suppliers’ app will pass the corrected location information through to Survey123 where you would record the corrected information. In these cases, there may be limited metadata you can record in the survey.

Some GNSS hardware outputs all available information through their NMEA data stream and you can extract the metadata into your survey for analysis at a later data.

For post-processing, you may also need to save additional files from your receiver along with the metadata that you can record in Survey123. Please check your post processing solution of choice for what data will be required.

Do you or your colleagues know a little about Survey123, need to learn more, but dont know where to start? If so, we have created three learning paths to help you take you to that next level.

 

We know there is already a LOT of information available to help you, and that the sheer amount can be overwhelming. To help focus your attention, learn paths are collated around a theme or a learning objective. They are made up of different types of content - some of the content has already been around for a while, some are new - and include videos, tutorials, blogs and formal documentation.

 

For true beginners start with Try Survey123. In this path you'll use a survey first hand, build one yourself and take a look at the data that can be collected with a survey.

 

Take your surveys further does just that. Learn how to make your surveys open to the public, use offline maps, connect to existing feature services to collect data and customize how your data is delivered to stakeholders.

 

Creating your first few surveys can be straight forward: add questions, style and publish. But there's almost no limit to how smart you can make your form. Explore XLSForms for Survey123 will show you how to dynamically populate answers based on previous questions and data from external files, and how to translate your survey for multilingual use.


These paths are hosted at Learn ArcGIS. Let us know what other Survey123 paths you would like to see created.
 

When you install Survey123 2.0 (the field app or Survey123 Connect) on Windows, Mac or Ubuntu, you will now get a number of script files that can help you perform future unattended uninstall or installs of the app.

 

The same files are supplied for both the field app and Survey123 Connect - some are identical, one is app-specific. Follow the steps below for recommended usage, but of course, if you're a shell script file guru, then these files are a great starting point for your automated deployment system!

 

Prepare for unattended and installs

 

  1. Install Survey123 or Survey123 Connect 2.0
     You need to do a regular install once, to get the required files.
  2. Browse to

            ~\Users\Username\Applications\ArcGIS\Survey123ConnectforArcGIS
       and copy the following three files
             silent-install-controller.qs
             silent-uninstall-controller.qs
             silent-uninstall-install-Survey123ConnectforArcGIS
      to another location on your computer, for example ~\Desktop\UnattendedInstall

 

      NB: The two .qs files are the same for every app created by AppStudio for ArcGIS. You only need to copy these once. If you wish to be able to uninstall and install both the field app and Connect, also browse to ~\Users\Username\Applications\ArcGIS\Survey123 and copy silent-uninstall-install-Survey123forArcGIS to the same location as the .qs files you already have copied.

 

3. Copy installation files to ~\Desktop\UnattendedInstall

 

On Windows, your unattended install folder should now look like this:

 

Unattended install files

 

The .qs and script files don't change from version to version. Over time, the only files that will change are the installation files.

 

Uninstall only

 

1. Open a command window and navigate to the ~\Desktop\UnattendedInstall folder.

 

2. On Windows, enter the command

       silent-uninstall-install-Survey123ConnectforArcGIS.bat .
    On Mac and Ubuntu enter the command

      ./silent-uninstall-install-Survey123ConnectforArcGIS.sh .

 

Don't forget the dot at the end! That indicates that no file will be installed. You will see the uninstall screens appear, but you do not need to interact with them.

 

Uninstall and install

 

If you want to upgrade your app, you need to first uninstall the existing version, and then install the new one. You can do this in one action with these scripts. Your existing surveys are not deleted during an uninstall.

 

1. Open a command window and navigate to the ~\Desktop\UnattendedInstall folder.

 

2. On Windows enter the command

       silent-uninstall-install-Survey123ConnectforArcGIS.bat Survey123_x86_2_1_6.exe
    On Mac and Ubuntu enter the command

      ./silent-uninstall-install-Survey123ConnectforArcGIS.sh Survey123Connect_x86_2_1_9.exe

 

The file name at the end of each of these commands matches the installation file you are installing.

 

Install only

 

The steps are exactly the same as for uninstall and install described above.

The infinite monkey theorem states that a monkey hitting keys at random on a typewriter keyboard for an infinite amount of time will almost surely type a given text, such as the complete works of William Shakespeare.

 

You don't have an infinite amount of time to write your survey and hopefully your keystrokes will be less random than that of a monkey, so the time it will take you should be significantly less than infinity.

 

We have provided many resources to help you write your survey: blogs, samples, templates and documentation. Identifying which of these suits which users is as a challenge. Saying something is easy or difficult, alienates as many people as it helps.

 

Borrowing from (and bending) the infinite monkey theorem, we have chosen a classification scale to describe our content. If the goal is a survey (rather than the complete works of Shakespeare), and you have a computer and some sustenance - in this case bananas - you can build your survey. The question is how many bananas?

 

Every monkey needs to eat, and depending on how difficult / complex / time consuming a task is, more sustenance is required. Here is our banana rating for our Survey123 resources:

 

  •   One banana means you want to create a survey by clicking a few buttons and drag and dropping things in a window. The web is all you want to use, and your survey doesn't need calculations or complex relationships between questions.
  •   Two bananas means that you’re comfortable using Survey123 Connect, and making a more involved survey. You’re ready to implement more complex questions, some visual customization, and even include some simple relevant expressions and calculations. Your survey is still possible on paper, but in Survey123 it’s sharper and easier to use.
  •   Three bananas means that you’re creating surveys too complex for a paper form (or possible, but incredibly tedious). You might be implementing longer and more complex formulas, using hidden questions and values, and calculations referring to multiple answers that would otherwise have to be done manually.
  •   Four bananas means that you’re pushing the limits of what Survey123 is capable of right now. You’re implementing complex surveys, studying what the XLSForm standard is capable of, and speculating about features that Survey123 doesn’t yet support

 

Right now you can see the banana rating in the Samples that are available in Survey123 Connect.

Samples in Connect show a banana rating

 

New blogs will also use the banana rating to help convey the difficulty, complexity and time to digest for the content.

Star Wars Day Update (May)

“May the Fourth be with you” is a pun first used by Margaret Thatcher’s administration in an advertisement celebrating her election victory. While nothing Star Wars has ever actually been released on the fourth, almost every single Star Wars movie was first released in May; The Force Awakens is the only one so far that wasn’t.

This update contains a lot of behind the scenes work to make the entire Survey123 process run better, as well as a few new features to help in gathering data.

 

Survey123.arcgis.com

Log into http://survey123.arcgis.com to discover an improved look and feel of the Survey123 management console. The survey gallery now shows the number of features submitted to each of your surveys, and the live reporting capabilities have been very much improved with better charts and mapping capabilities. You will also notice that the performance of the web site is significantly better when working with very large surveys (surveys have been tested with over half a million points!).

 

Important Note: Clear your browser cache before you try the new web site.

 

Publishing improvements

Coming up with a good survey is often achieved after some trial and error. Up until this release, the feature service associated with your survey had to be re-created every time you made a change in your survey. We did this to ensure your feature service and its survey were all in sync, but the price you had to pay is that any data captured already in that feature service would be lost.

Starting with this release, Survey123 Connect for ArcGIS will be much more forgiving: At publishing time, Connect will only recreate your feature service when absolutely needed. Here are changes in your survey that you will be able to push without having to re-create your feature service:

  • Changing any of the Settings of your survey including: its thumbnail, title, summary, description, style, map properties or the image size setting
  • Changing values in any of the following columns in your XLS file: Label, Constraint, Calculation, Default, Relevant, Language, Image, Audio, Appearance or Required
  • Deleting questions or choices in lists

The following changes will force Connect to recreate your feature service:

  • Adding new questions or repeats
  • Changing values in the Name, Type, EsriFieldLength or EsriFieldType columns in your XLS file

If you want to learn more details about this, check out this help topic.

 

You will also notice that in the field app, you no longer need to delete old versions of your surveys before you download a new one: simply go into the survey download page and refresh your survey!

 

Working with existing feature services

Survey123 now supports submission_urls, allowing you to link to a valid, preexisting feature service. This field can be defined in the Settings tab of your XLS file and it is pretty handy when you want to collect surveys for an existing ArcGIS for Server feature service. This is a pretty advanced feature, requiring you to fully understand how to build surveys that are compatible with your existing feature services. When a submission_url is used, Survey123 Connect will never validate if your survey questions have corresponding columns in the feature service.

 

Averaging enabled on geopoint questions

Capturing a location with a single position is all well and good, but we wanted to do better. Geopoint questions now have support for averaging a series of positions into one single location.

 

To capture your current location, tap the location button in top right hand corner of the location panel.

 

To start capturing a location built from an average of positions, tap and hold the location button in top right hand corner of location panel. You will see the message appear ‘Averaged 1 of 1 positions (1 second)’.

To stop averaging, tap the location button again. To delete this location and start capturing a new one, tap the location button a third time.

 

If you press the form completion button whilst averaging is happening, you will cancel the current location calculation and the previous location collected will be used.

 

Positional accuracy threshold

Using the new body::accuracyThreshold column title in your XLS file, you can help field users capture more accurate data. The value in this column is expressed in meters. If the device used to capture a position is reporting a positional accuracy that is less than the threshold, then the user will see the geopoint panel be shown in red and include a warning message. Once the positional accuracy is better than the threshold, the title area will go back to normal. Note that the warning does not prohibit you from capturing a location.

 

If averaging positions as described above, any position beyond the threshold will not be used in the location calculation.

 

Better Repeats

Questions inside a repeat can now contain constraints, calculations and required fields.

In the following form, multiple values and connections on a pipeline can be surveyed. The ID of each fitting is calculated to incorporate the pipe ID, and many fields are required.

 

This should not be news to you, but using multiple repeats within a survey is supported as long as you do not nest them. That is, as long as you do not include a repeat, within another repeat.

 

Default values are not yet supported within repeats, but will come in a future release.

 

Other enhancements

Barcode questions now have a minimal appearance option. We will shortly publish a new blog post with more details about this.

 

Bugs have been fixed in the implementation of several questions. Integers will no longer overflow, while decimal fields will no longer take invalid characters. Display bugs have been fixed with time fields with single-digit minute readings, and select one questions now play nice with text scaling.

 

Sign-in and authentication has been improved, with Okta now supported.

 

The user can now rename, rotate and delete photos from the Survey123 field app.

 

Improvements have been made to photo browsing and selection. (iOS and Android)

 

Online help

Our documentation has been constantly improving, and now has a quick reference guide for the Survey123 app and website. The tutorials have also been expanded to provide more step by step details to follow, with a number of other pages also being updated with new information.

 

Download Survey123 Connect (1.4.30) and the field app (1.4.28) now from

http://doc.arcgis.com/en/survey123/download/

Enjoy!

Despite popular belief, International Women’s Day doesn’t commemorate the anniversary of any specific protest, strike, or march. First officially observed in 1914, the date was chosen in honor of a number of significant events in women’s’ rights around that time over the five years previous.

 

Speaking of significant events, we are so excited to introduce our latest update. 

 

This one in particular goes to: Pam Bond, Marie-Lu Labuschange, Travis Butcher, Dustin Toy, RooPit, Carmel Connolly, Eamonn Doyle, Steven Thadius, Eric VanPraag, Scott Moore, Sonoma Land Trust, Daniel Hirner, Jeff Orton, Ronald Knepper and Mike Ruth.

 

Tip: To quickly see some of the new features we describe in this post, download this sample XLS file

and preview it in Connect.

 

Date, time and dateTime questions

 

Many of you wanted us to improve the calendar widget because before it was difficult to navigate, particularly when you wanted to pick dates far back in time. For example a birth date. The new calendar widget allows you to quickly change the year, month and date. You can simply tap on the arrows, or if you prefer you can tap and hold to navigate in time more quickly.  You will also notice that the calendar now looks much better in small devices. The weekdays and month dates are much more legible.

FullCalendar.png

 

When using date or dateTime questions you can also pick the year and month-year appearances. Use year if all you want is for users to pick a year:

 

YearCalendar.png

 

The month-year appearance looks like this.

 

YearMonthCalendar.png

 

Again, either tap once or tap and hold to navigate the years and months back and forth.  You will notice that the new appearances are only present in the new XLSForm templates.

 

Tip: If you have already authored a Survey, do not expect these new appearances to show in Microsoft Excel: you will need to create a new Survey to get these new appearances in the drop-down list in Excel.

 

You will also notice a new user experience for defining time. Time can be set when you use either time or dateTime types of questions.

 

Tip: It is sometimes useful to initialize the date and time controls with the current date and time respectively. You can do so by typing Now() or Today() in the default column of your date, dateTime or time type of questions.

 

 

Likert and distress appearances

 

A likert scale is a rating scale that allows respondents to specify their level of agreement on a symmetrical agree-disagree scale of a statement. The scale is designed to capture the intensity of their feeling for a given item. Likert items should be:

 

  • Symmetrical - They should contain equal numbers of positive and negative positions that are symmetrical around a neutral or zero position (whether or not the zero position is select-able on the scale).
  • Balanced - The distance between each value is the same.

 

Some examples of typical 5 level likert items are as follows:

 

Likert.png

 

The likert appearance only applies to select_one type of questions.

 

Tip: Likert looks very nice in your desktop as well as on tablets, but be aware that the size of screens in phones can quite adversely affect likert.  If you want your survey to look right on phones, you will not want to add many choices, and keep your labels short.  It will take a bit of trial and error to get this right.

 

The distress appearance applies only to integer type of questions and will limit user input values to a scale of 0 to 10. The color scale uses green to indicate good and red to indicate bad. This scale can be used to measure feelings, such as stress, happiness, pain and exertion.

 

Distress.png

 

Create a distress widget in your survey by changing the appearance of an integer question to distress.

For a list of all appearances that can be used in Survey123 see http://doc.arcgis.com/en/survey123/create-surveys/xlsformsappearance.htm.

 

Documentation

 

Our first release of documentation is here: http://doc.arcgis.com/en/survey123  For now, it is only available in English.

 

Portal for ArcGIS

 

A number of issues were addressed specific to Portal for ArcGIS.

 

Website improvements

 

The website at http://survey123.arcgis.com now lets you look at the results of your surveys in map and table view. The summary tab also includes charts that aggregate responses to your questions. The issues some of you experiences while attempting to share or download data should be resolved with new Surveys you publish.

 

Summary.png

 

Performance

 

In our previous update we gave survey loading times a good boost, but we left behind a couple of things that we are including in this release.  Very long lists in select questions now load faster, particularly if you use the minimal appearance. We also added a handy performance counter in Connect that will let you know how much time your Survey takes to load. This will help you validate if specific changes in your survey dramatically improve or penalize the loading times.

 

LoadTime.png

 

Barcode support (use at your own risk)

 

Barcode support has been introduced in this release. You will see this new question type in the new Excel templates and Connect and the App will work with it, but we are not entirely happy with the behavior yet. We know some of you want this feature badly, so we did not want to hide our progress, but be warned that this is still a work in progress.

 

Input masks (use at your own risk)

Input masks have also been introduced in this release. Input masks are used for two purposes. First they will help you format the user input, so it is more legible, but without forcing the user to focus on details such as separators. For example, when recording a time amount of 1 hour and 20 minutes, using an input mask of 99:99 would mean the user could type just the numbers 0120 and the time amount would be displayed as 01:20.

 

Second, input masks can help you validate the input. In the example above, your input mask will ensure that all input from the user is limited to 4 numbers.  In an input mask, a value of 9 forces the user to type a number. A value of 99 forces you to type two numbers etc. For additional details refer to Custom esri columns.

 

Time, currency and scientific values are ideal for input masks. The inclusion of currency symbols, time separators and decimal separators can give the user assistance with what to enter.

 

Tip: Microsoft Excel can get picky when you type certain special characters at the beginning off your input mask. For example, Excel will not like this: $99.99.  This is because the dollar sign has a especial meaning to Excel and it will try to be smart about it. If you need to add a dollar sign in front in your input mask, make sure you add an extra character such as a comma ‘. Excel will ignore your comma and let you do what you want.

 

We have found input masks to work better in iOS than in some Android devices. We are working towards improving the implementation so we ask for your patience.

 

Input masks are used on string expressions only.

 

The following shows an example that uses input mask to assist someone filling in a water sampling record. In this form:

 

  • The users name is forced to start with a capital letter, followed only by lower case letters
  • The site id number is constrained to a specific format of upper case letters
  • The pH values are constrained to start with only 0 or 1 and include 2 decimal places
  • The time value is formatted as hh:mm

 

InputMask.png

Survey123 supports the use of offline basemaps. These basemaps must be of the Esri file type of tile package and web mercator projection. Tile packages can be created using ArcGIS Pro.

 

NOTE: Currently there are many manual steps required to use basemaps in your survey. It is expected that a more streamlined process will be added, but we wanted to make the functionality available as soon as possible. This topic will be updated as the user experience of including basemaps in your survey, evolves.

 

Create a map tile package

You can create a map tile package using ArcGIS Pro. Once created you can copy it directly to your device for use in Survey123 or share it in ArcGIS for others to use.

 

To create a map tile package:

 

  1. Launch ArcGIS Pro.
  2. Open an existing map or create a new map. Ensure your map has a suitable name and description. To edit these, right click the map in the table of contents, and choose properties.
  3. In Toolbox, choose the Create Map Tile Package tool and enter the input map name and the output file name. Input map name and output file name are the minimum requirements for this tool. You can optionally enter other properties.
  4. Run the Create Map Tile Package tool.

 

      A new .tpk will be created in your chosen output location. To use this file in Survey123 you can upload it to ArcGIS to share with others, or manually copy it to your device.

 

Copy your tile package directly to your device

If you do not have internet connectivity or are unable to connect to ArcGIS, you can copy your tile package directly to your device, or use it from an external storage card.

 

To copy your tile package directly to your device:

 

  1. Connect to your device. If you are using an iOS device, you will need to use iTunes.
  2. Copy you .tpk to your ~\ArcGIS\My Surveys\Maps folder. For example, on Windows this would be C:\Users\UserName\ArcGIS\My Surveys\Maps.
  3. If you already had Survey123 open before copying, restart Survey123.

 

To use your tile package from an external storage card:

 

  1. Copy your tile package to your storage card and place the card in your device.
  2. Launch Survey123 on your device and on the My Surveys menu, choose Settings.
  3. Nominate an additional Map Library Folder that represents your storage card. The default path of ~/ArcGIS/My Surveys/Maps will already be shown. You can add additional paths by
    • Typing the additional path directly into the edit box (use a semi colon to separate paths).
    • Use the folder browser to select an additional path. Any path selected will be appended to your Map Library Folder.

 

     When you next open a survey that has the map append property set to true, tile packages on your storage card will be appended to the list of available basemaps.

 

Currently no checking is performed to ensure that Map Library Folders are valid. the first path in the list will used when you choose to download tile packages from ArcGIS Online. The Map Library Folder path will not appear on iOS as external storage is not supported on this platform.

 

Share your tile package

You can share a map tile package in ArcGIS so that you can download it on different devices, or share with other people to use.

 

NOTE: The maximum file size that can be uploaded to ArcGIS Online is 1GB.

 

To share a tile package:

 

  1. Sign in to  http://www.arcgis.com or your Portal for ArcGIS.
  2. Browse to My Contents.
  3. Select Create a new item.
  4. Select From My Computer.
  5. Browse to your tile package and choose to Upload. Be sure not to check the create tile service check-box when uploading your tile package.

 

     After your tile package has been uploaded to ArcGIS online, be sure to copy the URL of this package. An example tile package URL is http://www.arcgis.com/home/item.html?id=221a6aab56804a988a94ec9f82a063e7.

 

Associate a shared tile package to a survey

In order to be able make shared tile packages available to users of a survey, the survey itself needs to know where to download the survey from. This information is stored in the surveys .info file. Currently there is no user interface for this and you must enter text directly into this file. If you already have uploaded your survey to ArcGIS, you will already have a .info file that you can edit. If you have not already uploaded your survey to ArcGIS, you can create a new .info file with the following information.

 

To associate a shared tile package to your survey:

 

  1. Browse to your survey folder on your computer.
  2. Open the file MySurvey.info in a text editor. If you have not already uploaded this survey to ArcGIS, this file will not exist. You can create a new file called MySurvey.info, where MySurvey is the name of your survey.
  3. Copy the follow code snippet into this file and save.
  4. Upload your survey to ArcGIS.

 

   {
     "displayInfo": {
       "map": {
         "mapTypes": {
            "append": false,
            "includeLibrary": false,
            "mapSources": [
               {
                 "url": "http://www.arcgis.com/home/item.html?id=9a7e015149854c35b5eb94494f4aeb89
",
                 "storeInMapLibrary": false
               },
               {
                 "url": "http://www.arcgis.com/home/item.html?id=4497b7bb42e543b691027840d1b9092a"
               }
           ]
         }
       }
     }
   }

 

The following lists the optional properties you can define when managing tile packages in your surveys:

  • append—When you set the append property to equal true, the user will see the list of default online basemaps with your tile package appended at the bottom. When set to false, users will only be able to see the tile packages defined in your MySurvey.info file. The default value is true.
  • includeLibrary—When you set the includeLibrary property to equal true, all tile packages stored on the device will appear in the list of basemaps of the current survey. When set to false, only the basemaps (online or tile packages) defined in the MySurvey.info file will be listed. The default value is true.
  • storeInMapLibrary - Only relevant to tile package map sources. Specifies if the tile package will be stored in the map library or is private to the survey. If includeLibrary is set to false, then tile packages are automatically stored privately and this property will be ignored. The default value is true.

 

Download a shared tile package in Survey123

You can download tile packages for later offline use. Tile packages need to be associated to a survey for you to be able to find them and download.

 

To download a shared tile package:

 

  1. Launch Survey123 and sign in with your ArcGIS named user account.
  2. Select the survey that you associated a tile package too.
  3. Select the menu and choose Download Maps.
  4. Choose the tile package from the list to download.

 

     Once successfully downloaded, you will see the tile package in the list of maps on the location page of your survey.

 

Use a tile package in Survey123

You can use either manually copied tile packages or downloaded shared tile packages in your survey.

 

To use a tile package:

 

  1. Launch Survey123 and sign in with your ArcGIS named user account.
  2. Select the survey that you associated a tile package to.
  3. Choose Collect.
  4. Select the location question and display the full screen map.
  5. Select the menu and choose the tile package.

In Latin America and Spain, every January 5th, all kids go to bed early. The reason? That night, three wise men will visit their homes and leave presents for them. It is a magical night! You can learn more about this tradition here.

 

It looks like we had to wait until this magical night to get our latest update to you. In fact, we pushed our updates early in December for review to Apple, but with the Christmas season it seems like the review process was slower than usual. Anyways, other than minor fixes, this is what our latest update includes:

 

  • Support for offline basemaps: With the latest version of Survey123 Connect and the field app, you can configure your forms to use your own Tile Packages (TPK files). In this manner, end-users of the Survey123 field app will be able to use the map while completely offline. You can create TPK files with your own data, ArcGIS Online basemaps or a combination of both.

 

Essentially, you first create the TPK file in ArcGIS for Desktop and share it in ArcGIS Online or your own Portal for ArcGIS. Then you reference the URL of this TPK file in your own Form and publish the Form.  Using the latest version of the Survey123 field app, you will be able to download the TPK locally and use the map while offline.

 

This geonet blog shows how you can create and use your own TPK files. The process at the moment is completely manual. With this update we just wanted to get the basics in place. Upcoming updates will simplify the process quite a bit.

 

  • Support for OAuth: This feature is key if you ever wanted to use Survey123 with your Enterprise logins.  Survey123 Connect for ArcGIS, the Web site and the Field app now use OAuth.  It is important to note that Survey123 support for OAuth is at the moment only available with ArcGIS Online.  The OAuth capabilities of Survey123 for ArcGIS will work against the upcoming 10.4 update of Portal for ArcGIS.  For Portal for ArcGIS instances prior to 10.4, Esri is planning to make available a small utility to enable Survey123 OAuth support.   This is expected in the next few weeks and we will use this blog to update on its availability.  In any event, if you want to keep using Survey123 for ArcGIS as usual, without OAuth, against your 10.3.1 Portal for ArcGIS, everything will continue working without change.

 

Look out for a documentation website going live in the next few weeks, and our next major update will be focused on survey loading performance.