Field survey

Field surveys are completed in the Toloka mobile apps for Android and for iOS. A performer chooses a point on the map where they need to go to check something and take photos.

Suppose you want to check the condition of squirrel feeders.

To have this done, you should create a task as follows: a performer has to upload two or more photos, check if there is any food and assess the feeder condition.

Example of a prepared task

To release tasks for completion and get responses:

Create a project

A project describes the task design for a performer.

  1. Click the + Create a project button and choose the Field mission template.

  2. Enter a clear name and a short description for the project. Performers will see them in the task list.

  3. Write short and comprehensive instructions (see recommendations). Use HTML tags to insert links, pictures, and so on. Instructions for the field survey should be easy to read, even on a mobile phone screen.
  4. In the template, the Map option is enabled automatically. So a user will see tasks as points on the map and be able to choose any.

    When chosen, the task's Title and Description are displayed. These fields contain an input field that will be changed later.

  5. To show the name and description of the point, edit the fields:
    • Name: {{inputParams["name"]}}.
    • Description: Location: {{inputParams["description"]}} .
  6. Define the objects a performer will get and return. To do this, add input and output fields in the Specifications block.
    What are input and output data?

    Input data are types of objects that are passed to the performer for completing the task. For example, this could be a text, an image, or geographic coordinates.

    Output data are types of objects that you receive after the task is completed. For example, this could be one of several response options, typed text, or an uploaded file.

    More on input and output data fields.

    The template includes the fields:
    • Input data field — The name string for the point name.
    • Output data fields:
      • photo array of files — The photos that the performer will upload.
      • comment string — A comment by the performer.
    Add several new fields:
    • Input data field — The description field for sending the location details.
    • Output data fields:
      • food — A boolean to save the value of the “Is there food in the feeder?” checkbox.;
      • condition — An optional string to save the value of the feeder condition.
      • worker-coordinates — An optional coordinates field. To record the performer's coordinates to it automatically, turn on the Current position option.
  7. The task interface describes how the task elements should be arranged in the task. The template already contains CSS styles and JavaScript functions. You don't need to change them.

    You can use standard HTML tags and special expressions in double curly brackets for input and output data fields in the HTML block.

    <div class="task__plate">
      <div class="plate__field">
        <div class="field__title">Location</div>
        <div class="field__content">{{name}}</div>
        <div class="field__content">{{description}}</div>
      </div>
    
      <div class="plate__field plate__field_photo">
        <div class="field__title">Photo</div>
        <div class="field__content">{{field type="file-img" name="photo" camera=true preview=true validation-show="top-center"}}</div>
      </div>
      <div class="plate__field">
        {{field type="checkbox" name="food" label="Is there food in the feeder?"}}
      </div>
      <div class="plate__field">
        {{field type="radio" name="condition" value="good" label="The feeder is OK"}}
        {{field type="radio" name="condition" value="repair" label="Needs repairing"}}
        {{field type="radio" name="condition" value="replace" label="Needs new feeder"}}
      </div>
      <div class="plate__field">
        <div class="field__title">Comment</div>
        <div class="field__content">{{field type="textarea" name="comment" width="100%"}}</div>
      </div>
    </div>
    
    This notation describes the following task design:
    • Name name and location description.
    • Button for uploading photos that will be recorded in the photo file array.
    • A checkbox with the value (true or false) output to the food field.
    • Three radio buttons with the chosen value output to the condition field.
  8. Click the Preview button to see the task as a performer.
    Note. The preview shows four tasks with standard data. You can define the number of tasks to show on the page later.
  9. Save the project.

Add a task pool

A pool is a set of paid tasks sent out for completion at the same time.

  1. Open the project and click Add pool → Add pool.
  2. Give any name and description to the pool. The pool info is only available to you. Performers can view only the project name and description.
  3. Set the price per task, for example $0.2. For field surveys, always add one task per page.
    What is a task page?

    A page can contain one or several tasks. If the tasks are simple, you can add 10-20 tasks per page. Don't make pages too long, as it slows down the performer's download speed.

    The performer gets paid for completing the whole page.

    The number of tasks on the page is set when uploading tasks.

    What is the fair price for a task page?

    The general rule of pricing is the more time the performer spends to complete the task, the higher the price is.

    You can register in Toloka as a performer and find out how much other requesters pay for tasks.

  4. Set the Time allowed for completing a task page. It should be enough to get to the place, find the specified point and upload photos. For field surveys, we recommend allocating a day — 86,400 seconds.
  5. Set an Overlap, which is the number of performers to complete the same task. For field surveys, it is usually 1.
  6. Turn on the Offline accept option and enter the number of days for checking in the Deadline field. For example, 7.
    What is offline accept?

    The offline accept option allows you to review the completed tasks before accepting them and paying for them. If the performer didn't follow instructions, you can reject the task. The maximum allowed period for the review is set in the Deadline field.

  7. Add Filters to choose performers. To make your tasks available in the Toloka mobile app to English-speaking performers located in Moscow, set the language and region.
  8. Save the pool.

Upload tasks

  1. Download the File example for task uploading (tsv) in the pool.
    What is TSV?
    A TSV file presents a table as a text file in which columns are separated by tabs.
    You can work with it both in a table editor and a text editor, and then save it to the desired format. More about working with a TSV file.
    Note. Before uploading the file, make sure it is saved in UTF-8 encoding.
  2. Add input data in it. The header of the input data column contains the word INPUT. For field surveys, you also need to specify the latitude AI:latitude and longitude AI:longitude of the point. For instance, you can use Yandex.Maps to get the coordinates.
  3. Upload the tasks by choosing Set manually and set 1 task per page.

Start the pool and get the results

  1. Start the pool by clicking .
  2. Monitor the progress in the Pool statistics block.
  3. When the first results come in, you can start reviewing. When the deadline expires, all responses are automatically accepted, regardless of the quality of the response.

    To review assignments, go to the pool and click Download results. To download attachments, click the button next to and choose Download attachments.