Zum Inhalt

Einführung in SmartMaps Area

SmartMaps Area ist eine leistungsstarke JavaScript-Bibliothek, die eine einfache und effiziente Möglichkeit bietet, mit der SmartMaps Area API zu interagieren. Sie ermöglicht es Ihnen, Grenz- und Postleitzahlengebietsdaten für bestimmte geografische Punkte, Rechtecke oder OpenStreetMap-(OSM)-IDs abzurufen.

Hauptfunktionen

  • Verwaltungsebenen: Greifen Sie auf detaillierte Verwaltungsgrenzen zu, basierend auf den admin_level-Werten von OpenStreetMap, die von nationalen Grenzen (Ebene 2) bis zu Wahlbezirken und Schulbezirken (Ebene 11) reichen.

  • Flexible Endpunkte: Nutzen Sie verschiedene Endpunkte, um Gebietsdaten abzurufen:

  • Abrufen von Grenzen und Gebieten an einem bestimmten geografischen Punkt
  • Abrufen von Grenzen und Gebieten innerhalb eines definierten rechteckigen Bereichs

  • Zugriff auf Grenzen und Gebiete, die bestimmten OSM-IDs zugeordnet sind

  • Anpassbare Query-Parameter: Passen Sie Ihre Anfragen mit einer Vielzahl von Query-Parametern an, darunter geografische Filter (isoCountries, isoLanguages), Geometriegenauigkeit (reduceGeometry, zoom) und mehr.

  • GeoJSON-FeatureCollections: Erhalten Sie API-Antworten als standardisierte GeoJSON-FeatureCollections – ein konsistentes und leicht interpretierbares Format für die nahtlose Integration mit Kartenbibliotheken und GIS-Tools.

Erste Schritte

So starten Sie mit SmartMaps Area:

  1. Installieren Sie die Bibliothek über npm: 

    npm install @smartmaps/area

  2. Importieren Sie die Klasse Area aus dem Paket: 

    import { Area } from '@smartmaps/area';

  3. Erstellen Sie eine neue Area-Instanz mit Ihrem API-Key: 

    const area = new Area('[INSERT API-KEY]');

  4. Verwenden Sie die verfügbaren Methoden, um Gebietsdaten abzurufen: 

    const boundariesPointRequest = {
  latitude: 49.02,
  longitude: 8.44,
  // Additional parameters...
};

const boundaryData = await area.point(boundariesPointRequest);

Unterstützte Endpunkte

SmartMaps Area bietet die folgenden Endpunkte:

  • Area data by point: Nimmt Breitengrad, Längengrad und weitere Parameter entgegen, um die gewünschten Grenzdaten für einen oder mehrere Standorte zurückzugeben. Nützlich, um Grenz- oder Postleitzahleninformationen für bestimmte geografische Punkte abzurufen.

  • Area data by rectangle: Ruft die gewünschten Grenzdaten basierend auf einer bestimmten geografischen Region ab, die als Begrenzung angegeben wird. Gibt alle definierten Grenz- oder Postleitzahlengeometrien innerhalb des Rechtecks zurück.

  • Area data by OSM ID: Ruft Gebietsdaten für bestimmte Geometrien ab, indem eine oder mehrere OSM-IDs angegeben werden. Gibt alle definierten Grenz- oder Postleitzahlengeometrien zurück, die den angegebenen IDs zugeordnet sind.

Area Service API

Die Area Service API bietet eine umfassende REST-Schnittstelle zum Abfragen geografischer Grenzen und Gebiete. Sie unterstützt sowohl JSON- als auch GeoJSON-Formate und gewährleistet so die Kompatibilität mit einer Vielzahl von Anwendungen.

Mit SmartMaps Area können Sie leistungsstarke Funktionen zur Abfrage von Grenzen und Gebieten einfach in Ihre Anwendungen integrieren und so standortbasierte Dienste, räumliche Analysen und eine nahtlose Integration mit Kartenplattformen ermöglichen.