StreetMapper API

Automatische Geolokalisierung von Straßenfotos per API

Base URL

https://streetmapper.synergbuilds.com/api/v1

Authentifizierung

Alle API-Anfragen erfordern einen gültigen API-Key. Sende ihn als Bearer Token:

Authorization: Bearer sm_live_dein_api_key

Alternativ: X-API-Key: sm_live_dein_api_key

Pläne & Preise

Plan	Bilder/Monat	Rate Limit	Preis
Free	50	5/min	Kostenlos
Starter	500	20/min	9 €/Monat
Pro	5.000	60/min	29 €/Monat
Enterprise	50.000	200/min	99 €/Monat

Endpoints

POST/v1/processEinzelbild verarbeiten

Verarbeitet ein einzelnes Bild und gibt Standort, Adresse und Konfidenz zurück.

cURL Beispiel:

curl -X POST https://streetmapper.synergbuilds.com/api/v1/process \
  -H "Authorization: Bearer sm_live_dein_key" \
  -F "[email protected]"

Response:

{
  "success": true,
  "data": {
    "status": "success",
    "confidence": 0.92,
    "detection_method": "exif",
    "original_name": "foto.jpg",
    "location": {
      "latitude": 48.5878,
      "longitude": 7.7484
    },
    "address": {
      "street": "Rue Finkmatt",
      "city": "Strasbourg",
      "postal_code": "67000",
      "full_address": "Rue Finkmatt, 67000 Strasbourg"
    },
    "captured_at": "2025-05-27T10:50:12.000Z",
    "processing_time_ms": 1250
  }
}

POST/v1/batchBatch-Verarbeitung (max 20)

Verarbeitet bis zu 20 Bilder in einem Request.

cURL Beispiel:

curl -X POST https://streetmapper.synergbuilds.com/api/v1/batch \
  -H "Authorization: Bearer sm_live_dein_key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]"

GET/v1/usageAktuelle Nutzung abfragen

curl https://streetmapper.synergbuilds.com/api/v1/usage \
  -H "Authorization: Bearer sm_live_dein_key"

Fehlercodes

HTTP	Code	Bedeutung
401	`AUTH_FAILED`	API-Key fehlt oder ungültig
429	`QUOTA_EXCEEDED`	Monatslimit erreicht
400	`MISSING_IMAGE`	Kein Bild in der Anfrage
413	`IMAGE_TOO_LARGE`	Bild über 15MB
500	`PROCESSING_ERROR`	Interner Verarbeitungsfehler

API-Key anfordern

Kontaktiere uns unter [email protected] um einen API-Key zu erhalten.