Entwickler-API: Schlüssel, Kontingente und Dokumentation
Geocoding, Reverse, Routing, Matrix, Erreichbarkeit und Kacheln per API. API-Stufen von kostenlos bis 249 € im Monat.
Mit der Entwickler-API nutzen Sie die Kartendienste von Agile Map in eigenen Anwendungen: Geocoding (Adresse → Koordinate), Reverse-Geocoding, Routing, Matrix (Fahrzeiten zwischen vielen Orten), Erreichbarkeit (Isochronen), Orte in der Nähe, ÖPNV und Vektorkacheln für Deutschland, Österreich und die Schweiz.
Schlüssel anlegen:
- Konto anlegen bzw. anmelden: https://map.agiledeveloper.de/konto.
- Im Konto API-Schlüssel › Neuer Schlüssel wählen, Namen und Rechte festlegen.
- Den Schlüssel sofort kopieren: er ist nur jetzt sichtbar.
- In Anfragen mitsenden:
Authorization: Bearer agile_map_…
Beispiel: curl "https://map.agiledeveloper.de/api/v1/geocode?q=Marienplatz%20München" -H "Authorization: Bearer agile_map_…"
Dokumentation: https://map.agiledeveloper.de/docs (OpenAPI mit Beispielen zum Ausprobieren). Für KI-Assistenten gibt es einen MCP-Server unter /mcp (Orte suchen, Routen, Erreichbarkeit, Abfahrten).
API-Stufen (Preise je Monat zzgl. USt.; Jahrespreis = 10 Monatspreise). Kontingent je Kalendermonat für Geocoding / Reverse / Routing / Matrix-Elemente / Isochronen / Kacheln:
- API Free – 0 €: 10.000 / 10.000 / 5.000 / 25.000 / 1.000 / 100.000; 5 Anfragen/s; 2 Schlüssel
- API Start – 19 €: 100.000 / 100.000 / 50.000 / 250.000 / 10.000 / 1 Mio.; 15 Anfragen/s; 5 Schlüssel
- API Plus – 79 €: 500.000 / 500.000 / 250.000 / 1,25 Mio. / 50.000 / 5 Mio.; 30 Anfragen/s; 20 Schlüssel
- API Pro – 249 €: 2 Mio. / 2 Mio. / 1 Mio. / 5 Mio. / 200.000 / 20 Mio.; 50 Anfragen/s; 50 Schlüssel
Auch API Free darf gewerblich genutzt werden. Die Nutzung des laufenden Monats je Endpunktklasse sehen Sie im Konto unter API-Schlüssel.
Harte Grenze statt Nachberechnung: Ist ein Kontingent aufgebraucht, antwortet die API mit HTTP 429 bis zum Monatsende oder bis Sie eine größere Stufe buchen (gilt sofort, anteilig berechnet). Bei 80 % und 100 % eines Kontingents bekommen die Admins des Kontos eine Warnmail. Es entstehen nie überraschende Kosten.
Pflichten: Schlüssel geheim halten (nicht ungeschützt in öffentlich lesbaren Code), bei Verdacht sofort Widerrufen. Die Namensnennung „© OpenStreetMap-Mitwirkende“ ist bei der Anzeige von Ergebnissen Pflicht. Nicht erlaubt ist, Kartendaten in großem Umfang abzuziehen oder einen eigenen Kartendienst für Dritte auf unserer API zu betreiben.