Monitor outdoor items of interest

Tip.

Run the project in the Sandbox first. This helps you avoid making mistakes and spending money on a task that isn't working right.

  1. Create a project
  2. Add a task pool
  3. Upload tasks
  4. Start the pool and get the results

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

You may need additional projects for your task, such as dataset pre-check or checking performers' responses. Learn more about this in Decomposition of the task.

You may need additional settings for your project, like to add a new button with a particular scenario or a section for attaching files. Learn more in Customization examples.

Use the “Monitoring outdoor objects of interest” template when you need to:

  • Monitor equipment quality and condition.

  • Check if equipment is installed at a particular address.

Let's say you need to check if certain facilities or equipment are available outdoors.

To do this, create the following task for performers: go to the location, photograph the facilities from different angles, and take photos of the address sign. If the facilities are not available, photos are needed as proof. If there is no access to the facilities, take a picture of the surroundings and indicate the reason.

To run tasks and get responses:

Create a project

The project defines what the task will look like for a performer.

  1. Choose a template:

    1. Click Create project.

    2. Select the Monitoring field objects template in the Spatial Crowdsourcing block.

  2. Provide general information:

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

    2. Optionally add a Private comment.

    3. Click Save.

  3. Edit the task interface in the editor you selected:

    Template Builder
    HTML/CSS/JS editor
    1. The task interface describes how the elements should be arranged in the task.

      Use the ready-made code for this project with pre-configured validation and task layout.

      The performer won't be able to submit the response until they:

      • Are within 50 meters of the specified location.

      • Select one of the three task completion options.

      • Upload photos of the object or photos confirming that it is missing.

      • Write a comment if there's no access to the object.

    2. To specify what data you will pass to the performer and receive in response, create input and output data fields.

      What are input and output data?

      Input data is 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 is 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.

      Input data fields are created from the code on the Example of input data tab.

      The output data fields depend on the components that use data.output and values supported by it.

      Click Show specifications to see the input and output data fields.

      Learn more about input and output data fields in the Template Builder Help.

      In this project:

      • Input data fields:

        • name — A string with the name of the organization.

        • image — A link to object image.
        • address — A string with the task address.
        • product — A string with the object description.
        • coordinates — Coordinates of the point that the performer should go to.
      • Output data fields:

        • address — A string with the task address.
        • comment — A string for the performer's comment.
        • verdict — A string with the task completion status.
        • imgs_obj — Array of files with photos of the object uploaded by the performer.
        • more_info — JSON object with additional information about the object.
        • coordinates — A string with the task coordinates.
        • imgs_address — Array of files with photos of the address sign uploaded by the performer.

        • imgs_around_obj — Array of files with photos of the object surroundings uploaded by the performer.
        • worker_coordinates — The performer's coordinates at the moment of task completion, with the Current location option turned on.
        • imgs_around_no_access— Array of files with photos of the surroundings if there's no access to the object uploaded by the performer.
    3. The Settings for displaying field tasks block is used to help the performer distinguish one task from another when they select a task on the map. In this project, the Header format and Short description format fields contain links to the input data fields to show the point's name and address. You can leave these fields unchanged or write something else in them.

    4. Click Save.
    1. The task interface describes how the elements should be arranged in the task.

      In the HTML interface, use the standard HTML tags and special expressions in double curly brackets for input and output data fields.

      For this project, leave the HTML, JS, and CSS blocks unchanged.

      JS is used to describe the task logic. In addition, the main content of this task is embedded in JS for ease of editing.

      The template logic specifies a minimum number of photos of the object, its surroundings, and, if there is no access to the object, the photos of the surrounding area and the address sign. If you want to change these values, find all strings and change the minimum number of photos for each task completion option:

      if (solution.output_values.imgs_obj.length < 4)
      if (solution.output_values.imgs_around_obj.lrngth < 4)
      if (solution.output_values.imgs_around_no_access.length < 4)

      In this project, the texts variable stores the texts for the information block and three variants of the task completion option: I found the object; I'm on the spot, but there is no object; There is no access to the object.

      The MAX_DISTANCE variable specifies the maximum distance from the designated point (in kilometers by default) that the performer must stay within during task completion. You can specify whatever value you prefer.

      You can change the number of radio buttons for options. To do this, add or delete an object that looks like this:

      {   'name': 'more_info.radio',   'value': 'radio_1',   'label': 'Option 1'}

      where name is the output data path, value is the value of a separate radio button in the output data, and label is the name displayed in the template.

      You can change the number of checkboxes. To do this, add or delete an object that looks like this:

      {   'name': 'more_info.checkboxes.checkboxe_1',   'label': 'Option 1' }

      where name is the output data path, and label is the name displayed in the template. The checkbox value is true/false.

    2. In the Data specification section, you can configure the input and output data fields.

      What are input and output data?

      Input data is 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 is 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.

      In this project:

      • Input data fields:

        • name — A string with the name of the organization.

        • image — A link to object image.
        • address — A string with the task address.
        • product — A string with the object description.
        • coordinates — A string with the coordinates of the point that the performer should go to.
      • Output data fields:

        • address — A string with the task address.
        • comment — A string for the performer's comment.
        • verdict — A string with the task completion status.
        • imgs_obj — Array of files with photos of the object uploaded by the performer.
        • more_info — Additional information about the object (JSON type).
        • coordinates — A string with the task coordinates.
        • imgs_address — Array of files with photos of the address sign uploaded by the performer.

        • imgs_around_obj — Array of files with photos of the object surroundings uploaded by the performer.
        • worker_coordinates — The performer's coordinates at the moment of task completion, with the Current location option turned on.
        • imgs_around_no_access— Array of files with photos of the surroundings if there's no access to the object uploaded by the performer.
    3. The Settings for displaying field tasks block is used to help the performer distinguish one task from another when they select a task on the map. In this project, the Header format and Short description format fields contain links to the input data fields to show the point's name and address. You can leave these fields unchanged or write something else in them.

    4. Click to see the performer's view of the task.

      Note. The project preview shows one task with standard data. You can define the number of tasks to show on the page later.
    5. To exit preview mode, click Exit in the lower-left corner.

    6. Click Save.

  4. Write short and clear instructions. Describe what needs to be done and give examples.

    You can prepare instructions in HTML format, then copy and paste into the editor. Click <> to switch to HTML mode.

    Field task instructions should be easy to read on a mobile phone screen.

  5. To go back to the Projectspage, click Finish.

