PHPで地図で指定した場所の天気予報を求める

(1/1)
「PHPで天気予報を求める」で紹介した気象庁の「気象庁防災情報XML」を利用し、地図サービスをクラウド連携することで、住所やランドマークから週間天気予報を表示するPHPプログラムを作ってみる。

（2025年3月1日）国外の天気予報が出来ないことから，GEOSERVICEにYahoo!JAPANを指定したとき，ラジオボタン[世界]を非表示にした．
（2025年2月23日）指定した場所が予報地点外の時にエラー表示するようにした．
（2025年2月2日）予報地点情報ファイルを1週間毎に再作成するようにした．
（2024年11月9日）予報地点情報ファイルを更新
（2024年4月22日）京都市，熱海市など3日間しか表示されなくなった地点があり，予報地点情報ファイルを更新した．

download プログラムを実行する

サンプル・プログラムの実行例

PHPで地図で指定した場所の天気予報を求める
Googleマップ表示

目次

  1. サンプル・プログラムの実行例
  2. サンプル・プログラムのダウンロード
  3. サンプル・プログラムの流れ
  4. 準備：pahooGeoCode クラス
  5. 準備：地図サービスの選択
  6. 準備：その他の定数
  7. 準備：地図サービスの選択
  8. 解説：最も近い予報地点
  9. 解説：表示とURLパラメータ
  10. 質疑応答
  11. 活用例
  12. 参考サイト

サンプル・プログラムのダウンロード

download ダウンロード（PHP8対応）

圧縮ファイルの内容
myWeather.phpサンプル・プログラム本体
pahooInputData.phpデータ入力に関わる関数群。
使い方は「数値入力とバリデーション」「文字入力とバリデーション」などを参照。include_path が通ったディレクトリに配置すること。
pahooGeoCode.php住所・緯度・経度に関わるクラス pahooGeoCode。
使い方は「PHPで住所・ランドマークから最寄り駅を求める」「PHPで住所・ランドマークから緯度・経度を求める」などを参照。include_path が通ったディレクトリに配置すること。
pahooWeather.php気象情報に関わるクラス pahooWeather。
気象情報に関わるクラスの使い方は「PHPで天気予報を求める」を参照。include_path が通ったディレクトリに配置すること。
pahooCache.phpキャッシュ処理に関わるクラス pahooCache。
キャッシュ処理に関わるクラスの使い方は「PHPで天気予報を求める」を参照。include_path が通ったディレクトリに配置すること。
jmaweatherspots.xml予報地点情報ファイル。「PHPで天気予報を求める」参照。
jmaWeatherInit.php予報地点情報ファイル作成プログラム。「PHPで天気予報を求める」参照。
myWeather.php 更新履歴
バージョン 更新日 内容
3.6.1 2025/03/01 国外の天気予報が出来ないことから，GEOSERVICEにYahoo!JAPANを指定したとき，ラジオボタン[世界]を非表示にした
3.6.0 2025/02/23 指定した場所が予報地点外の時にエラー表示
3.5.1 2025/02/23 予報表タイトルの誤記訂正
3.5.0 2023/08/12 検索キーの最小・最大長の指定
3.4.0 2023/08/12 国土地理院ジオコーディングAPIを追加
jmaWeatherInit.php 更新履歴
バージョン 更新日 内容
3.1.0 2023/03/18 地域気象観測所一覧のフォーマット変更に対応
3.0.0 2023/02/11 アメダスのページから自動ダウンロード対応
2.2 2022/03/12 気象庁防災情報XMLのhttps化に対応, キャッシュ・システム導入：pahooCacheクラス
2.11 2021/03/23 bug-fix，地域観測所一覧（アメダス）を最新に
2.1 2021/03/03 天気予報（2～3日予報）に対応
pahooGeoCode.php 更新履歴
バージョン 更新日 内容
6.4.0 2025/03/01 makeYOLP_GeoSelectCategory()--引数$flagWorld追加
6.3.3 2024/09/14 $this->NOMINATIM_EMAIL 追加
6.3.2 2024/02/14 getStaticMap() -- bug-fix
6.3.1 2023/07/09 bug-fix
6.3.0 2023/07/02 getPointsGSI()追加
pahooWeather.php 更新履歴
バージョン 更新日 内容
5.6.0 2025/02/23 getJmaNearSpot() -- 引数 $distanceMax 追加
5.5.0 2025/02/01 予報地点情報ファイルを1週間毎に再作成する
5.4.1 2023/08/12 __construct() -- 不具合修正
5.4 2023/02/11 FILE_VERSION = 2.2 に更新
5.3 2022/03/10 気象庁防災情報XMLのhttps化に対応
pahooCache.php 更新履歴
バージョン 更新日 内容
1.1.1 2023/02/11 コメント追記
1.1 2021/04/08 simplexml_load()メソッド追加
1.0 2021/04/02 初版
pahooInputData.php 更新履歴
バージョン 更新日 内容
1.8.0 2024/11/12 validRegexPattern() 追加
1.7.0 2024/10/09 validURL() validEmail() 追加
1.6.0 2024/10/07 isButton() -- buttonタグに対応
1.5.0 2024/01/28 exitIfExceedVersion() 追加
1.4.2 2024/01/28 exitIfLessVersion() メッセージ修正

