StreetComplete

From OpenStreetMap Wiki
Jump to navigation Jump to search
StreetComplete
Streetcomplete screenshot newest.png
Author: Tobias Zwick and contributors
License: GPL v3 (free of charge)
Platform: Android 4.2+
Version: 31.0 releases (2021-03-04)
Languages: Asturian, Catalan, Czech, Danish, German, Greek, English, British English, Spanish, Basque, Persian, Finnish, French, Galician, Croatian, Hungarian, Indonesian, Italian, Japanese, Korean, Lithuanian, Malayalam, Norwegian Bokmål, Dutch, Norwegian Nynorsk, Polish, Portuguese, Brazilian Portuguese, Russian, Slovak, Serbian, Swedish, Turkish, Ukrainian, Vietnamese, Chinese (China), and Chinese (Taiwan)
Website: GitHub
Install:
Source code: GitHub
Programming language: Kotlin

Surveyor app for Android

StreetComplete is an easy to use OpenStreetMap editor for Android phones and tablets, used for mapping in the field.

The app is made specifically for casual contributors and beginners as no prior knowledge about OpenStreetMap (such as tagging schemes) is required to contribute with this app. Furthermore, there is a bit of gamification and statistics that aim to introduce and try to inspire users to venture deeper into the world of OpenStreetMap.

Functionality

The app displays places where data can be added to OpenStreetMap through the app as quest pins on a map. Each of these quests can easily be solved by answering a simple question, like for example "Is this street lit?". The answers given are then processed and directly uploaded into the OSM database in the name of the user's OSM account.

So, unlike most other OSM editors, the actual data is not displayed directly on the map, no POIs can be added or edited directly and no geometry can be changed. Contribution with this app happens exclusively by answering these quests.

Quests

See the quests list for an overview which quests can be solved with this editor.

Additional Features

It is possible to add and contribute to OSM notes with this app. Notes phrased as questions (contain a question mark) are shown to all StreetComplete users, enabling them to add the requested information on-site. Users of this app can directly add photos to notes (since v4.0).

Albeit modification of geometry is in general not possible with this app, it is possible to split ways when the property that is being asked about in a quest does not span the entire highlighted section (since v14.0).

For certain more volatile properties of map features (such as opening hours), users are periodically asked again in certain intervals to verify if the input data is still correct, thus helping to keep the map data up to date (since v23.0). For shops in particular, users can directly specify what is there now in case the shop closed down (since v28.0).

Through contribution with this app, users are able to earn achievements (since v19.0) and look at their contribution statistics with the app. Earned achievements unlock certain links to be added to their link collection within the app. These links mostly serve to either introduce the user to OpenStreetMap or showcase an interesting OpenStreetMap-based project.

The app fully supports Android's night mode, including a dark theme for the displayed map (since v11.0).

After an area has been downloaded, the app is fully usable offline in that area, even after a restart of the app or device. The answers can be uploaded later and in case the data has changed in the meantime, there is smart automatic conflict resolution. (enhanced since v29.0)

FAQ

See the FAQ.

Contributing

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

Suggestions, issue reports, feature requests can be made and other contributions be submitted on GitHub. Before proposing new quest types, please read the guidelines for new quests and see the quests list for an overview which quest types already exist.

Writing code improving StreetComplete and submitting pull requests is also welcomed - see "Contributing" file for more info.

The author of the app also accepts donations, see the project home on GitHub for more information.

Internals

The app uses Tangram-ES for displaying the map.

It directly uses the OpenStreetMap API (via Osmapi (Java)) to download the data and upload the answers. Up till before v26.0, the Overpass-API was used for download.

See also

  • Vespucci - fully featured editor for Android with full and direct access to OSM data. But more complicated to use.