Learn more in the Project section

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.
  2. Give the pool any convenient name and description. 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 tasks, always add one task per suite.
    What is a task suite?

    A task suite can contain one or several tasks that are shown on the same page. If the tasks are simple, you can add 10-20 tasks per suite. Don't make task suites too long because it slows down loading speed for performers.

    Performers get paid for completing the entire task suite.

    The number of tasks per suite is set when uploading tasks.

    What is a fair price for a task suite?

    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, or see examples of cost for different types of tasks.

  4. Set the Time allowed for completing a task suite. It should be enough to get to the place, find the specified point and upload photos. For field tasks, we recommend allocating a day — 86,400 seconds.
  5. Set Overlap, which is the number of performers to complete the same task. For field tasks, it is usually 1.
  6. Turn on the Non-automatic acceptance option and enter the number of days for checking the task in the Deadline field (for example, 7).
    What is non-automatic acceptance (assignment review)?

    The non-automatic acceptance option allows you to review completed assignments before accepting them and paying for them. If the performer didn't follow instructions, you can reject the assignment. The maximum allowed period for the review is set in the Deadline field.

  7. Add Filters to select 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. Click Upload. In the window that opens, you can also download a sample TSV file by clicking Sample file for uploading tasks.

    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. There is a CSV format that is similar to TSV, but you should use a TSV file for uploading.
    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 tasks, you also need to specify the latitude AI:latitude and longitude AI:longitude of the point. You can use a service like 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. Track the completion of tasks in the Pool statistics section.
  3. When the first results come in, you can start reviewing.

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

    Note. After the specified time period, all responses are automatically accepted, regardless of their quality.