サンプル・プログラムの流れ

PHPで地図で指定した場所の天気予報を求める
プログラムの流れは「PHPで最寄り駅を求める」の時と同じで、緯度・経度から施設情報を求める部分を、「PHPで天気予報を求める」に差し替えただけである。

準備：pahooGeoCode クラス

pahooGeoCode.php

  37: class pahooGeoCode {
  38:     var $items;     //検索結果格納用
  39:     var $error;     //エラー・フラグ
  40:     var $errmsg;    //エラー・メッセージ
  41:     var $hits;      //検索ヒット件数
  42:     var $webapi;    //直前に呼び出したWebAPI URL
  43: 
  44:     //Google Cloud Platform APIキー
  45:     //https://cloud.google.com/maps-platform/
  46:     //※Google Maps APIを利用しないのなら登録不要
  47:     var $GOOGLE_API_KEY_1 = '**************************';   //HTTPリファラ用
  48:     var $GOOGLE_API_KEY_2 = '**************************';   //IP制限用
  49: 
  50:     //Yahoo! JAPAN Webサービス アプリケーションID
  51:     //https://e.developer.yahoo.co.jp/register
  52:     //※Yahoo! JAPAN Webサービスを利用しないのなら登録不要
  53:     var $YAHOO_APPLICATION_ID = '*****************************';

地図サービスを利用するために、クラスファイル "pahooGeoCode.php" を使用する。組み込み関数  require_once  を使って読めるディレクトリに配置する。ディレクトリは、設定ファイル php.ini に記述されているオプション設定 include_path に設定しておく。
クラスについては「PHPでクラスを使ってテキストの読みやすさを調べる」を参照されたい。

地図や住所検索として Google を利用するのであれば、Google Cloud Platform APIキー が必要で、その入手方法は「Google Cloud Platform - WebAPIの登録方法」を、Yahoo!JAPAN を利用するのであれば、Yahoo! JAPAN Webサービス アプリケーションIDが必要で、その入手方法は「Yahoo!JAPAN デベロッパーネットワーク - WebAPIの登録方法」を、それぞれ参照されたい。

準備：地図サービスの選択

myWeather.php

  70: // 地図描画サービスの選択
  71: //    0：Google
  72: //    2：地理院地図・OSM
  73: define('MAPSERVICE', 2);
  74: 
  75: // 住所検索サービスの選択
  76: //    0：Google
  77: //    1：Yahoo!JAPAN
  78: //   11：HeartRails Geo API
  79: //   12：OSM Nominatim Search API
  80: //   13：国土地理院ジオコーディングAPI
  81: define('GEOSERVICE', 1);
  82: 
  83: // 逆ジオコーディングサービスの選択
  84: //    0：Google
  85: //    1：Yahoo!JAPAN
  86: //   11：HeartRails Geo API
  87: //   21：簡易ジオコーディングサービス
  88: define('REVGEOSERVICE', 1);

表示する地図は、Googleマップ、地理院地図・オープンストリートマップ（OSM）から選べる。あらかじめ、定数 MAPSERVIC に値を設定すること。
住所検索サービスは、Google、Yahoo!JAPAN、HeartRails Geo API、OSM Nominatim Search API、国土地理院ジオコーディングAPI から選べる。あらかじめ、定数 GEOSERVICE に値を設定すること。
逆ジオコーディングサービスは、Google、Yahoo!JAPAN、HeartRails Geo API、簡易ジオコーディングサービスから選べる。あらかじめ、定数 REVGEOSERVICE に値を設定すること。
PHPで地図で指定した場所の天気予報を求める
地理院地図表示
PHPで地図で指定した場所の天気予報を求める
オープンストリートマップ表示

準備：その他の定数

myWeather.php

  90: // マップの表示サイズ（単位：ピクセル）
  91: define('MAP_WIDTH',  700);
  92: define('MAP_HEIGHT', 400);
  93: // マップID
  94: define('MAPID', 'map_id');
  95: // 初期値
  96: define('DEF_LATITUDE',  35.4658);       // 緯度
  97: define('DEF_LONGITUDE', 139.6223);      // 経度
  98: define('DEF_TYPE',      'roadmap');     // マップタイプ
  99: define('DEF_ZOOM',      13);            // ズーム
 100: define('DEF_CATEGORY', 'address');      // カテゴリ
 101: 
 102: // 検索キーの最小文字長
 103: define('QUERY_MIN_LEN', 3);
 104: 
 105: // 検索キーの最大文字長
 106: define('QUERY_MAX_LEN', 99);
 107: 
 108: // 予報地点までの最大距離（km）
 109: define('DISTANCE_MAX', 400);

その他の定数は任意の値に変更することができる。
予報地点までの最大距離 DISTANCE_MAX は、この距離の範囲内に予報地点が見つからなければエラーを返す。

準備：地図サービスの選択

myWeather.php

  70: // 地図描画サービスの選択
  71: //    0：Google
  72: //    2：地理院地図・OSM
  73: define('MAPSERVICE', 2);
  74: 
  75: // 住所検索サービスの選択
  76: //    0：Google
  77: //    1：Yahoo!JAPAN
  78: //   11：HeartRails Geo API
  79: //   12：OSM Nominatim Search API
  80: //   13：国土地理院ジオコーディングAPI
  81: define('GEOSERVICE', 1);
  82: 
  83: // 逆ジオコーディングサービスの選択
  84: //    0：Google
  85: //    1：Yahoo!JAPAN
  86: //   11：HeartRails Geo API
  87: //   21：簡易ジオコーディングサービス
  88: define('REVGEOSERVICE', 1);

表示する地図は、Googleマップ、地理院地図・オープンストリートマップ（OSM）から選べる。あらかじめ、定数 MAPSERVIC に値を設定すること。
住所検索サービスは、Google、Yahoo!JAPAN、HeartRails Geo API、OSM Nominatim Search API、国土地理院ジオコーディングAPI から選べる。あらかじめ、定数 GEOSERVICE に値を設定すること。
逆ジオコーディングサービスは、Google、Yahoo!JAPAN、HeartRails Geo API、簡易ジオコーディングサービスから選べる。あらかじめ、定数 REVGEOSERVICE に値を設定すること。

解説：最も近い予報地点

pahooWeather.php

 218: /**
 219:  * 指定した緯度・経度に最も近い予報地点コードを求める．
 220:  * 参考サイト　https://www.pahoo.org/e-soul/webtech/php06/php06-52-01.shtm
 221:  * @param   object $pgc pahooGeoCodeオブジェクト
 222:  * @param   double $longitude 経度（世界測地系）
 223:  * @param   double $latitude  緯度（世界測地系）
 224:  * @param   int    $forecast  0：天気予報，1：週間天気予報（省略時：1）
 225:  * @param   float  $distanceMax 予報地点からの最大距離（km）
 226:  *                      これより近い予報地点が見つからなければNULLを返す
 227:  * @return  string 予報地点コード／NULL：合致する予報地点がない
 228: */
 229: function getJmaNearSpot($pgc, $longitude, $latitude, $forecast=1, $distanceMax=99999) {
 230:     // 電文コード
 231:     $code = ($forecast == 0) ? 'VPFD51' : 'VPFW50';
 232: 
 233:     $res = NULL;
 234:     $cnt = 0;
 235:     $d0  = 999999999;
 236:     // 電文コードが一致する予報地点を選んで2地点間の距離を計算
 237:     while (1) {
 238:         if ($this->spots[$cnt]['code'] == $code
 239:             && isset($this->spots[$cnt]['stationCode'])
 240:             && isset($this->spots[$cnt]['longitude'])
 241:             && isset($this->spots[$cnt]['latitude'])) {
 242:             $d1 = $pgc->distance($this->spots[$cnt]['longitude'], $this->spots[$cnt]['latitude'], $longitude, $latitude);
 243:             // 距離がより小さければ採用
 244:             if ($d1 < $d0) {
 245:                 $res = (string)$this->spots[$cnt]['stationCode'];
 246:                 $d0 = $d1;
 247:             }
 248:             $cnt++;
 249:         } else {
 250:             break;
 251:         }
 252:     }
 253:     return ($d0 > $distanceMax * 1000) ? NULL : $res;
 254: }

Googleマップから取得した緯度・経度を取得できるが、一方、クラス "pahooWeather" では定められた都市の天気予報しか取得できない。そこで、マップ・サービスから取得した緯度・経度に最も近い予報地点の天気予報を表示することにした。
最も近い予報地点を取得するのがメソッド getJmaNearSpot である。
あらかじめ用意した予報地点情報 $spots とマップ・サービスから取得した緯度・経度の距離を計算し、それが最短になる予報地点を採用する。
最後に、計算した距離が引数 $distanceMax よりも大きい場合にはエラー（NULL）を返すようにした。これは、緯度・軽度として国外の地点を指定した場合に備えての措置である。

なお、予報地点情報 $spots は、あらかじめXML形式ファイル "FILE_JMASPOTS" として用意しておく必要がある。
"FILE_JMASPOTS" は圧縮ファイルに同梱しているが、もし新規作成する場合は、「予報地点情報ファイル - PHPで天気予報を求める」をご覧いただきたい。

解説：表示とURLパラメータ

myWeather.php

 399: // 各種パラメータを代入する．
 400: $items  = array();
 401: $html = $errmsg = $url = $address = '';
 402: $id        = (int)getParam('id',          FALSE, 0);                // 表示モード
 403: $query    = getValidString('query', $errmsg, '', QUERY_MIN_LEN, QUERY_MAX_LEN);
 404: if ($errmsg != '') {
 405:     $errmsg = '検索キーの長さが' . $errmsg;
 406: }
 407: $latitude  = (float)getParam('latitude',  FALSE, DEF_LATITUDE);     // 緯度
 408: $longitude = (float)getParam('longitude', FALSE, DEF_LONGITUDE);    // 経度
 409: $zoom      = (int)getParam('zoom',        FALSE, DEF_ZOOM);         // ズーム
 410: $type      = (string)getParam('type',     FALSE, DEF_TYPE);         // マップタイプ
 411: $category  = (string)getParam('category',    FALSE, DEF_CATEGORY);  // カテゴリ
 412: $outenc    = (string)getParam('charset',  FALSE, INTERNAL_ENCODING);

URLパラメータを使って
myWeather.php?id=1&query=%E6%9C%AD%E5%B9%8C%E5%B8%82
のようにすることで、query をキーワードにして検索した地点の天気予報のみを表示させることができる。つまり、このスクリプトをホームページやブログの一部として組み込むことで、週間天気予報を表示するパーツになる。
query はUTF-8をURLエンコードしたもの。Yahoo!JAPAN住所検索を使う場合は、category をあわせて指定すること。
また、出力はHTML文のみとなり、スタイルシートは本体ページの方で用意していただきたい。必要なclassは次の通り。

myWeather.php

 148: <style>
 149: /* エラー表示 */
 150: p.werror {
 151:     color: red;
 152: }
 153: /* 天気予報表 */
 154: table.weather {
 155:     width: {$width}px;
 156:     border:solid 1px #000000;
 157:     border-collapse:collapse;
 158:     margin-top:10px;
 159: 
 160: }
 161: /* 天気予報表：月日表示部 */
 162: table.weather td.dt {
 163:     width: {$width}px;
 164:     border:solid 1px #000000;
 165:     border-collapse: collapse;
 166:     padding:4px;
 167:     white-space:nowrap;
 168:     text-align:center;
 169: }
 170: /* 天気予報表：予報表示部 */
 171: table.weather td.info {
 172:     width: {$width}px;
 173:     border:solid 1px #000000;
 174:     border-collapse: collapse;
 175:     padding:4px;
 176:     white-space:nowrap;
 177:     text-align:center;
 178: }
 179: /* 天気予報表：予報アイコン */
 180: img.wicon {
 181:     width: 60px;
 182: }
 183: /* 天気予報表：小さい文字 */
 184: span.wsmall {
 185:     font-size: small;
 186: }
 187: </style>

また、親となるホームページやブログの文字コードセットにあわせ、charset 変数で出力文字コードを変更できるようにした。たとえば
myWeather.php?id=1&query=%E6%9C%AD%E5%B9%8C%E5%B8%82&charset=SJIS
とすると、シフトJISで出力することができる。
緯度・経度を直接、URLパラメータに渡すこともできる。
myWeather.php?id=1&latitude=26.591&longitude=127.977
のようにすることで、北緯26.591度、東経127.977度の天気予報のみを表示させることができる。

質疑応答

【質問】　ぱーまーさま
お世話になっております。
PHPで地図で指定した場所の天気予報を求めるを活用させていただいております。

こちら、世界の天気予報が以前は国単位で取得可能でした。
現在、すべての場所で同じ天気が表示されます。
地図は問題なく表示されます。

例えば「韓国」「台湾」「イタリア」「カンボジア」「ベトナム」「シンガポール」で検索すると同一の天気になります。
予報地点情報ファイルを更新しましたが解消されません。

ご確認よろしくお願いいたします。
【回答】
国外の天気予報を表示していたのは、プログラムの誤りでした。実際には当該国の天気予報は取得できておらず、国内の予報地点の情報を表示しているだけでした。
そこで、予報可能な地点から遠い場所を指定したときには、正しくエラーを表示するようにしました。


【質問】　ぱーまーさま
お世話になっております。
ご回答ありがとうございました。
こちらのサンプルプログラムで
カテゴリ[住所][ランドマーク][世界]というラジオボタンがあったので世界の天気が取得できると思ってしました。[世界]のラジオボタンは削除されるか、「地図のみの表示」ですという記載などされたほうが良いかもしれません。

下記のOpenWeatherMap APIというものを利用すれば世界の都市の週間天気予報を表示できるようです。
https://qiita.com/sdkk-rails/items/3589afefda4169976965

もし、今後お手すきでご意欲があればの話ですが、「地図で指定した場所の天気予報」の世界版を作成していただければ大変うれしく思います。

勝手な意見で申し訳ありません。
こちらの国内版は今後も利用させていただきます。
どうぞよろしくお願いいたします。
【回答】
アドバイスをありがとうございます。
本編を通読していただくと分かる通り、ラジオボタン[世界]は住所検索に Yahoo!JAPAN を使ったときに限って表示します。とはいえ、本プログラムは国外の天気予報を表示できないので、このラジオボタンの意味がありませんので表示しないようにしました。

教えていただいた OpenWeatherMap API は、国内の天気予報について、本プログラムが参照している気象庁防災情報XML とは異なる予報を表示することから、すぐに本プログラムへ導入することは控えたいと思います。別プログラムにするかどうか、今後検討いたします。

活用例

「地図・地名で指定した場所の週間天気予報」（みんなの知識 ちょっと便利帳）では、このサンプル・プログラムを活用し、検索しやすく、また週間天気予報を見やすく表示している。ありがとうございます。

参考サイト

（この項おわり）
前へ 目次 次へ
関連ページ bluesky
Valid HTML5 正当なCSSです!
2015年12月13日 作成／2025年03月01日 更新
Copyright by studio pahoo, (C)2015-2025
（※）本ページはリンクフリーですが、複製・転載時にはご一報ください。
★本ページへのご意見・ご質問・お便りは、こちらへお願いします。
header
ホーム  > Web技術  > PHPでクラウド連携