feat: integrate geocoding functionality with backend support

- Added geocoding capabilities to the backend using OpenStreetMap and MNLR Address Server.
- Implemented new API endpoints for geocoding and backend status.
- Introduced a new frontend view for displaying backend information and geocoding documentation.
- Updated router to include the new geocode backend view.
- Enhanced the PMMapsViewer component to utilize the new geocoding API.
- Added GeoResponse and BackendInfo types to manage geocoding responses.
- Included the Maplibre Geocoder library for frontend geocoding functionality.
- Updated environment variable handling for geocoding server configuration.

Author: ManuelRaven

backend/go.mod

@@ -1,8 +1,12 @@
 module mnlr.de/mnlrmap
 
-go 1.24
+go 1.24.1
+
+toolchain go1.24.3
 
 require (
+	github.com/codingsince1985/geo-golang v1.8.5
+	github.com/joho/godotenv v1.5.1
 	github.com/pocketbase/pocketbase v0.28.1
 	github.com/protomaps/go-pmtiles v1.28.0
 )
@@ -15,34 +19,21 @@ require (
 	cloud.google.com/go/iam v1.1.13 // indirect
 	cloud.google.com/go/storage v1.43.0 // indirect
 	github.com/Azure/azure-sdk-for-go/sdk/azcore v1.14.0 // indirect
-	github.com/Azure/azure-sdk-for-go/sdk/azidentity v1.7.0 // indirect
 	github.com/Azure/azure-sdk-for-go/sdk/internal v1.10.0 // indirect
 	github.com/Azure/azure-sdk-for-go/sdk/storage/azblob v1.3.2 // indirect
-	github.com/Azure/go-autorest v14.2.0+incompatible // indirect
-	github.com/Azure/go-autorest/autorest/to v0.4.0 // indirect
-	github.com/AzureAD/microsoft-authentication-library-for-go v1.2.2 // indirect
 	github.com/RoaringBitmap/roaring v1.5.0 // indirect
-	github.com/alecthomas/kong v0.8.0 // indirect
 	github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2 // indirect
-	github.com/aws/aws-sdk-go v1.55.5 // indirect
 	github.com/aws/aws-sdk-go-v2 v1.36.1 // indirect
 	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.9 // indirect
-	github.com/aws/aws-sdk-go-v2/config v1.29.6 // indirect
-	github.com/aws/aws-sdk-go-v2/credentials v1.17.59 // indirect
-	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.28 // indirect
 	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.62 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.32 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.32 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.2 // indirect
 	github.com/aws/aws-sdk-go-v2/internal/v4a v1.3.32 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.12.2 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.6.0 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.12.13 // indirect
 	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.18.13 // indirect
 	github.com/aws/aws-sdk-go-v2/service/s3 v1.77.0 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sso v1.24.15 // indirect
-	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.28.14 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sts v1.33.14 // indirect
 	github.com/aws/smithy-go v1.22.2 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/bits-and-blooms/bitset v1.2.0 // indirect
@@ -61,20 +52,16 @@ require (
 	github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
 	github.com/google/s2a-go v0.1.9 // indirect
 	github.com/google/uuid v1.6.0 // indirect
-	github.com/google/wire v0.6.0 // indirect
 	github.com/googleapis/enterprise-certificate-proxy v0.3.4 // indirect
 	github.com/googleapis/gax-go/v2 v2.14.1 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
-	github.com/jmespath/go-jmespath v0.4.0 // indirect
-	github.com/kylelemons/godebug v1.1.0 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-runewidth v0.0.14 // indirect
 	github.com/mitchellh/colorstring v0.0.0-20190213212951-d06e56a500db // indirect
 	github.com/mschoch/smat v0.2.0 // indirect
 	github.com/ncruces/go-strftime v0.1.9 // indirect
 	github.com/paulmach/orb v0.10.0 // indirect
-	github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c // indirect
 	github.com/pocketbase/dbx v1.11.0 // indirect
 	github.com/prometheus/client_golang v1.19.1 // indirect
 	github.com/prometheus/client_model v0.5.0 // indirect

backend/go.sum

@@ -4,6 +4,7 @@ import (
 	"log"
 	"os"
 
+	"github.com/joho/godotenv"
 	"github.com/pocketbase/pocketbase"
 )
 
@@ -31,10 +32,13 @@ func newApplication() *application {
 }
 
 func main() {
+
+	godotenv.Load()
 	app := newApplication()
 	app.mountFs()
 	app.useMigrations()
 	app.usePMTiles()
+	app.useGeocoder()
 
 	log.Fatal(app.pb.Start())
 }

backend/main.go

@@ -0,0 +1,159 @@
+package main
+
+import (
+	"encoding/json"
+	"io"
+	"net/http"
+
+	"github.com/codingsince1985/geo-golang/openstreetmap"
+	"github.com/pocketbase/pocketbase/core"
+)
+
+type Address struct {
+	ID          int64   `json:"id"`
+	Street      string  `json:"street"`
+	HouseNumber string  `json:"house_number"`
+	City        string  `json:"city"`
+	Longitude   float64 `json:"longitude"`
+	Latitude    float64 `json:"latitude"`
+}
+
+type MNLRAddressServerResponse struct {
+	Schema    string    `json:"$schema"`
+	Addresses []Address `json:"addresses"`
+}
+
+type BackendInfoResponse struct {
+	Reachable bool   `json:"reachable"`
+	Name      string `json:"name"`
+}
+
+// fs to maps folder
+
+// mountFs configures the embedded file system for the application's
+// front-end assets when building for production.
+func (app *application) useGeocoder() {
+
+	// register "GET /hello/{name}" route (allowed for everyone)
+	app.pb.OnServe().BindFunc(func(se *core.ServeEvent) error {
+		addresserver := getEnvOrDefault("MNLRADDRESSSERVER", "")
+		// register "GET /hello/{name}" route (allowed for everyone)
+		se.Router.GET("/geoapi/geocode", func(e *core.RequestEvent) error {
+
+			addresserver := getEnvOrDefault("MNLRADDRESSSERVER", "")
+
+			var resultAddress []Address
+			search := e.Request.URL.Query().Get("q")
+
+			if addresserver == "" {
+				resultAddress, _ = GetGeoFromOSM(search)
+			}
+			if addresserver != "" {
+				resultAddress, _ = GetGeoFromMNLR(search, addresserver)
+			}
+
+			return e.JSON(http.StatusOK, resultAddress)
+
+		})
+
+		// register "GET /hello/{name}" route (allowed for everyone)
+		se.Router.GET("/geoapi/backend", func(e *core.RequestEvent) error {
+
+			var backendInfo BackendInfoResponse = BackendInfoResponse{
+				Reachable: false,
+				Name:      "OSM",
+			}
+
+			// Check if the address server is reachable by performing a demo request
+			if addresserver != "" {
+				_, err := GetGeoFromMNLR("test", addresserver)
+				if err != nil {
+					backendInfo.Reachable = false
+					backendInfo.Name = addresserver + " (MNLRAddressServer)"
+				} else {
+					backendInfo.Reachable = true
+					backendInfo.Name = addresserver + " (MNLRAddressServer)"
+				}
+			}
+
+			if addresserver == "" {
+				_, err := GetGeoFromOSM("test")
+				if err != nil {
+					backendInfo.Reachable = false
+					backendInfo.Name = "OSM"
+				} else {
+					backendInfo.Reachable = true
+					backendInfo.Name = "OSM"
+				}
+			}
+
+			return e.JSON(http.StatusOK, backendInfo)
+
+		})
+
+		return se.Next()
+	})
+
+}
+
+func GetGeoFromMNLR(address string, url string) ([]Address, error) {
+	// Get Request to url/geocode?q=address
+
+	httpClient := &http.Client{}
+	req, err := http.NewRequest("GET", url+"/api/search", nil)
+	if err != nil {
+		return nil, err
+	}
+	q := req.URL.Query()
+	q.Add("q", address)
+	req.URL.RawQuery = q.Encode()
+	resp, err := httpClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode != http.StatusOK {
+		return nil, err
+	}
+	// Parse the response
+	var mnlrrespnse MNLRAddressServerResponse
+
+	data, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	err = json.Unmarshal(data, &mnlrrespnse)
+	if err != nil {
+		return nil, err
+	}
+
+	return mnlrrespnse.Addresses, nil
+}
+
+func GetGeoFromOSM(address string) ([]Address, error) {
+	// Use OSM as default
+	geocoder := openstreetmap.Geocoder()
+
+	// Geocode the address
+	resultLatLong, err := geocoder.Geocode(address)
+	if err != nil {
+		return nil, err
+	}
+
+	resulltReverse, err := geocoder.ReverseGeocode(resultLatLong.Lat, resultLatLong.Lng)
+	if err != nil {
+		return nil, err
+	}
+
+	// Return results
+	addresses := make([]Address, 1)
+	addresses[0].ID = 1
+	addresses[0].Street = resulltReverse.Street
+	addresses[0].HouseNumber = resulltReverse.HouseNumber
+	addresses[0].City = resulltReverse.City
+	addresses[0].Longitude = resultLatLong.Lng
+	addresses[0].Latitude = resultLatLong.Lat
+
+	return addresses, nil
+}

backend/useGeocoder.go

@@ -1,4 +1,3 @@
-import { useAuth } from "@/composeables/useAuth";
 import { createRouter, createWebHistory } from "vue-router";
 import HomeView from "../views/HomeView.vue";
 
@@ -28,6 +27,15 @@ const router = createRouter({
             title: "Map Extract",
           },
         },
+        {
+          path: "/geocodebackend",
+          name: "geocodebackend",
+          component: () => import("@/views/GecodeBackendView.vue"),
+          meta: {
+            icon: "search",
+            title: "GeoCode Backend",
+          },
+        },
         {
           path: "/localmapslist",
           name: "localmapslist",

frontend/src/router/index.ts

@@ -20,3 +20,17 @@ export interface MapSize {
   name: string;
   sizeBytes: number;
 }
+
+export interface GeoResponse {
+  id: number;
+  street: string;
+  house_number: string;
+  city: string;
+  longitude: number;
+  latitude: number;
+}
+
+export interface BackendInfo {
+  reachable: boolean;
+  name: string;
+}