StreetComplete

From OpenStreetMap Wiki
Jump to navigation Jump to search
StreetComplete
Streetcomplete screenshot v3.4.png
Author Tobias Zwick
License GPL v3 (free of charge)
Platform Android 4.2+
Version 23.0 releases (2020-09-21)
Languages Asturian, Catalan, Czech, Danish, German, Greek, English, British English, Spanish, Basque, Persian, Finnish, French, Galician, Hungarian, Italian, Japanese, Korean, Lithuanian, Malayalam, Norwegian Bokmål, Dutch, Norwegian Nynorsk, Polish, Portuguese, Brazilian Portuguese, Russian, Slovak, Slovenian, Albanian, Swedish, Turkish, Ukrainian, Vietnamese, Chinese (China), and Chinese (Taiwan)
Website GitHub
Install
Source code GitHub
Programming languages Kotlin and Java

Surveyor app for Android

StreetComplete is an Android app which finds wrong, incomplete or extendable data in the user's vicinity. It lists them as easily answered questions, thereby allowing changes to be made directly on site without having to use another editor.

Data issues are presented to the user as markers on a map. They can be solved by filling out a simple form to complete/correct the information. The user's answers are then processed and directly uploaded into the OSM database categorised by quest type in the name of the user's OSM account. Since the app is meant to be used while out and about, it works offline and otherwise aims to be economic with data usage.

The app is aimed at users who do not know anything about OSM tagging schemes but still want to contribute to OpenStreetMap by surveying their neighbourhood (or other places). Because of the target group, the app only presents issues which are answerable very clearly by asking one simple question, and which involve very few false positives. It is also useful for more experienced mappers who can skip creating notes and manual entering data.

FAQ

See the FAQ.

Translations & Bugs

You can help to translate the user interface via POEditor. This help is welcomed, translation is - as usual - part of creating the software where developers especially need help.

Suggestions and bug fixes via GitHub (see the GitHub wiki on how to add new quests to StreetComplete before proposing new quests). Previously, however, have a look on the complete list of all available quests to see whether a quest is already implemented or how it is done.

Quests

See the complete quests list. This is a list of edits that can be done using this editor.

Internals

The app uses Tangram-ES for displaying the map. It queries the Overpass API via Osmapi (Java) to fetch the quests and uploads the answers directly to the OpenStreetMap API.

Offline usage details

Note: to use it offline first connect to the Internet and point it to the area of interest and leave it running, so quests can be downloaded. It has a cache whose size can be varied where it stores tiles of the area so to use it off-line and see the streets it must be used in this way. Cache is stored at disk[1] – but Android system may decide to delete it (happens on phones without plenty of disk space available). Also, viewing location at one zoom level will not cache map for other zoom levels. It stores the answered quests and when an opportunity arises it will silently upload them to OSM. The top shows the number of solved quests.

Build the app

  1. Get the source from GitHub
  2. Open in Android Studio
  3. Run the App on your device or virtual machine

References