OpenWeatherAPIキー(無料枠)の登録方法

 - OpenWeatherの概要と特徴 -

 

 

 

※登録手順中の画像は,OpenWeather公式サイト(https://openweathermap.org/)より引用させていただいております。本マニュアルはLP&D Laboratoryが独自に作成した非営利のものであり,OpenWeatherの公式マニュアルではありません。

 


1.はじめに

 

 以下でOpenWeatherの概要と特徴,種々の使用形態について説明します。OpenWeather無料APIキーの登録を早く進めたい場合には,上記の『スマホで登録ダイジェスト版』,『スマホで登録の場合はここをクリック【詳細版】』あるいは『PCで登録の場合はここをクリック』ボタンを押してください。

 

【OpenWeatherとは?】

 OpenWeather(OpenWeatherMap)は、イギリス(英国)のロンドンに本社を置く気象インテリジェンス企業です。2014年頃から活動しており、世界中の気象データをAPI経由で提供するクラウドベースのプラットフォームを運営しています。無料枠が充実しており、個人開発から商用アプリまで幅広く利用されている非常に有名な天気データプラットフォームです。

 

【OpenWeatherは無料で使えますか?】

 OpenWeather(OpenWeatherMap)には,無料(永久無料アクセス),有料枠のワンコールAPI 3.0(One Call API 3.0),スタートアップ,デベロッパー,プロフェッショナル,エキスパートと種々の登録枠があります。無料枠のみで登録すれば,課金されることはありません。このページでは,無料(永久無料アクセス)枠のAPIキーを対象とした登録法を説明しています。もし登録の途中で,カード情報等の課金用の入力を求められた場合には,無料(永久無料アクセス)枠とは異なる有料枠の登録に迷い込んでしまっています。たとえば,One Call 3.0はカード登録が必要な別メニューです。その場合の対処法に関しては,スマホでの登録の場合はこちら【詳細版】をご覧ください。無料(永久無料アクセス)枠の登録で必要となるのでは,e-mailアドレスのみです。

 

サービス料金の詳細と制限事項」に関しては,以下のOpenWeatherのページで確認できます(Google Chromeの日本語翻訳機能で,わかりやすく表示されます)。

https://openweathermap.org/full-price

 

【APIキーのご利用にあたって】

• 本アプリ(気象暑さ指数モニター WBGT Simple 等)は、OpenWeatherMapが提供するAPIを利用してデータを表示します。

• APIキーの取得・運用に関しては、OpenWeatherMapの最新の利用規約(無料プランの制限等)を遵守してください。

 利用規約の抜粋・概略を本ページの最後にまとめておりますので,ご参照下さい。

• APIキーの管理、および利用に伴う判断は、ユーザー様の責任において行っていただきますようお願いいたします

 

【無料(永久無料アクセス)枠での制限事項は?】

 (1)無料(永久無料アクセス)枠では,現在の天気に関する気象データCurrent Weather Data)のみが提供され,天気予報に関する情報が必要な場合には,他の有料枠への登録が必要になります。熱中症対策用の気象暑さ指数モニター WBGT Simple (無料・無広告)アプリは,現在の屋外・屋内暑さ指数を知るための,無料枠用のアプリとなっています。(有料枠のOne Call API 3.0登録の場合でも,本アプリを使用することは可能ではありますが,その動作を保障するものではありません。)

 

(2)APIコール(APIキーでの呼び出し)による気象データの取得が,1分間に60件,月間100万件に制限されています。この件数を超えた場合に課金されることはありませんが,APIコールがエラーになり,制限を超えた直後のリクエストに対,HTTPステータスコード「429 Too Many Requests」が返され,、データ取得が一時的に停止します。この制限は通常、数時間から数日程度の時間経過で自動的に解除されます(最新の規約では、超過時に登録メールアドレスへ通知が届き、対応がない場合はAPIキーが一時停止される運用が追加されています)。

 

【1ユーザーが取得できるAPIキーの数に制限はありますか?】

(1)1つの登録(アカウント作成)で取得できるAPIキーの数に制限はありません。以下の表のように,複数のAPIキーを,名前を付けて追加生成することができます。ただし,生成したすべてのAPIキーの呼び出しの総数は,1分間に60件,月間100万件に制限されています。

 

 

(2)個人ユーザーの場合には,最初に生成するデフォルトAPIキーをご使用されることが手っ取り早い(APIキー登録後に有効になるまでの時間が短い)ですが,セキュリティー上はサブキーをお使いいただくことが好ましいです。

 

 

※APIキー作成直後は、サーバー側で有効化されるまでに、数十分から数時間かかる場合があります。ソフトウェアやアプリで通信エラーが発生する場合は、しばらく時間を置いてから再度お試しください。

 

(3)以下の表に,1アカウントの無料枠APIキーで動作可能なスマホの台数を,1日の使用時間を12時間,月の使用日数を30日として試算した結果を示しました。例えば,30分間隔で使用した場合でも,23台となります。

 これより,大規模組織・多拠点の場合には,有料枠でのAPIキーの登録が必要になると思われます。

 

※推算においては,複数台のスマホから一定の時間的スパン(幅)を持ってAPIコールが行われることを仮定しています。月間100万件以下であっても,1分間に60件を超えた場合にはAPIコールがエラーになります。

 

※以下の推算表はあくまで目安であり,個人ごとにアカウントを作成することを推奨します。

 

 

