Das Python-Paket **`streetlevel`** unterstützt Yandex Panorama nativ. Es greift direkt auf die internen API-Endpunkte zu und lädt die einzelnen Kacheln (Tiles) zu einem vollständigen Panorama-Bild zusammen.

### Installation

```bash
pip install streetlevel

```

---

### Python-Beispiel: Panorama suchen und herunterladen

Über Koordinaten (Breitengrad, Längengrad) kann das nächstgelegene Panorama gesucht und als JPEG gepeichert werden:

```python
from streetlevel import yandex

# Koordinaten definieren (Beispiel: Moskau, Rot Platz)
lat, lon = 55.7539, 37.6208

# Nächstgelegenes Panorama suchen
pano = yandex.find_panorama(lat, lon)

if pano:
print(f"Panorama gefunden! ID: {pano.id}")
print(f"Aufnahmedatum: {pano.date}")
print(f"Exakte Koordinaten: {pano.lat}, {pano.lon}")

# Höchste Auflösung herunterladen (zoom=0)
# Das Bild enthält automatisch Exif- & XMP-GPano-Metadaten
yandex.download_panorama(pano, f"yandex_{pano.id}.jpg", zoom=0)
print("Download erfolgreich abgeschlossen.")
else:
print("Kein Panorama an diesen Koordinaten gefunden.")

```

---

### Parameter & Details

* **`zoom`**: Controls die Bildauflösung. `zoom=0` lädt die höchste verfügbare Auflösung herunter, während `zoom=4` der kleinsten entspricht.
* **Bildbearbeitung im Speicher**: Falls das Bild nicht direkt auf die Festplatte geschrieben werden soll, kann `yandex.get_panorama(pano)` verwendet werden – dies gibt ein `PIL.Image`-Objekt im Arbeitsspeicher zurück.
* **Panorama-ID**: Ist eine `pano.id` bereits bekannt, lässt sich das Objekt direkt über `yandex.find_panorama_by_id("PANO_ID")` laden.

---

### Wichtige Hinweise

* **API-Limitierungen & Blockaden**: Da die Library interne/undokumentierte APIs nutzt, wird kein API-Key benötigt. Bei sehr vielen Anfragen in kurzer Zeit kann Yandex allerdings die IP-Adresse temporär drosseln oder blockieren. Für große Batches empfiehlt sich die Einbindung von Pausen (`time.sleep`) oder Proxies.
* **Alternative (Offizielle Yandex JS-API)**: Falls eine kommerzielle Nutzung oder langfristige Stabilität ohne Breaking Changes benötigt wird, bietet Yandex Maps den **JS API Panorama Player**. Damit lassen sich Panoramen in Web-Apps einbetten (erfordert ein Yandex-Cloud-Konto und ggf. einen API-Key für das Maps JavaScript API).