Photos of organizations

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

Walking (field) surveys are completed in the Toloka mobile apps for Android and iOS. They get a task with a point on the map where they need to come and take a photo (or, for example, check for anything).

This template helps solve such tasks as:

  • Get the information you need: address, phone numbers, signs, opening hours, location, and so on.
  • Check how easy it is to find an organization/ store.
  • Verify the information with a photo of the real object.

Let's say you need to check if there is a building at a specific address. To do this, create a task where the performer:

  1. Comes to a point by coordinates.
  2. Photographs the building from all sides.
  3. Also takes a photo of the address plate.
    Tip. If there is no sign at this address, the performer should take a photo of a neighboring building sign and write this in the task.
Example of a prepared task

To run tasks and get responses, follow the instructions.

Create a project

In the project, you define what the task will look like for the performer.

  1. Click the + Create a project button and choose the Secret shopper template in the field task block.

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

  3. Write a brief and clear instruction (see Recommendations) or edit the existing one.

    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.

    Address and Coordinates will be displayed when the performer chooses a point on the map. These fields contain an input field It will be changed later.

  5. To show the name and description of the point, edit the fields:

    • Address: {{inputParams['address']}}.
    • Coordinates: {{inputParams['coordinates']}}.
  6. Note. This tutorial shows how to create a task interface in the HTML/JS/CSS editor. You can also try creating a task interface in the Template Builder.
    Define which objects you are going to pass to the performers and which one you want to receive from them in response. To do this, add input and output fields in the Specifications block.
    What are input and output data?

    Input — Types of objects the performer receives for the task completion. In this template, you need text. In other tasks, it can be a picture or geographical coordinates.

    Output data is types of objects that you receive after the task is completed. For this template, it is one of the two response options. If the performer chooses the second response, a list of checkboxes opens — the performer should choose appropriate options from them. In other tasks, the output data can contain entered text or an uploaded file, for example.

    Learn more about input and output data fields.

    The template includes:

    • Input data — fields:
      • address — The task address.
      • coordinates — Coordinates of the point where toloker should come.
    • Output data — fields:
      • worker_coordinates — The performer coordinates at the moment of task completion, with the Current location option turned on.
      • address — The task address.
      • coordinates — The task coordinates.
      • imgs_address — Array of files, photos of the plate uploaded by the performer.
      • imgs_facade — Array of files, photos of the house uploaded by the performer.
      • address_type — The type of plate photographed by the performer (the plate on the desired or neighboring house).
      • comment — Text field, performer's comment.
  7. Create the task interface in the HTML block. It describes how the task elements should be arranged in the task.

    Rules for working with the task interface in the Photos of organizations template

    • The HTML interface uses standard HTML tags and special components in double (or triple, as for the comment field) curly brackets for input and output data fields.
    • CSS and JS are used to describe the task logic. Also, the main content of this task is embedded in Java Script for ease of editing.
    • In this project, in a variable texts texts are stored for the block with information and two text variants for task completion (in case the performer found or didn't find home).
    • The MAX_DISTANCE variable specifies the maximum distance from a designated point, where the toloker can move during the task completion, in kilometers. Specify the appropriate value.
    • In this template, at least four photos of the building is required. If you want to change this, enter any other number instead “ 4”:
    • if (solution.output_values.imgs_facade.length < 4)
    Note. The template already contains CSS styles, you don't need to change them.
  8. Click Preview to view your task.

    The project preview window shows a single task with standard data. You can define the number of tasks to show on the page later.

  9. Save the project by clicking Finish editing.

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 surveys, always add one task per page.
    What is a task suite?

    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 because it slows down loading speed for performers.

    Performers get 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 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 surveys, we recommend allocating a day — 86,400 seconds.
  5. Set Overlap, which is the number of performers to complete the same task. For field surveys, 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 task suites 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 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 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. 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.