NRW23 Candidate Search App

Table of Contents

• Introduction
• Repository Structure
• Getting Started
  • Local Deployment
  • Online Access
• Disclaimer
• License
• Contact

Introduction

This repository contains a Flask application designed for users to search for candidates who participated in the 2023 Nationalrat elections (Switzerland). It primarily showcases detailed information about a candidate, emphasizing the number of votes they received.

Repository Structure

NRW23/
│
├── files/
│   └── NRW2023-kandidierende.zip  # Data containing candidate information
│
├── static/
│   ├── JS/
│   │   └── script.js             # JavaScript file for interactive features
│   │
│   └── styles.css                # CSS file for the web application styling
│
├── templates/
│   ├── detail.html               # Detail page template for a specific candidate
│   ├── index.html                # Main page template for search feature
│   ├── privacy-policy.html       # Privacy policy template
│   └── results.html              # Results page displaying candidates
│
├── .gitignore                    # Patterns of files/directories to ignore in git
│
├── app.py                        # Main Flask app script
│
├── LICENSE                       # License file
│
├── main_routes.py                # Routes for the Flask app
│
├── README.md                     # README documentation
│
├── requirements.txt              # List of required Python packages for the app
│
└── utils.py                      # Utility functions for the app

Getting Started

Local Deployment

1. Clone the Repository bash git clone https://github.com/devobern/NRW23/tree/main

2. Navigate to Directory bash cd NRW23

3. Create & Activate Virtual Environment
   Ensure you have python3 and virtualenv installed. bash virtualenv env source env/bin/activate

4. Install Dependencies bash pip install -r requirements.txt

5. Run the App bash python run.py

6. Access Locally
   The application will be accessible at http://127.0.0.1:5000/.

   Note: Due to the Content Security Policy (CSP), the app cannot be run locally without dev certificates. To address this, you can use mkcert to generate your own certificate. For a guide on how to use mkcert, please refer to this tutorial.

Online Access

Access the hosted application here.

Disclaimer

This application is an ongoing project and serves as a bit of a playground for me. It was developed with the primary motivation to provide a simple platform to view the votes received by individual candidates. There might be occasional issues or aspects that need refinement. Feedback and suggestions are always welcome.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Dataset Information

The data used in this repository is sourced from the Bundesamt für Statistik BFS and relates to the Nationalratswahlen 2023.

• Dataset Name: NR - Kandidierende
• Publication Date: 8. August 2023
• Format: JSON
• Access URL: Link to Dataset

License for Dataset

The dataset is available under the "Freie Nutzung. Quellenangabe ist Pflicht" terms. Users can use this dataset for both non-commercial and commercial purposes, but proper attribution is required.

Attribution:
Autor:in: Bundesamt für Statistik BFS
Titel: NR - Kandidierende
Link zum Datensatz

Contact

For inquiries or suggestions, please reach out via email.

Smart Urban Heat Map API Documentation

This documentation describes the Open-Data API of the Smart Urban Heat Map Bern Project.

The Smart Urban Heat Map is an initiative of the Smart City Verein Bern to visualize urban heat in the city and region of Bern. Valuable pioneering work has been done by the Climatology Group at the Geographical Institute of the University of Bern (GIUB), which has been operating an urban measurement network since 2018, consisting of around 80 stations. The Smart City Verein Bern, together with the company Abilium GmbH, the Bern University of Applied Sciences and the company Meteotest, has extended this measuring network into the Bern region by around 40 measuring stations.

Based on this measurement network, the Smart Urban Heat Map API offers access to detailed city climate data for the region of Bern, Switzerland. Users can retrieve current measurements of temperature, relative humidity, and location metadata, as well as location-bound time series data. The data provides valuable insights for urban planning and environmental studies.

The documentation is complemented by an interactive OpenAPI specification and a Jupyter Notebook which includes examples of how to request and visualize the data using Python. The notebook can be run locally or directly in the browser using or .

Licensing Information The data from the API is available under the Creative Commons Attribution License (CC-BY). Please ensure that you provide proper attribution when using or redistributing this data in your projects or applications. Attribution Example: Data provided by the Smart Urban Heat Map Project for Bern, Switzerland.

Contact Information For questions regarding the data, please contact the BFH. For questions regarding the locations and data of the project "Urban Climate Bern", please contact GIUB - Urban Climate Bern. For technical questions regarding the API, please contact Meteotest.

Table of Contents - Changelog - Stations, Sensors and Temperature Bias - Endpoints - Codebook - Example Requests

Changelog

API Version 2

This is the second version of the Smart Urban Heat Map API published on 18.06.2024.

Remark: In the initial version, the GeoJSON end point /stations (now called /latest) returned the lat/lon coordinates in the wrong order ([lat, lon] rather than [lon, lat]).

