コンテンツへスキップ
POST AI agent ready /v1/weather/current

Weather API - 都市または座標ごとの現在の状況

都市名または緯度/経度で指定された場所の現在の気象データを返します。 応答には、温度 (体感温度を含む)、湿度、降水量、風速と風向、雲量、数値気象コード、および人間が判読できる説明が含まれます。

Parameters

string

City name to look up weather for. Provide either city or lat/lng.

number

Latitude of the location. Use with lng.

number

Longitude of the location. Use with lat.

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.

Sign up free View full docs