Field task — Step-by-step instructions
The challenge

In this example, we will work with field tasks. Field tasks are available for performers only in Toloka mobile apps. Requesters set the field tasks, and performers choose them as points on the map. In this case, we ask performers to visit Moscow metro entrances and take pictures of them. These pictures can be used for monitoring if the entrance is tidy enough or needs cleaning. 

Data preparation
In most cases, field tasks are tied to a specific point on the map. This point is described with coordinates (i.e. 55.756916, 37.614546). These are latitude and longitude geographic coordinates expressed as decimal fractions of a degree.

Video: 5 basic steps to run a project
Create
a project
Create
a task pool
Upload a file
with data
Launch
the pool
Get the
results

Create a project

Interface code

{
  "view": {
    "validation": {
      "conditions": [
        {
          "hint": "Couldn't get your coordinates. Please enable geolocation.",
          "data": {
            "path": "performer_coordinates",
            "type": "data.output"
          },
          "type": "condition.required"
        },
        {
          "hint": "You are too far from the entrance.",
          "from": {
            "type": "@yandex-toloka/data.location"
          },
          "to": {
            "path": "coordinates",
            "type": "data.input"
          },
          "max": 500,
          "type": "@yandex-toloka/condition.distance"
        }
      ],
      "type": "condition.all"
    },
    "items": [
      {
        "content": "# Cleanliness at the entrance to the metro:\n---",
        "type": "view.markdown"
      },
      {
        "label": "Entrance name:",
        "content": {
          "path": "entrance",
          "type": "data.input"
        },
        "type": "view.text"
      },
      {
        "data": {
          "path": "verdict",
          "type": "data.output"
        },
        "validation": {
          "hint": "Choose one of the answer options",
          "type": "condition.required"
        },
        "options": [
          {
            "label": "I found the right entrance",
            "value": "ok"
          },
          {
            "label": "The required entrance is not there",
            "value": "no_obj"
          }
        ],
        "type": "field.button-radio-group"
      },
      {
        "condition": {
          "to": "ok",
          "data": {
            "path": "verdict",
            "type": "data.output"
          },
          "type": "condition.equals"
        },
        "then": {
          "items": [
            {
              "content": "** Photos of the entrance from the right and left sides **\n\n_Take two photos of the entrance on the right and on the left. The photo should show the entire entrances and the floor. So that you can assess the cleanliness around the entrance to the metro._",
              "type": "view.markdown"
            },
            {
              "links": [
                {
                  "content": "Example1",
                  "url": "https://tlk.s3.yandex.net/toloka-kit/images_for_instructions/0spatial_good1.png"
                },
                {
                  "content": "Example2",
                  "url": "https://tlk.s3.yandex.net/toloka-kit/images_for_instructions/0spatial_good2.png"
                },
                {
                  "content": "Example3",
                  "url": "https://tlk.s3.yandex.net/toloka-kit/images_for_instructions/0spatial_good3.png"
                }
              ],
              "type": "view.link-group"
            },
            {
              "data": {
                "path": "entrance_images",
                "type": "data.output"
              },
              "validation": {
                "hint": "There must be at least 2 photos of the entrance: from the right and from the left",
                "type": "condition.required"
              },
              "accept": {
                "gallery": true,
                "photo": true
              },
              "multiple": true,
              "type": "field.media-file"
            }
          ],
          "type": "view.list"
        },
        "type": "helper.if"
      },
      {
        "condition": {
          "to": "no_obj",
          "data": {
            "path": "verdict",
            "type": "data.output"
          },
          "type": "condition.equals"
        },
        "then": {
          "items": [
            {
              "content": "**Take 4 photos in all directions**\n\n_So that we can understand where you are and that there is no entrance to the metro here._",
              "type": "view.markdown"
            },
            {
              "data": {
                "path": "around_images",
                "type": "data.output"
              },
              "validation": {
                "hint": "There must be at least 4 photos of the place",
                "type": "condition.required"
              },
              "accept": {
                "gallery": true,
                "photo": true
              },
              "multiple": true,
              "type": "field.media-file"
            }
          ],
          "type": "view.list"
        },
        "type": "helper.if"
      }
    ],
    "type": "view.list"
  },
  "plugins": [
    {
      "layout": {
        "kind": "scroll",
        "taskWidth": 400
      },
      "type": "plugin.toloka"
    },
    {
      "action": {
        "data": {
          "path": "performer_coordinates",
          "type": "data.output"
        },
        "payload": {
          "type": "@yandex-toloka/data.location"
        },
        "type": "action.set"
      },
      "fireImmediately": true,
      "type": "plugin.trigger"
    }
  ]
}

Create a task pool

Upload a file with data

Dataset
Prepare a TSV file with tasks as shown in our example.
License: CC BY 4.0

Launch the pool

Get the results

Automated review

Another way to review tasks is to ask other performers to do that. We recommend this option when you have limited resources for checking tasks yourself.

  • Create an image classification project based on our demo
  • After the answers are collected, go back to the initial pool and upload review results on the Review assignments page
  • The file should contain the acceptance verdict and a comment. A template can be found in the Download results section
Application for corporate training
We are offering corporate training to help you solve existing challenges and develop
an internal team of Crowd Science Architects (CSA).
Thu Sep 09 2021 12:56:37 GMT+0300 (Moscow Standard Time)