add postgis example

Author: lovasoa

CHANGELOG.md

@@ -6,6 +6,8 @@
  - Display all parameters in the debug component (instead of only row-level parameters).
  - Update dashmap for better file lookup performance.
  - Fix table sorting.
+ - Fix a bug with Basic Authentication.
+   See [#72](https://github.com/lovasoa/SQLpage/pull/72). Thanks to @edgrip for the contribution !
 
 ## 0.10.0 (2023-08-20)
 

examples/PostGIS - using sqlpage with geographic data/Dockerfile

@@ -0,0 +1,14 @@
+FROM debian:12-slim
+
+WORKDIR /var/www
+
+ADD https://github.com/lovasoa/SQLpage/releases/download/v0.7.2/sqlpage-linux.tgz .
+
+RUN apt-get update && \
+    apt-get -y install sqlite3 libsqlite3-mod-spatialite && \
+    tar xvzf sqlpage-linux.tgz && \
+    rm sqlpage-linux.tgz
+    
+COPY . .
+
+CMD ["sqlite3"]

examples/PostGIS - using sqlpage with geographic data/README.md

@@ -0,0 +1,19 @@
+# Using PostGIS to build a geographic data application
+
+## Introduction
+
+This is a small application that uses [PostGIS](https://postgis.net/)
+to save data associated to greographic coordinates.
+
+If you are using a SQLite database instead see [this other example instead](../make%20a%20geographic%20data%20application%20using%20sqlite%20extensions/),
+which implements the same application using the `spatialite` extension.
+
+### Installation
+
+You need to install the `postgis` extension for postgres. Follow [the official instructions](https://postgis.net/documentation/getting_started/).
+
+Then you can instruct SQLPage to connect to your database by editing the [`sqlpage/sqlpage.json`](./sqlpage/sqlpage.json) file.
+
+## Screenshots
+
+![](./screenshots/code.png)

examples/PostGIS - using sqlpage with geographic data/add_point.sql

@@ -0,0 +1,11 @@
+INSERT INTO spatial_data (title, geom, description)
+VALUES (
+    :Title,
+    ST_MakePoint(
+        CAST(:Longitude AS REAL),
+        CAST(:Latitude AS REAL
+    ), 4326),
+    :Text
+) RETURNING 
+    'redirect' AS component,
+    'index.sql' AS link;

examples/PostGIS - using sqlpage with geographic data/index.sql

@@ -0,0 +1,38 @@
+SELECT 'shell' as component,
+    'Map' AS title,
+    '/' as link,
+    'book' as icon;
+
+SELECT 'map' AS component,
+    ST_Y(geom) AS latitude,
+    ST_X(geom) AS longitude
+FROM spatial_data
+WHERE id = $id::int;
+
+SELECT 'map' as component,
+    'Points of interest' as title,
+    2 as zoom,
+    700 as height;
+SELECT title,
+    ST_Y(geom) AS latitude,
+    ST_X(geom) AS longitude,
+    'point.sql?id=' || id as link
+FROM spatial_data;
+
+
+SELECT 'list' as component,
+    'My points' as title;
+SELECT title,
+    'point.sql?id=' || id as link,
+    'red' as color,
+    'world-pin' as icon
+FROM spatial_data;
+
+SELECT 'form' AS component,
+    'Add a point' AS title,
+    'add_point.sql' AS action;
+
+SELECT 'Title' AS name;
+SELECT 'Latitude' AS name, 'number' AS type, 0.00000001 AS step;
+SELECT 'Longitude' AS name, 'number' AS type, 0.00000001 AS step;
+SELECT 'Text' AS name, 'textarea' AS type;

examples/PostGIS - using sqlpage with geographic data/point.sql

@@ -0,0 +1,56 @@
+SELECT 'shell' as component,
+    title,
+    '/' as link,
+    'index' as menu_item,
+    'book' as icon
+FROM spatial_data
+WHERE id = $id::int;
+
+SELECT 'datagrid' as component, title FROM spatial_data WHERE id = $id::int;
+
+SELECT 'Latitude' as title,
+    ST_Y(geom) as description,
+    'purple' as color,
+    'world-latitude' as icon
+FROM spatial_data WHERE id = $id::int;
+
+SELECT 'Longitude' as title,
+    ST_X(geom) as description,
+    'purple' as color,
+    'world-longitude' as icon
+FROM spatial_data WHERE id = $id::int;
+
+SELECT 'Created at' as title,
+    created_at as description,
+    'calendar' as icon,
+    'Date and time of creation' as footer
+FROM spatial_data WHERE id = $id::int;
+
+SELECT 'Label' as title,
+    title as description,
+    'geo:' || ST_Y(geom) || ',' || ST_X(geom) || '?z=16' AS link,
+    'blue' as color,
+    'world' as icon,
+    'User-generated point name' as footer
+FROM spatial_data
+WHERE id = $id::int;
+
+SELECT 'text' as component,
+    description as contents_md
+FROM spatial_data
+WHERE id = $id::int;
+
+SELECT 'list' as component, 'Closest points' as title;
+SELECT to_label as title,
+     ROUND(distance::decimal, 3) || ' km' as description,
+     'point.sql?id=' || to_id as link,
+     'red' as color,
+     'world-pin' as icon
+FROM distances
+WHERE from_id = $id::int
+ORDER BY distance
+LIMIT 5;
+
+SELECT 'map' AS component,
+        ST_Y(geom) AS latitude, ST_X(geom) AS longitude
+FROM spatial_data WHERE id = $id::int;

examples/PostGIS - using sqlpage with geographic data/screenshots/code.png

@@ -0,0 +1,24 @@
+CREATE EXTENSION  IF NOT EXISTS postgis;
+
+-- Create a spatialite-enabled database
+CREATE TABLE spatial_data (
+    id SERIAL,
+    title TEXT NOT NULL,
+    geom geometry,
+    description TEXT NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+
+CREATE VIEW distances AS
+SELECT from_point.id AS from_id,
+    from_point.title AS from_label,
+    to_point.id AS to_id,
+    to_point.title AS to_label,
+    ST_Distance(
+        from_point.geom,
+        to_point.geom,
+        TRUE
+    ) AS distance
+FROM spatial_data AS from_point, spatial_data AS to_point
+WHERE from_point.id != to_point.id;

examples/PostGIS - using sqlpage with geographic data/sqlpage/migrations/0000_create_db.sql

@@ -0,0 +1,3 @@
+{
+    "database_url": "postgres://my_username:my_password@localhost:5432/my_geographic_database"
+}

examples/PostGIS - using sqlpage with geographic data/sqlpage/sqlpage.json

@@ -2,7 +2,7 @@ FROM debian:12-slim
 
 WORKDIR /var/www
 
-ADD https://github.com/lovasoa/SQLpage/releases/download/v0.7.2/sqlpage-linux.tgz .
+ADD https://github.com/lovasoa/SQLpage/releases/download/v0.10.1/sqlpage-linux.tgz .
 
 RUN apt-get update && \
     apt-get -y install sqlite3 libsqlite3-mod-spatialite && \