Weather API - 都市または座標ごとの現在の状況
都市名または緯度/経度で指定された場所の現在の気象データを返します。 応答には、温度 (体感温度を含む)、湿度、降水量、風速と風向、雲量、数値気象コード、および人間が判読できる説明が含まれます。
Code examples
curl -X POST https://api.botoi.com/v1/weather/current \
-H "Content-Type: application/json" \
-d '{"city":"London","lat":51.5074,"lng":-0.1278}'When to use this API
地元の天気に基づいた動的なコンテンツ
訪問者の地元の天気に基づいて、ホームページのバナーや製品の推奨をパーソナライズします。 小売店サイトでは、雨が降っているときは傘を、晴れた空には日焼け止めを宣伝することで、コンテキストの関連性とともにコンバージョン率を高めることができます。
物流・配送ルートの計画
ドライバーを派遣する前に、配送ルートの気象状況を確認してください。 強風や降水量が多いルートにフラグを立てて、配送担当者が商品とドライバーの安全を守るためにルートを変更したり、出荷を遅らせたりできるようにします。
IoTとスマートホームオートメーション
現在の気象データをポーリングして、スマート ホーム アクションをトリガーします。 雲量が 20% を下回ったら電動ブラインドを閉めたり、降水量がゼロの場合にのみスプリンクラーを作動させたり、体感温度に基づいてサーモスタットの設定値を調整したりできます。
Frequently asked questions
都市名または座標を使用する必要がありますか?
どちらでも機能します。 都市名はユーザー向けの入力に便利です。 複数の都市が同じ名前を共有する場合、座標はより正確になり、曖昧さがなくなります (たとえば、「スプリングフィールド」は米国の 30 を超える州に存在します)。
返される温度単位は何ですか?
デフォルトでは、温度は摂氏で返されます。 応答の単位フィールドでこれが確認されます。 クライアント側で式 F = C * 9/5 + 32 を使用して華氏に変換します。
気象データはどのくらいの頻度で更新されますか?
気象データは上流のソースから 15 分ごとに更新されます。 ほとんどのアプリケーションでは、ユーザー側で 10 ～ 15 分間応答をキャッシュすると安全であり、API 呼び出しが減ります。
Weather_code フィールドは何を表しますか?
Weather_code は、数値の WMO 気象解釈コードです。 一般的な値: 0 = 晴天、1 ～ 3 = 部分的に曇り、45/48 = 霧、51 ～ 67 = 霧雨/雨、71 ～ 77 = 雪、80 ～ 82 = にわか雨、95+ = 雷雨。 説明フィールドには、人間が読めるラベルが表示されます。
都市も座標も指定されていない場合はどうなりますか?
エンドポイントは、都市名または緯度/経度のペアのいずれかを入力するように求めるエラーを返します。 少なくとも 1 つの位置パラメータが必要です。
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.