Kostenlose Wetter-API mit Luftqualität in einem Aufruf

Sie erstellen eine App zur Waldbrandbenachrichtigung, einen Laufroutenplaner oder ein E-Commerce-Banner das auf die lokale Luftqualität reagiert. Sie benötigen die aktuelle Temperatur, die Regenbedingungen und PM2,5 von derselben API. Jeder beliebte Wetteranbieter gibt die Luftqualität hinter einem separaten Produkt an Tier, ein separater API-Schlüssel oder ein Unternehmensvertrag. Dafür sollten Sie nicht 40 US-Dollar pro Monat zahlen müssen Teilen Sie einem Benutzer mit, ob es sicher ist, draußen zu joggen.

Die Botoi-API bietet Ihnen /v1/weather/current Und /v1/air-quality/check auf demselben freien Schlüssel. Zwei POST-Endpunkte, JSON in und JSON aus und 1000 Anfragen pro Tag, sobald Sie sich angemeldet haben.

Warum sich AQI hinter einer Paywall verbirgt

OpenWeatherMap verkauft seine Air Pollution API als Upgrade. Der kostenlose Plan deckt das aktuelle Wetter ab und eine Fünf-Tage-Vorhersage, aber historische Luftqualität und höhere AQI-Anrufgrenzen leben auf der Professional- und Enterprise-Stufen beginnen bei 40 $ pro Monat. Sie tragen außerdem einen separaten API-Schlüssel bei sich pro Produktfamilie, so dass ein Hobbyprojekt am Ende mit zwei Dashboards jongliert.

WeatherAPI.com wirbt mit einer Million kostenloser Anrufe pro Monat und liefert diese auch für das Wetter. Die Luftqualität ist im Pro-Plan gebündelt. AccuWeather hält AQI auf seiner Enterprise-Stufe mit einem Tor für Verkaufsgespräche. Tomorrow.io bietet Ihnen eine Testversion mit Tarifobergrenzen, die so niedrig sind, dass sie eine einzelne Seite umfassen Refresh verschlingt Ihr Budget.

Anbieterin	Kostenlose Anrufe	AQI-frei?	Auth	Kombinierte Endpunkte?
veröffentlicht	5/Min. anonym, 1000/Tag verschlüsselt	Ja	Ein Schlüssel für beides	Zwei POST-Endpunkte, ein Schlüssel
OpenWeatherMap	1000/Tag	Nein (kostenpflichtiges Upgrade)	Separater Schlüssel pro Produkt	Nein, aufgeteilt auf alle Produkte
WeatherAPI.com	~1 Mio./Monat	Nein (Pro-Stufe)	Ein Schlüssel, Pro Gate	Einzelner Endpunkt, nur Pro
AccuWeather	50/Tag Testversion	Nein (Unternehmen)	Verkaufgeschützt	NEIN

Erhalten Sie das aktuelle Wetter auf einen Schlag

Der /v1/weather/current Der Endpunkt akzeptiert einen Stadtnamen, eine Postleitzahl oder einen Breiten-/Längengrad Paar. Es gibt die Temperatur in Celsius und Fahrenheit, die Luftfeuchtigkeit, die Windgeschwindigkeit und einen Text zurück Bedingung, eine Symboltaste, die Sie Ihrem eigenen Sprite-Sheet zuordnen können, und die aufgelösten Koordinaten.

Antwort:

Haltet fest lat Und lon Felder. Sie werden sie direkt hineinfüttern den Luftqualitätsendpunkt, damit Sie keinen zweiten Geokodierungsaufruf verbrennen.

Fügen Sie Luftqualität in einer zweiten Locke hinzu

Der /v1/air-quality/check Der Endpunkt verwendet Breiten- und Längengrade und gibt die US-EPA-Luft zurück Qualitätsindex, eine Kategoriebezeichnung und die einzelnen Schadstoffkonzentrationen. PM2,5 und PM10 sind die beiden Zahlen, die den meisten Gesundheits-Apps wichtig sind; Der Rest umfasst Ozon, Stickstoffdioxid, Schwefeldioxid und Kohlenmonoxid für strengere Anwendungsfälle.

Antwort:

Ein AQI von 62 mit der Bezeichnung „Mittel“ bedeutet, dass die meisten Menschen nach draußen gehen können, aber jeder mit Asthma sollte es ruhig angehen lassen. Der aqi_category Das Feld erspart Ihnen das Einsortieren der Nummer Sie selbst und sorgt dafür, dass Ihre UI-Kopie mit der offiziellen EPA-Sprache konsistent ist.

Kombinieren Sie beides in einer einzigen Node.js-Funktion

Die meisten Apps wünschen eine Nummer pro Stadt und nicht zwei separate Hin- und Rückfahrten, die über die ganze Stadt verteilt sind Codebasis. Diese 40-Zeilen-Funktion umschließt beide Endpunkte, verarbeitet Zeitüberschreitungen und gibt eine zusammengeführte Funktion zurück Objekt, das Sie in jedes Dashboard einfügen können.

