openstreetmap-polska/openaedmap-backend

❤️ Backend powering OpenAEDMap.org — an OpenStreetMap's life-saving AED map

OpenAEDMap Backend 🌍❤️

Ever wanted to be a superhero? OpenAEDMap gives you that chance. By pinpointing AED locations via OpenStreetMap, we equip you with the power to save lives. Save a life today by visiting OpenAEDMap.org.

🔧 This repository hosts the backend code.

For frontend implementations, please see openaedmap-frontend.

🌟 Core Features

• Automated OSM Updates: Downloads data and updates from OpenStreetMap.
• AED Information: Serve comprehensive details about specific AED locations.
• Vector Tiles: Create and serve vector tiles for map rendering.
• Regional GeoJSON: Generate downloadable GeoJSON files by region.
• Photo Integration: Allows uploading and viewing of photos of individual AEDs.

🌐 Deployed Instances

• Production — main branch: openaedmap.org
• Development — dev branch: dev.openaedmap.org

🛠️ Local Development

Getting Started

Before you jump in, make sure to install the ❄️ Nix package manager. It's your shortcut to seamless dependency management and reproducible environment setup. It will save you lots of time and spare you from unnecessary stress.

# Install dependencies and enter shell
nix-shell

# Start up the database
dev-start

# Launch the web server
uvicorn main:app

Navigate to http://localhost:8000 to access the web app locally.

Cleanup

# Terminate the database
dev-stop

# Purge database
dev-clean

openaedmap-backend's Issues

City API

Provide license and author info of wikimedia_commons photos

Related to #47
Example AED: https://www.openstreetmap.org/node/11081641408
It has image: https://commons.wikimedia.org/wiki/File:Defibrillatore%20Comunale%204.jpg?uselang=en
License is CC BY-SA 4.0 so we have to include attribution
At the moment information about author and license is missing in https://openaedmap.org/api/v1/node/11081641408

Support wikimedia_commons images

https://openaedmap.org/it/#map=17/45.327229/8.417886&node_id=11081641408

Photo not showing up

I uploaded a photo (twice) and the link is just 404 error.

https://openaedmap.org/?node_id=11793349907

Return timezone of the state where AED is located

It is used for calculating whether AED is currently opened together with opening_hours.
Frontend uses Nominatim reverse geocoding API + timezone library to get this information.
It could be precalculated and kept in the database.
It should be recalculcated (cron job?) as borders of countries/states/timezones change.

Enable support for HTTP redirects on Planet Diff downloads

Please enable your app to follow HTTP redirects to download planet diff files. See openstreetmap/operations#971

Version returned is 0

Example:
https://openaedmap.org/api/v1/node/5140047708
returns

{
    "version": 0.6,
    "copyright": "OpenStreetMap and contributors",
    "attribution": "https://www.openstreetmap.org/copyright",
    "license": "https://opendatacommons.org/licenses/odbl/1-0/",
    "elements": [
        {
            "@photo_id": null,
            "@photo_url": null,
            "@timezone_name": "Europe/Warsaw",
            "@timezone_offset": "UTC+01:00",
            "type": "node",
            "id": 5140047708,
            "lat": 52.2399553,
            "lon": 21.0134473,
            "tags": {
                "defibrillator:location": "W hotelu Sofitel",
                "emergency": "defibrillator",
                "operator": "Sofitel"
            },
            "version": 0
        }
    ]
}

I would expect "version": 2

https://www.openstreetmap.org/node/5140047708

Enable gzip for https://back.openaedmap.org/data/

It's configured in

openaedmap-backend/nginx/nginx-proxy-prod.conf

Line 58 in be5734f

gzip on;

According to my testing it doesn't work.
Example url: https://back.openaedmap.org/data/world.geojson
Useful tool: https://www.whatsmyip.org/http-compression-test/

Add to Taginfo Projects

Show the OpenStreetMap community what data you are using. Add your project to the list of Taginfo Projects.

(similar to aed_mapa)