Good Map
Map engine to serve all the people ;)
Setup
0. Clone the repo
git clone --recursive
Remember, everytime you want to pull the newest changes, run:
git pull
git submodule update
because goodmap contains a submodule.
#TODO remove all submodule connected instructions after removing platzky submodule (see #157)
1. Use python 3.10
If you have a different version of Python on your system, install python 3.10 alongside. For that, you can use pyenv. Follow the documentation. Useful commands: pyenv help <command>, pyenv install, pyenv shell, pyenv versions.
2. Install poetry in Python 3.10
poetry can create virtual environments associated with a project.
Make sure you are in the Python 3.10 environment and install:
pip install poetry
Useful commands: poetry -h <command>, poetry env list, poetry env info.
3. Install dependencies
poetry install
4. You're ready
When you enter the project directory, you can invoke any commands in your project like this:
poetry run <command>
Running App locally
TL;DR
If you don't want to go through all the configuration, e.g. you just simply want to test if everything works,
you can simply run app with test dataset provided in examples directory:
poetry run flask --app 'goodmap.goodmap:create_app(config_path="./examples/e2e_test_config.yml")' run
Configuration
If you want to serve app with your configuration rename config-template.yml to config.yml and change its contents according to your needs.
Afterwards run it with:
poetry run flask --app 'goodmap.goodmap:create_app(config_path="/PATH/TO/YOUR/CONFIG")' --debug run
| Option | Description |
|---|---|
| USE_LAZY_LOADING | Loads point data only after the user clicks a point. If set to false, point data is loaded together with the initial map. |
| FAKE_LOGIN | If set to true, allows access to the admin panel by simply selecting the role instead of logging in. DO NOT USE IN PRODUCTION! |
| SHOW_ACCESSIBILITY_TABLE | If set as true it shows special view to help with accessing application. |
Database
The database is stored in JSON, in the map section. For an example database see examples/e2e_test_data.json. The first subsection data consists of the actual datapoints, representing points on a map.
Datapoints have fields. The next subsections define special types of fields:
obligatory_fields- here are explicitely stated all the fields that the application assumes are presnt in all datapoints. E.g.
"position",
"name",
"accessible_by"
TODO: obligatory_fields is a new subsection, start using it in the actual application
categories- fields that can somehow be used in the app, for example by which datapoints can be filtered. Every category has a specified list of allowed values. E.g.
"accessible_by": ["bikes", "cars", "pedestrians"]
visible_data- when a datapoint will be rendered as a pin on a map, these fields will be shown in the box when clicking on a pin. E.g.
"name",
"type_of_place"
meta-data- some special data like
"uuid"
You can define the fields in all these subsections. Besides these types of fields, there is no restriction on the number of fields a datapoint can have.
Examples
You can find examples of working configuration and database in examples/ directory:
e2e_test_config.yml- Basic configuration examplee2e_test_data.json- Example database with sample location datamongo_e2e_test_config.yml- MongoDB configuration example
final test
2 maintainers
Release files for goodmap 1.8.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| goodmap-1.8.2.tar.gz | 40.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| goodmap-1.8.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.4 kB
Release files / goodmap-1.8.2.tar.gz
| Download URL | goodmap-1.8.2.tar.gz |
|---|---|
| Size | 40.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b11c58fbc89bff3ae80761ff892d822169b22ddabffc54bb3e2f63a267acfe5c
|
|
BLAKE2b-256 checksum How to use checksums |
c40b33419920d12937e8c930d01b269b355d8350f325c962f40c4cd74b9c7028
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 6, 2026.
Transparency logRelease files / goodmap-1.8.2-py3-none-any.whl
| Download URL | goodmap-1.8.2-py3-none-any.whl |
|---|---|
| Size | 44.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed48dcecae003a07ecc993c15ec5aa99d99a648843b7789a74dec6c7dcea7bfc
|
|
BLAKE2b-256 checksum How to use checksums |
f90111e18f49f276dd72adbaf6af5d4285e3ab17cfb07d6f8bce213d2108db99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 6, 2026.
Transparency log
