Zum Inhalt

Einführung in SmartMaps Timezone

SmartMaps Timezone ist eine einfache und effiziente Bibliothek, mit der Sie mit der SmartMaps Timezone API interagieren können. Sie bietet eine bequeme Möglichkeit, detaillierte Zeitzoneninformationen für jeden geografischen Standort abzurufen, sodass Sie Ihre Anwendungen um präzisen zeitlichen Kontext erweitern können.

Hauptfunktionen

  • Zeitzoneninformationen in Echtzeit: Greifen Sie auf genaue und aktuelle Zeitzonendaten für jeden Punkt der Erde zu, indem Sie Breiten- und Längengrad angeben. Rufen Sie umfassende Informationen ab, einschließlich der aktuellen Zeitzone, der Ortszeit und des UTC-Offsets.

  • Unterstützung der Sommerzeit: Ermitteln Sie einfach, ob an einem Standort aktuell die Sommerzeit gilt. Die API liefert detaillierte Informationen zum Sommerzeitstatus der Zeitzone, sodass Sie Ihre Zeitberechnungen in der Anwendung entsprechend anpassen können.

  • Sonnenaufgangs- und Sonnenuntergangszeiten: Zusätzlich zu den Zeitzonendaten kann die API Sonnenaufgangs- und Sonnenuntergangszeiten für jeden beliebigen Standort liefern. Diese Funktion ist besonders nützlich für Anwendungen, die Solardaten benötigen, etwa Wettervorhersagen, Fotografieplanung oder die Planung von Outdoor-Aktivitäten.

Erste Schritte

So starten Sie mit SmartMaps Timezone:

  1. Installieren Sie die Bibliothek über npm: 

    npm install @smartmaps/timezone

  2. Importieren Sie die Klasse Timezone aus dem Paket: 

    import { Timezone } from '@smartmaps/timezone';

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

    const timezone = new Timezone('[INSERT API-KEY]');

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

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

const currentTime = await timezone.currentPoint(currentPointRequest);

Unterstützte Endpunkte

SmartMaps Timezone bietet die folgenden Endpunkte:

  • Current Timezone API (current/point): Nimmt Breitengrad, Längengrad und weitere Parameter entgegen, um die aktuelle Zeitzone für einen bestimmten Standort zurückzugeben. Nützlich, wenn Sie die Zeitzone eines geografischen Punkts wissen möchten.

  • Convert Timezone API (convert/point): Konvertiert die Uhrzeit von einer Zeitzone in eine andere. Nimmt Parameter wie Datum/Uhrzeit, Breitengrad, Längengrad oder Zeitzonen-ID entgegen und gibt die Uhrzeit in der Zielzeitzone zurück.

Timezone-API-Referenz

Die SmartMaps Timezone API bietet einen umfassenden Satz an Endpunkten zum Abrufen und Konvertieren von Zeitzonendaten. Hier sind die wichtigsten Endpunkte:

  • Get Current Timezone at a Point: Ruft aktuelle Zeitzonendaten für einen bestimmten geografischen Punkt über eine GET-Anfrage ab.

  • Get Current Timezone for Multiple Points: Ruft aktuelle Zeitzonendaten für mehrere geografische Punkte über eine POST-Anfrage ab.

  • Convert Timezone for a Point: Konvertiert Zeitzonendaten für einen bestimmten geografischen Punkt und Zeitpunkt über eine GET-Anfrage.

  • Convert Timezone for Multiple Points: Konvertiert Zeitzonendaten für mehrere geografische Punkte und Zeitpunkte über eine POST-Anfrage.

Mit SmartMaps Timezone können Sie Zeitzonenfunktionalität einfach in Ihre Node.js-Anwendungen integrieren und so für jeden geografischen Standort genaue und zuverlässige zeitliche Daten sicherstellen.