Unsere App nutzt ein intelligentes mehrstufiges Suchsystem, um schnell und effizient interessante Orte zu finden. Hier ist, wie das funktioniert:

---
1️⃣ PREFETCH - Der unsichtbare Helfer im Hintergrund

Was macht die?
Sobald die App deinen Standort hat, lädt sie heimlich im Hintergrund schon mal POIs in der unmittelbaren Umgebung vor. Du merkst davon nichts!

Warum?
Wenn du dann auf "Suchen" drückst, sind die Ergebnisse schon da - fühlt sich viel schneller an.

Vergleich:
Wie wenn Netflix schon anfängt, die nächste Serienfolge zu laden, während du noch die aktuelle guckst.

Details:
- Nur der unmittelbare Bereich (1 Kartenquadrat, ~500m)
- Läuft max. alle 30 Sekunden
- Keine Störung der Benutzeroberfläche
- Speichert im Zwischenspeicher (Cache)

---
2️⃣ INSTANT SEARCH - Die Schnellsuche für die Nähe

Was macht die?
Die erste Phase jeder Suche - schaut in 300m Umkreis nach interessanten Orten.

Warum?
Dir werden innerhalb von Sekunden die 5 nächstgelegenen Orte gezeigt. Du musst nicht warten!

Vergleich:
Wie wenn du im Supermarkt nach dem nächsten Kassierer schaust - nur die in Sichtweite zählen.

Details:
- Umkreis: 300m (bei Priorität: 450m)
- Ergebnis: 5 POIs
- Timeout: 30 Sekunden (normalerweise aber nur ~2-5s)
- Sucht in 4 Kartenquadraten (2×2 Raster)

---
3️⃣ FULL SEARCH - Die erweiterte Suche

Was macht die?
Zweite Phase - erweitert die Suche auf 600m Umkreis und zeigt insgesamt 10 Orte.

Warum?
Falls in der Nähe (300m) nicht viel los ist, schaut die App weiter weg und gibt dir mehr Auswahl.

Vergleich:
Nachdem du die nahen Kassierer gesehen hast, schaust du jetzt auch in den anderen Gang - vielleicht ist da weniger los?

Details:
- Umkreis: 600m (bei Priorität: 900m)
- Ergebnis: 10 POIs (inkl. der 5 von Instant)
- Timeout: 25-30 Sekunden
- Sucht in 9 Kartenquadraten (3×3 Raster)
- Wird übersprungen, wenn Instant schon 6+ Orte gefunden hat

---
4️⃣ PRIORITÄTS-SUCHE - Dein Favorit zuerst

