Zum Inhalt

Area Service

Der Area Service bietet eine REST API zur Abfrage geografischer Grenzen und Gebiete basierend auf geografischen Koordinaten oder OpenStreetMap-IDs (OSM). Diese API unterstützt sowohl JSON- als auch GeoJSON-Formate und gewährleistet damit eine nahtlose Integration in eine Vielzahl von Anwendungen.

Hauptfunktionen

Verwaltungsebenen

Die API nutzt die admin_level-Werte von OpenStreetMap, um detaillierte Einblicke in verschiedene Verwaltungsgrenzen zu bieten. Diese Ebenen reichen von nationalen Grenzen (Ebene 2) bis hin zu Wahlbezirken und Schulbezirken (Ebene 11), mit der Flexibilität, zusätzliche Ebenen je nach regionalen Gegebenheiten zu berücksichtigen. Diese hierarchische Struktur ermöglicht präzise und kontextspezifische Grenzabfragen.

Endpunkte

Die Area Service API bietet mehrere Endpunkte, um unterschiedlichen Anforderungen an geografische Daten gerecht zu werden:

  • Grenzen an einem Punkt abrufen: Rufen Sie Grenzen und Gebiete an einem bestimmten geografischen Punkt über eine einfache POST- oder GET-Anfrage ab. Passen Sie Ihre Abfrage mit Parametern wie apiKey, level, latitude und longitude an.

  • Grenzen in einem Rechteck abrufen: Definieren Sie eine rechteckige Ausdehnung, um Grenzen und Gebiete innerhalb dieser Region zu erhalten. Dieser Endpunkt eignet sich ideal für die Analyse größerer geografischer Gebiete.

  • Grenzen für eine OSM-ID abrufen: Greifen Sie auf Grenzen und Gebiete zu, die mit einer bestimmten OpenStreetMap-ID verknüpft sind, und erhalten Sie so eine direkte Verbindung zu den umfangreichen geografischen Daten von OSM.

Flexible Query-Parameter

Unsere API unterstützt eine breite Palette an Query-Parametern, darunter:

  • Geografische Filter: Verwenden Sie isoCountries und isoLanguages, um Ergebnisse nach Land und Sprache zu filtern.
  • Geometriegenauigkeit: Passen Sie den reduceGeometry-Faktor und die zoom-Ebene an, um die Detailgenauigkeit der zurückgegebenen Geometrien zu steuern.

GeoJSON FeatureCollections

Alle API-Antworten werden als GeoJSON FeatureCollections geliefert, was ein standardisiertes und leicht interpretierbares Format bietet. Jede Antwort umfasst:

  • Type: Den Typ des GeoJSON-Objekts ("FeatureCollection").
  • Bounding Box: Die Bounding Box der Grenzen.
  • Features: Ein Array einzelner Grenzen und Gebiete, inklusive Geometrie und zusätzlicher Eigenschaften wie Namen, ISO-Codes und Postleitzahlen.

Nutzen Sie die Area Service API, um das Potenzial geografischer Daten in Ihren Anwendungen zu erschließen. Egal, ob Sie standortbasierte Dienste entwickeln, räumliche Analysen durchführen oder eine Integration mit Kartenplattformen vornehmen — unsere API bietet Ihnen die Werkzeuge, die Sie für präzise und effiziente Grenzabfragen benötigen.