Stations, Sensors and Temperature Bias

The measuring stations are built by Abilium GmbH and are based on the SHT41A Sensorion sensors. The self-sufficient stations are outfitted with a small solar panel and measure temperature and relative humidity every 10 minutes. The measurement data is sent out via the Helium LoRaWAN network. To reduce the potential temperature bias when stations are exposed to direct sunlight, all stations are ventilated before measuring. However, in some cases, especially during the day, measured temperatures might still be slightly higher than actual temperatures.

Endpoints

latest

Retrieves station data including most recent measured value for:

• Temperature is in Celsius (°C).
• Relative Humidity is in percentage (%).

URL: https://smart-urban-heat-map.ch/api/v2/latest
Response Formats: GeoJSON (default), CSV

timeseries

Retrieves time series based on stationId for: * Temperature is in Celsius (°C). * Relative Humidity is in percentage (%).

URL: https://smart-urban-heat-map.ch/api/v2/timeseries
Response Formats: JSON (default), CSV
URL Parameter: * stationId (required): specifies from which station to return the time series * timeFrom (optional, default: "-24hours"): specifies start of time series (Examples: "-3days","-24hours","-30minutes", "2023-10-01T00:00:00Z") * timeTo (optional, default: "now"): specifies end of time series (Examples: "-3days","-24hours","-30minutes", "now", "2023-10-01T00:00:00Z")

stations

Retrieves station data including date of most recent measurement.

URL: https://smart-urban-heat-map.ch/api/v2/stations
Response Formats: GeoJSON (default), CSV

Codebook

latest

• coordinates: Array representing the geographical coordinates (in WGS84) of the station (Longitude, Latitude)
• stationId: Unique identifier for the station (Example: "11004")
• name: Name of the station (Example: "Sandrain-Bern")
• dateObserved: Date and time of the last measurement (Example: "2023-08-01T12:00:00Z")
• temperature: Last temperature measured at the station in °C (Example: 18.925001)
• relativeHumidity: Last relative humidity measured at the station in % (Example: 60.971848)

timeseries

• stationId: Unique identifier for the station (Example: "11004")
• dateObserved: Date and time of the measurement (Example: "2023-08-01T12:00:00Z")
• temperature: Temperature measured at the station in °C (Example: 18.925001)
• relativeHumidity: Relative humidity measured at the station in % (Example: 60.971848)

stations

• coordinates: Array representing the geographical coordinates (in WGS84) of the station (Longitude, Latitude)
• stationId: Unique identifier for the station (Example: "11099")
• name: Name of the station (Example: "Sandrain-Bern")
• latestMeasurementDate: Date and time of the last measurement (Example: "2023-08-01T12:00:00Z")

Example Requests

Request list of stations and most recent measurements

GET https://smart-urban-heat-map.ch/api/v2/latest

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.43141,
          46.94067
        ]
      },
      "properties": {
        "stationId": "11037",
        "name": "Eigerplatz-Bern",
        "dateObserved": "2023-10-05T11:36:29Z",
        "temperature": 18.925001,
        "relativeHumidity": 60.971848
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.439139,
          46.96681
        ]
      },
      "properties": {
        "stationId": "11127",
        "name": "Worblen-Ostermundigen",
        "dateObserved": "2023-10-05T11:36:27Z",
        "temperature": 18.791485,
        "relativeHumidity": 62.507286
      }
    },
    ...
  ]
}

Request timeseries for a station

GET https://smart-urban-heat-map.ch/api/v2/timeseries?stationId=11023&timeFrom=2023-10-01T00:00:00Z&timeTo=2023-10-31T23:00:00Z

{
  "stationId": "11023",
  "values": [
    {
      "dateObserved": "2023-10-01T00:05:45Z",
      "temperature": 14.193179,
      "relativeHumidity": 86.94652
    },
    {
      "dateObserved": "2023-10-01T00:15:45Z",
      "temperature": 14.20386,
      "relativeHumidity": 87.801025
    },
    {
      "dateObserved": "2023-10-01T00:25:45Z",
      "temperature": 14.03563,
      "relativeHumidity": 88.541084
    },
    ...
  ]
}

Request list of stations and date of most recent measurement

GET https://smart-urban-heat-map.ch/api/v2/stations

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.43141,
          46.94067
        ]
      },
      "properties": {
        "stationId": "11037",
        "name": "Eigerplatz-Bern",
        "latestMeasurementDate": "2023-10-05T11:36:29Z",
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.439139,
          46.96681
        ]
      },
      "properties": {
        "stationId": "11127",
        "name": "Worblen-Ostermundigen",
        "latestMeasurementDate": "2023-10-05T11:36:27Z",
      }
    },
    ...
  ]
}