Field survey

Field surveys are completed in the Toloka mobile apps (Android and iOS). A user choses a point on the map, user choses a point on the map to come, 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 user has to upload two or more photos, check if there are some food and assess the feeder condition.

To release tasks for completion and get responses:

Create a project

A project describes the task design for a user.

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

  2. Give a clear name and a short description to the project. Users will see them in the task list.

  3. Write short and comprehensive guidelines. Use HTML tags to insert links, pictures, etc. Guidelines for fields survey should be designed for mobile device.
  4. In the template, the Map option is preset. So a user will see tasks as points on the map and be able to chose any.

    When chosen, the task's Title and Description will be displayed. These strings contain an input field and are to be changed further.

  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 user will get and return. To do this, add input and output fields in the Specifications block.
    There are three predefined fields:
    • Input field name, a string for the point name.
    • Output fields:
      • photo, an array of photos uploaded by a user;
      • comment, a string for a user's comment.
    Add four fields:
    • Input field description, a string for a point location.
    • Output fields:
      • food, a boolean for the answer to the checkbox question;
      • condition, an optional string or the answer to the radio button question;
      • user-coordinates, an optional coordinates field. To save the user coordinates, enable the Current location option.
  7. The Task interface block defines how objects are arranged. The template has preset styles CSS and JavaScript functions, leave them unchanged.

    In the HTML block, you can use standard HTML tags and special components, enclosed in double curly brackets, for input and output data fields.

    <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 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 class="plate__field">
        {{field type="checkbox" name="food" label="Is there some food for a squirrel?"}}
      <div class="plate__field">
        {{field type="radio" name="condition" value="good" label="The feeder's in good keep"}}
        {{field type="radio" name="condition" value="repair" label="The feeder needs some repair"}}
        {{field type="radio" name="condition" value="replace" label="The feeder should be replaced"}}
      <div class="plate__field">
        <div class="field__title">Comment</div>
        <div class="field__content">{{field type="textarea" name="comment" width="100%"}}</div>
    This notation describes the task design:
    • The place's name and description (location).
    • A button to upload photos, they will be saved in the photo file array.
    • A checkbox, the value (true or false) will be written in the food field.
    • Three radio buttons, the choice will be written in the condition field.
  8. Click the Preview button to see the task as a user.
    Примечание. In the projects preview, there are four tasks with standard input data. The number of tasks on page will be set further.
  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. They are available to you and a user will see only the project name and description.
  3. Set the price per a task page, for instance $0.2. For a field survey put one task on a page.
  4. Set the Time a user will have to complete all task on the page. It should be enough to reach the location,find the spot, make photos and upload them. For a field survey set 24 hours, i.e. 86,400 seconds.
  5. Set the Overlap, the number of users to complete the same task. For a field survey, 1 is гыгфддн enough.
  6. Enable the Offline accept and specify in the Deadlinefields how many days you will review assignments. For example, 7.
  7. Add Filters to select performers. To make your task available for English-speaking users in your city, set Languages = English and Region by IP = <city name>.
  8. Save the pool.

Upload tasks

  1. Download File example for task uploading (tsv) in the pool.
  2. Add input data to the file. The headings of input columns contain INPUT. For a field survey you should also add the point coordinates in AI:latitude and AI:longitude. Use Yandex.Maps to learn them.
  3. Upload tasks using the Set manually option and set 1 task on the page.

Launch the pool and get results

  1. Click to send tasks out for completion.
  2. Track the completion of tasks in the Pool statistics block.
  3. When first assignments come, you can reviewing. After the Deadline expire, assignments that have not been reviewed are automatically approved.

    To review assignments, click Download results. To download all files in submitted assignments, click  → Download attachments.