Die Funktion führt zwei aufeinanderfolgende Aufrufe aus, da der zweite Koordinaten vom ersten benötigt. Wenn Sie bereits Lat/Lon-Werte aus einer früheren Anfrage zwischengespeichert haben, führen Sie beide Aufrufe parallel aus Promise.all und die Latenz halbieren. Knoten 20+ verfügt über native fetch Und AbortController, sodass Sie weder Axios noch Node-Fetch benötigen.

Drei reale Anwendungen mit Code

Laufroutenplaner

Eine Fitness-App schlägt Outdoor-Routen vor. Wenn PM2,5 ansteigt oder ein Gewitter aufzieht, Routenvorschläge sollten pausieren und eine Indoor-Alternative anzeigen. Diese Funktion gibt einen von zurück drei Zustände: Go, Skip oder Advisory.

Die Drei-Staaten-Rückkehr ist wichtig. Ein binäres Ja/Nein verbirgt den Mittelweg, in dem der Lauf ausgeführt wird ist in Ordnung, aber kürzer ist intelligenter. Empfindliche Benutzer schätzen die Nuancen und meiden sie erfahrene Läufer werden durch übervorsichtige Warnungen frustriert.

E-Commerce-Banner für Luftreiniger

Ein Haushaltswarengeschäft verkauft Luftreiniger. Wenn ein Besucher aus einer Stadt mit einem AQI über 100 anreist, Das Produkt ist wirklich nützlich, also bringen Sie es zum Vorschein. Wenn die Luft sauber ist, verstecken Sie das Banner fühlt sich nicht nach Angstmarketing an.

Holen Sie sich die Konditionen selbst /api/conditions Proxy, damit Ihr API-Schlüssel erhalten bleibt auf dem Server. Zwischenspeichern Sie das Ergebnis pro Stadt 30 Minuten lang am Rand. AQI bewegt sich langsam genug Diese halbstündige Frische reicht für ein Schaufensterbanner völlig aus.

Voraussichtliche Lieferung mit Wetterpuffer

Eine Liefer-App zeigt eine voraussichtliche Ankunftszeit von 25 Minuten an. Starker Regen in der Stadt des Fahrers bedeutet 10 weitere Minuten. Gewitter bedeuten 20. Das Hinzufügen des Puffers vor der Anzeige der voraussichtlichen Ankunftszeit verhindert Enttäuschungen Kunden verfolgen einen verspäteten Fahrer.

Halten Sie die Pufferregeln einfach. Sowohl Fahrer als auch Kunden vertrauen ETAs, die innerhalb der USA landen Fenster und 10 bis 20 Minuten Polsterung bei nassem Wetter ist eher ehrlich als defensiv.

Tarifgrenzen und Schlüssel

Der anonyme Zugriff ermöglicht 5 Anfragen pro Minute und 100 pro Tag, IP-basiert. Das reicht aus Erstellen Sie eine Demo oder vernetzen Sie ein persönliches Projekt, ohne sich anzumelden.

Melden Sie sich für einen kostenlosen Schlüssel an unter botoi.com/api um die Obergrenze auf 1000 Anfragen zu erhöhen pro Tag. Der gleiche Schlüssel funktioniert sowohl für das Wetter als auch für die Luftqualität sowie für mehr als 190 weitere Endpunkte die Plattform. Drücken Sie eine 429 und die API gibt eine zurück Retry-After Header in Sekunden so Ihr Kunde kann sich sauber zurückziehen.

Wichtige Punkte

• /v1/weather/current Nimmt eine Stadt, eine Postleitzahl oder einen Breitengrad/Längengrad und gibt die Temperatur zurück. Luftfeuchtigkeit, Wind, eine Textbedingung und Koordinaten.
• /v1/air-quality/check Nimmt Lat/Lon und gibt US EPA AQI zurück, eine Kategoriebezeichnung, und PM2,5-, PM10-, O3-, NO2-, SO2- und CO-Messwerte.
• Beide Endpunkte teilen sich einen API-Schlüssel. Jeder andere Anbieter berechnet für AQI einen Aufpreis oder verbirgt es hinter einem Firmentor.
• Das kostenlose Kontingent umfasst 5 anonyme Anfragen pro Minute und 1.000 pro Tag mit einem Schlüssel. Antworten sind Edge-Cache auf Cloudflare Workers für eine Latenz von weniger als 100 ms.
• Speichern Sie das Wetter für 15 Minuten und den AQI für 30 Minuten in Ihrer App. Keiner von beiden bewegt sich schnell genug Sie benötigen Echtzeit-Abfragen und Caching hält Sie auch bei hohen Anforderungen im kostenlosen Kontingent Dashboards.