Was macht die?
Wenn du eine Kategorie als Favorit markiert hast (z.B. "Sehenswürdigkeiten&quot😉, bekommt die Sonderbehandlung:
- Größerer Suchradius (1.5× = 450m statt 300m)
- Mehr Ergebnisplätze (6-7 von 10 Slots)
- Umfangreichere Suche (auch mittelwichtige Tags)

Warum?
Du zeigst der App, was dir wichtig ist - und sie sucht dann härter danach!

Vergleich:
Wie wenn du im Restaurant sagst "Ich mag besonders Pizza" - dann zeigt dir die Karte zuerst alle Pizza-Varianten.

Details:
- 1.5× größerer Radius
- 60-70% der Slots für Prioritäts-Kategorie
- Bonus für nahe gelegene Priority-POIs
- Durchsucht mehr Tags (High + Medium statt nur High)

---
5️⃣ EARLY EXIT - Die intelligente Abkürzung

Was macht die?
Wenn die Instant-Suche 6 oder mehr Orte findet, denkt die App: "Super, hier ist viel los!" und überspringt die Full-Suche.

Warum?
Spart Zeit und Server-Last. Wenn du eh schon 6 gute Orte hast, wozu noch weiter suchen?

Vergleich:
Wie wenn du in den Supermarkt gehst und sofort 3 leere Kassen siehst - du musst nicht mehr durch den ganzen Laden laufen.

Details:
- Trigger: 6+ Instant-Results
- Ersparnis: ~15-30 Sekunden
- Auch bei hoher Geschwindigkeit (Aut👋Bahn) wird nur Instant genutzt

---
6️⃣ QUADRANTEN-SYSTEM - Die smarte Rasterung

Was macht die?
Die App teilt die Karte in unsichtbare Quadrate (~500×500m). Statt die ganze Welt zu durchsuchen, schaut sie nur in die relevanten Quadrate.

Warum?
Die Datenbank muss nicht Millionen von Orten durchsuchen - nur die in den 4-9 relevanten Quadraten. Extrem viel schneller!

Vergleich:
Wie ein Regal im Baumarkt: Du gehst nicht durch alle 50 Gänge, sondern nur zu "Gang 12: Schrauben".

Details:
- Quadratgröße: ~500×500m (0.0045° Breiten-/Längengrad)
- Instant: 4 Quadrate (2×2 Raster)
- Full: 9 Quadrate (3×3 Raster)
- Sortiert nach Distanz zu dir

Visualisierung:
┌────┬────┬────┐
│ │ │ │ Full-Suche:
├────┼────┼────┤ Alle 9 Quadrate (600m)
│ │ 👤 │ │
├────┼────┼────┤ Instant-Suche:
│ │ │ │ Nur die 4 inneren Quadrate (300m)
└────┴────┴────┘

---
7️⃣ WARM-UP - Der schlafende Riese

Was macht die?
Eine Admin-Funktion zum manuellen Vorladen von POIs für bestimmte Standorte (z.B. Düsseldorf Hauptbahnhof).

Warum existiert sie?
Ursprünglich gedacht für häufig besuchte Hotspots - wurde aber durch das automatische Prefetch ersetzt.

Status:
⚠️ Nicht aktiv genutzt - Code existiert, aber wird nicht aufgerufen

Vergleich:
Wie ein Emergency-Button, der existiert aber nie gedrückt wird, weil die Automatik schon gut genug funktioniert.

---
🎯 Zusammenfassung: Wie arbeiten die Suchen zusammen?

Stell dir vor, du suchst ein Restaurant:

1. Prefetch (unsichtbar): App lädt heimlich schon Restaurants in der Nähe vor
2. Instant Search (300m): "Hier sind 5 Restaurants, die du in 3 Minuten erreichen kannst!"
3. Early Exit: Falls 6+ Restaurants gefunden → Fertig! ✅
4. Full Search (600m): Falls zu wenig gefunden → "Hier sind 5 weitere in 10 Minuten Fußweg"
5. Priorität: Falls du "Italienische Restaurants" favorisiert hast → 7 von 10 Ergebnissen sind italienisch
6. Quadranten: App durchsucht nicht ganz München, sondern nur deine Nachbarschaft

---
⚡ Performance im Alltag:

Idealer Fall (viel in der Nähe):
- Prefetch hat vorgeladen → Instant (~1s)
- 6+ POIs gefunden → Early Exit → Fertig in ~3s

Normaler Fall (mittel viel los):
- Instant: 3 POIs in 300m → ~3-5s
- Full: 7 weitere POIs in 600m → ~10-15s
- Gesamt: ~15-20s

Schwieriger Fall (wenig los, z.B. auf dem Land):
- Instant: 1-2 POIs → ~5s
- Full: 3-4 POIs → ~20-30s
- Gesamt: ~30s (Timeout-Limit)

---
📊 Zahlen auf einen Blick:

| Suchtyp | Radius | Quadrate | Ergebnisse | Typische Dauer |
|------------|------------|-----------|-------------------|-----------------|
| Prefetch | ~500m | 1 | - | unsichtbar |
| Instant | 300m | 4 (2×2) | 5 POIs | 2-5s |
| Full | 600m | 9 (3×3) | +5 POIs | 10-25s |
| Priority | 450/900m | 4/9 | 60-70% der Slots | wie I/F |
| Early Exit | - | - | bei 6+ POIs | spart 15-30s |

---
Macht das Sinn? So arbeitet die App intelligent zusammen, um dir schnell die besten Ergebnisse zu liefern, ohne dabei den Server oder dein Datenvolumen zu überlasten! 🚀