Einführung in SmartMaps Weather

SmartMaps Weather ist eine einfache und effiziente Bibliothek, mit der Sie mit der SmartMaps Weather API interagieren können. Sie bietet praktische Methoden zum Abrufen von Wetterdaten und Vorhersagen für bestimmte Standorte in ganz Europa, damit Sie Ihre Anwendungen um genaue und zuverlässige Wetterinformationen erweitern können. Die Daten werden vom „Deutschen Wetterdienst" bereitgestellt.

Hauptfunktionen

• Vielfältige Datenmodelle: Die Bibliothek verwendet verschiedene Datenmodelle zur Strukturierung der Wetterdaten, darunter:

  • Address: Repräsentiert eine Adresse mit Eigenschaften wie Land, Bezirk, Postleitzahl, Stadt, Straße und Hausnummer.
  • Coordinates: Repräsentiert geografische Koordinaten mit Breiten- und Längengrad.
  • Feature und FeatureCollection: Repräsentieren GeoJSON-Feature- und FeatureCollection-Objekte für strukturierte Wetterdaten.
  • HourlySummaryModel: Liefert stündliche zusammengefasste Wetterdaten, einschließlich Wetterbeschreibung, Temperatur, Wind, Luftfeuchtigkeit, Regen und Bewölkung.
  • WeatherPredictionWithWeatherDetailsModel: Bietet detaillierte Wettervorhersagedaten für bestimmte Zeitstempel.
  • WeatherResponse: Repräsentiert die gesamte Wetterantwort, einschließlich Copyright-Informationen, Adresse, Koordinaten, aktuellem Wetter, stündlichem Wetter, stündlicher Zusammenfassung und Zeitzone.

• Flexible Endpunkte: Die Bibliothek unterstützt verschiedene Endpunkte für unterschiedliche Anwendungsfälle:

  • Abrufen von Wetterdaten für einen bestimmten geografischen Punkt anhand von Breiten- und Längengrad.
  • Abrufen von Wetterdaten für eine bestimmte Adresse anhand detaillierter Adressparameter.
  • Zugriff auf Wetterdaten für einen bestimmten Standort anhand einer Standort-ID.
  • Abrufen von Wetterdaten innerhalb eines festgelegten rechteckigen Bereichs.
  • Abrufen von Wetterdaten entlang einer definierten Polylinie, nützlich für routenbasierte Wetterinformationen.

• Anpassbare Query-Parameter: Passen Sie Ihre Wetterdatenanfragen mit einer Reihe von Query-Parametern an:

  • Legen Sie den Zeitraum für Wetterdaten mit DateTimeFrom und DateTimeUntil fest.
  • Passen Sie den Detaillierungsgrad der Wetterdaten mit dem Parameter Details an.

• GeoJSON-Antworten: Die Bibliothek liefert Wetterdaten im standardisierten GeoJSON-Format zurück, was die Integration mit Kartenbibliotheken und Geoinformationssystemen erleichtert.

Erste Schritte

So starten Sie mit SmartMaps Weather:

1. Installieren Sie die Bibliothek über npm:

   npm install @smartmaps/weather
   

2. Importieren Sie die Klasse Weather aus dem Paket:

   import { Weather } from '@smartmaps/weather';
   

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

   const weather = new Weather('[INSERT API-KEY]');
   

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

   const weatherPointRequest = {
     latitude: 49.02,
     longitude: 8.44,
     // Additional parameters...
   };
   
   const currentWeather = await weather.point(weatherPointRequest);
   

Weather API-Referenz

Die SmartMaps Weather API bietet einen umfassenden Satz an Endpunkten zum Abrufen von Wetterdaten. Hier sind die wichtigsten Endpunkte:

• Get Weather at a Point: Ruft Wetterdaten für einen bestimmten geografischen Punkt über eine GET-Anfrage ab.

• Get Weather by Address: Ruft Wetterdaten für eine bestimmte Adresse über eine GET-Anfrage ab.

• Get Weather by Location: Ruft Wetterdaten für einen bestimmten Standort über eine GET-Anfrage ab.

• Get Weather in a Rectangle: Ruft Wetterdaten innerhalb eines rechteckigen Bereichs über eine GET-Anfrage ab.

• Get Weather along a Polyline: Ruft Wetterdaten entlang einer Polylinie über eine POST-Anfrage ab.

Mit SmartMaps Weather können Sie Wetterdaten mühelos in Ihre Node.js-Anwendungen integrieren und Ihren Nutzern genaue und aktuelle Wetterinformationen für Standorte in ganz Europa bereitstellen.