mapcomplete/Docs/URL_Parameters.md

248 lines
6.3 KiB
Markdown
Raw Normal View History

2023-02-12 23:08:57 +01:00
[//]: # (WARNING: this file is automatically generated. Please find the sources at the bottom and edit those sources)
2022-02-14 04:59:49 +01:00
URL-parameters and URL-hash
2021-11-30 22:45:25 +01:00
=============================
2022-02-14 04:59:49 +01:00
## Table of contents
2021-11-30 22:45:25 +01:00
2021-11-30 22:50:48 +01:00
1. [URL-parameters and URL-hash](#url-parameters-and-url-hash)
2022-02-14 04:59:49 +01:00
- [What is a URL parameter?](#what-is-a-url-parameter)
2023-07-16 02:45:57 +02:00
- [language](#language)
2022-04-03 03:49:09 +02:00
- [fs-translation-mode](#fs-translation-mode)
2023-06-11 23:12:03 +02:00
- [backend](#backend)
- [fake-user](#fake-user)
2022-06-19 22:13:38 +02:00
- [fs-userbadge](#fs-userbadge)
- [fs-search](#fs-search)
- [fs-background](#fs-background)
- [fs-filter](#fs-filter)
- [fs-add-new](#fs-add-new)
- [fs-welcome-message](#fs-welcome-message)
2023-03-08 19:17:03 +01:00
- [fs-community-index](#fs-community-index)
2022-06-19 22:13:38 +02:00
- [fs-iframe-popout](#fs-iframe-popout)
- [fs-more-quests](#fs-more-quests)
- [fs-share-screen](#fs-share-screen)
- [fs-geolocation](#fs-geolocation)
- [fs-all-questions](#fs-all-questions)
- [fs-export](#fs-export)
- [test](#test)
- [debug](#debug)
- [overpassUrl](#overpassurl)
- [overpassTimeout](#overpasstimeout)
- [overpassMaxZoom](#overpassmaxzoom)
- [osmApiTileSize](#osmapitilesize)
- [background](#background)
- [layer-<layer-id>](#layer-&ltlayer-id>)
2022-02-14 04:59:49 +01:00
This document gives an overview of which URL-parameters can be used to influence MapComplete.
2021-11-30 22:45:25 +01:00
2022-02-14 04:59:49 +01:00
What is a URL parameter?
2021-11-30 22:45:25 +01:00
--------------------------
"URL-parameters are extra parts of the URL used to set the state.
2022-02-14 04:59:49 +01:00
For example, if the url is `https://mapcomplete.osm.be/cyclofix?lat=51.0&lon=4.3&z=5&test=true#node/1234`, the URL-parameters are stated in the part between the `?` and the `#`. There are multiple, all separated by `&`, namely:
- The url-parameter `lat` is `51.0` in this instance
- The url-parameter `lon` is `4.3` in this instance
- The url-parameter `z` is `5` in this instance
- The url-parameter `test` is `true` in this instance
Finally, the URL-hash is the part after the `#`. It is `node/1234` in this case.
2021-11-08 02:36:01 +01:00
2023-07-16 02:45:57 +02:00
language
----------
The language to display MapComplete in.
The user display language is determined in the following order:
- If the user did log in and did set their language before with MapComplete, use this language
2023-07-16 02:50:02 +02:00
- If the user visited MapComplete before and did change their language, use the language as set by this URL-parameter. This will _disable_ saving the language to localStorage in case a non-logged-in user changes their language
2023-07-16 02:45:57 +02:00
- Use the navigator-language (if available)
- Use English
2023-07-16 02:50:02 +02:00
Note that this URL-parameter is not added to the URL-bar by default.
2023-07-16 02:45:57 +02:00
Translations are never complete. If a translation in a certain language is missing, English is used as fallback. No default value set
2023-06-11 23:12:03 +02:00
fs-translation-mode
---------------------
2022-04-03 03:49:09 +02:00
2023-06-11 23:12:03 +02:00
If set, will show a translation button next to every string. The default value is _false_
2022-04-03 03:49:09 +02:00
2023-06-11 23:12:03 +02:00
backend
---------
2022-04-03 03:49:09 +02:00
2023-06-11 23:12:03 +02:00
The OSM backend to use - can be used to redirect mapcomplete to the testing backend when using 'osm-test' The default value is _osm_
2022-06-19 22:13:38 +02:00
2023-06-11 23:12:03 +02:00
fake-user
-----------
2022-06-19 22:13:38 +02:00
2023-06-11 23:12:03 +02:00
If true, 'dryrun' mode is activated and a fake user account is loaded The default value is _false_
2022-06-19 22:13:38 +02:00
fs-userbadge
--------------
Disables/Enables the user information pill (userbadge) at the top left. Disabling this disables logging in and thus disables editing all together, effectively putting MapComplete into read-only mode. The default value is _true_
fs-search
-----------
Disables/Enables the search bar The default value is _true_
fs-background
---------------
Disables/Enables the background layer control The default value is _true_
fs-filter
-----------
Disables/Enables the filter view The default value is _true_
fs-add-new
------------
Disables/Enables the 'add new feature'-popup. (A theme without presets might not have it in the first place) The default value is _true_
fs-welcome-message
--------------------
Disables/enables the help menu or welcome message The default value is _true_
2023-03-08 19:17:03 +01:00
fs-community-index
--------------------
Disables/enables the button to get in touch with the community The default value is _true_
2022-06-19 22:13:38 +02:00
fs-iframe-popout
------------------
Disables/Enables the extraLink button. By default, if in iframe mode and the welcome message is hidden, a popout button to the full mapcomplete instance is shown instead (unless disabled with this switch or another extraLink button is enabled) The default value is _true_
fs-more-quests
----------------
Disables/Enables the 'More Quests'-tab in the welcome message The default value is _true_
fs-share-screen
-----------------
Disables/Enables the 'Share-screen'-tab in the welcome message The default value is _true_
fs-geolocation
----------------
Disables/Enables the geolocation button The default value is _true_
fs-all-questions
------------------
Always show all questions The default value is _false_
fs-export
-----------
2023-05-08 00:20:32 +02:00
Enable the export as GeoJSON and CSV button The default value is _true_
2022-06-19 22:13:38 +02:00
test
------
If true, 'dryrun' mode is activated. The app will behave as normal, except that changes to OSM will be printed onto the console instead of actually uploaded to osm.org The default value is _false_
debug
-------
If true, shows some extra debugging help such as all the available tags on every object The default value is _false_
overpassUrl
-------------
Point mapcomplete to a different overpass-instance. Example: https://overpass-api.de/api/interpreter The default value is _https://overpass-api.de/api/interpreter,https://overpass.kumi.systems/api/interpreter,https://overpass.openstreetmap.ru/cgi/interpreter_
overpassTimeout
-----------------
Set a different timeout (in seconds) for queries in overpass The default value is _30_
overpassMaxZoom
-----------------
point to switch between OSM-api and overpass The default value is _16_
osmApiTileSize
----------------
Tilesize when the OSM-API is used to fetch data within a BBOX The default value is _17_
background
------------
The id of the background layer to start with The default value is _osm_
layer-<layer-id>
------------------------
Wether or not the layer with id <layer-id> is shown The default value is _true_
2021-11-08 02:36:01 +01:00
2023-02-12 23:08:57 +01:00
This document is autogenerated from [Logic/Web/QueryParameters.ts](https://github.com/pietervdvn/MapComplete/blob/develop/Logic/Web/QueryParameters.ts), [UI/QueryParameterDocumentation.ts](https://github.com/pietervdvn/MapComplete/blob/develop/UI/QueryParameterDocumentation.ts)