【気象暑さ指数モニター WBGT Simple(無料・無広告アプリ)では,APIコールの間隔(受信間隔)はどのように設定したらよいですか?】

 本アプリ(気象暑さ指数モニター WBGT Simple 等)での受信間隔の初期設定(アプリを立ち上げた時に設定されるAPIキーの自動呼出し間隔)は,1分間に設定されています(10分間に変更しました)。これは,ユーザーの方々にリアルタイムでの気象データ受信と屋外・屋内暑さ指数計測が働いていることを実感していただくためです。実際の気象暑さ指数モニター WBGT Simpleの運用では,APIコール間隔をもっと長くしておいたほうがよいかもしれません。

 OpenWeatherのサイトでの説明では,天気APIデータの更新は2時間とされていますが,これは天気予報等を含んでのことだと思われます。実際に,現在の天気に関する気象データを受信して時間変化で確認してみますと,数分から数十分間隔での気象データの変化が観察されました(「気象暑さ指数モニターWin版マニュアル」サイトの暑さ指数の時間変化のグラフ参照: https://www.lpd-lab.com/weather-wbgt/気象暑さ指数モニターwin版マニュアル/)。気象データの更新間隔には地域差もあるようですが,例えば,気象暑さ指数モニター WBGT Simpleアプリでの受信間隔を30分ぐらいに設定しておけば,屋外・屋内暑さ指数の変化を十分に把握できると思われます。

 

【気象暑さ指数モニター WBGT Simpleアプリを快適にご利用いただくために】

  アプリの設定画面での受信間隔は,気象データの更新間隔が数分から数十分間隔であるため,無駄なAPIコールを無くすために,受信間隔を10分以上にする設定を推奨します。

 

🔶本アプリでは,最新の気象状況を反映したWBGT値をお届けするため、以下のタイミングで自動的にデータを更新します。

(1)アプリ起動時。

(2)スリープ解除時(スマホ画面をつけた時)。

(3)アプリ内のページが切り替わった時。

(4)メインメニューの「更新」ボタンのタップ時。

 上記の特性から,APIコールの間隔を長く設定しておいて,知りたいときだけ,屋外・屋内暑さ指数の現在値を表示させるような使い方もできます。

※本アプリは,スマホのスリープ時に,バックグラウンドでのAPIコールは行いません。

 

2.種々の使用形態のイメージ

 

 以下に種々の使用形態のイメージをお示ししました。

 

(1)個人で使用の場合

 気象暑さ指数モニター WBGT Simpleアプリと無料(永久無料アクセス)枠登録で,十分に屋外・屋内暑さ指数のモニターが可能です。

 

 

(2)家族で使用の場合

 家族のどなたかが,OpenWeather への登録の補助を行うことで,家族の安全とセキュリティーを高めることができます。

 

 

(3)中小規模の作業現場で使用の場合

 リーダーやネットワーク管理者等が,OpenWeather への登録の補助を行うことで,グループの安全とセキュリティーを高めることができます

 

 

(4)大規模組織・多拠点の場合で使用の場合

 有料枠でのAPIキーの登録が必要になると思われます。

 

 

 

 OpenWeatherのサービス料金の詳細と制限事項」に関しては,以下のページで確認できます(Google Chromeの日本語翻訳機能で,わかりやすく表示されます)。

https://openweathermap.org/full-price

 

 上記のようなOpenWeatherからの気象データ取得の概要と特徴を踏まえて,ご自身にあった形態で,熱中症対策用の気象暑さ指数モニター WBGT Simple (無料・無広告)を有効にご利用いただき,お役にたてることが少しでもあれば幸いです。

 

実際の登録方法は,以下のリンクで詳細にご説明しています。

もし登録方法で戸惑うことがありましたら,本ホームページの Contact USからお問い合わせください。

 


 

本マニュアルはLP&D Laboratoryが独自に作成した非営利のものであり、OpenWeatherの公式マニュアルではありません。

 

3.OpenWeather 利用規約について

 

1. 複数アカウントによる制限回避の禁止【無料枠の制限回避の禁止】

 

 OpenWeatherの無料プランには利用回数制限があります。この制限を逃れるために,一人が複数のアカウントを作成してAPIキーを使い分ける行為は,サービスの不正利用として禁止されています

 Website Terms and Conditions: Users are not allowed to create multiple accounts for the purpose of circumventing the usage limits of the free tier.

 

2.第三者へのデータ配布・共有の禁止【データの第三者共有の禁止】

 取得した気象データをそのまま第三者に配布したり,共有したりすることは禁じられています。そのため,管理者が取得したAPIキーをチームやグループで使い回すのではなく,利用者ご自身でアカウントを作成し,直接データを取得する必要があります(1人1アカウントの原則)。

 Terms and Conditions of Sale - Section 6: The Customer shall not resell, share, distribute, or otherwise provide the Services or Data to any third party.

 

3.アカウント管理とパスワードの機密性 【APIキーの機密保持】

 APIキーはパスワードと同様に扱われるべき機密情報です。他人に公開したり共有したりせず,ご自身の管理下で適切に使用してください。

 Registration and password: You must treat your password and API key as confidential and must not disclose it to any third party.

 

 ----------------------------------------------------------

【商標およびライセンスについて】

•OpenWeatherは、OpenWeather Ltd.の商標または登録商標です。

•本資料に記載されているその他の会社名,製品名は,各社の商標または登録商標です

【気象データの利用について】

本プロジェクト(WBGT管理システム)では、リアルタイムな気象情報を取得するために OpenWeather のAPIサービスを利用しています。

•提供元: OpenWeather (https://openweathermap.org/)

•ライセンス: 本システムが取得・利用する気象データは、Open Database License (ODbL) に基づいて提供されています。

•ODbLについて: http://opendatacommons.org/licenses/odbl/1.0/

•個別のコンテンツについて: データベース内の個別の内容は,Database Contents License (DBCL) に基づきライセンスされています。  http://opendatacommons.org/licenses/dbcl/1.0/

帰属表示(Attribution)】 Weather data provided by OpenWeather

----------------------------------------------------------