PHPで空き室のあるホテルを検索する

(1/1)
PHPで最寄りのネットができるホテルを検索する」ではネットができるホテルを検索したが、今回は、「楽天トラベル空室検索API」を利用し、入力された住所または地図の中心の近く(半径2km以内)にあり、指定チェックイン日・チェックアウト日に空いているホテルを地図上にマッピングするプログラムを作ってみる。

(2023年8月5日)国土地理院ジオコーディングAPIを利用できるようにした.検索キーの最小・最大長が指定できるようにした.

目次

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

PHPで空き室のあるホテルを検索する
Googleマップ表示

サンプル・プログラム

圧縮ファイルの内容
searchOutlet.phpサンプル・プログラム本体
pahooGeoCode.php住所・緯度・経度に関わるクラス pahooGeoCode。
使い方は「PHPで住所・ランドマークから最寄り駅を求める」「PHPで住所・ランドマークから緯度・経度を求める」などを参照。include_path が通ったディレクトリに配置すること。
pahooRakuten.php楽天ウェブサービスに関わるクラス pahooRakuten。
使い方は「PHPで最寄りのネットができるホテルを検索する」などを参照。include_path が通ったディレクトリに配置すること。
pahooInputData.phpデータ入力に関わる関数群。
使い方は「数値入力とバリデーション」「文字入力とバリデーション」などを参照。include_path が通ったディレクトリに配置すること。
searchLibrary.php 更新履歴
バージョン 更新日 内容
2.5.0 2023/07/16 検索キーの最小・最大長の指定
2.4.0 2023/07/16 国土地理院ジオコーディングAPIを追加
2.3 2021/10/17 PHP8対応,リファラ・チェック改良
2.2 2020/04/04 OSM Nominatim Search API追加
2.11 2019/09/01 逆ジオコーディングサービスの選択肢を増やした
pahooGeoCode.php 更新履歴
バージョン 更新日 内容
6.3.1 2023/07/09 bug-fix
6.3.0 2023/07/02 getPointsGSI()追加
6.2.0 2023/07/02 ip2address()追加
6.1.0 2022/12/30 ip2address()追加
6.0.4 2022/12/13 PHP8.2対応
pahooRakuten.php 更新履歴
バージョン 更新日 内容
3.6.2 2023/07/09 bug-fix
3.6.1 2022/12/13 PHP8.2対応
3.6 2022/02/05 楽天商品検索API (version:2017-07-06)に変更
3.5 2021/10/24 PHP8対応
3.4 2020/05/24 楽天書籍API (version:2017-04-04)に変更
pahooInputData.php 更新履歴
バージョン 更新日 内容
1.3.0 2023/07/11 roundFloat() 追加
1.2.0 2023/04/22 exitIfLessVersion() 追加
1.1.2 2023/02/05 validString() 修正
1.11 2022/07/03 isCommandLine() 修正
1.1 2022/06/04 getValidString() 修正

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

PHPで空き室のあるホテルを検索する
プログラムの流れは「PHPで最寄りのネットができるホテルを検索する」の時とほぼ同じである。

準備:pahooGeoCode クラス

  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の登録方法」を、それぞれ参照されたい。

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

  51: //地図描画サービスの選択
  52: //    0:Google
  53: //    2:地理院地図・OSM
  54: define('MAPSERVICE', 2);
  55: 
  56: //住所検索サービスの選択
  57: //    0:Google
  58: //    1:Yahoo!JAPAN
  59: //   11:HeartRails Geo API
  60: //   12:OSM Nominatim Search API
  61: //   13:国土地理院ジオコーディングAPI
  62: define('GEOSERVICE', 11);
  63: 
  64: //逆ジオコーディングサービスの選択
  65: //    0:Google
  66: //    1:Yahoo!JAPAN
  67: //   11:HeartRails Geo API
  68: //   21:簡易ジオコーディングサービス
  69: define('REVGEOSERVICE', 1);

表示する地図は、Googleマップ地理院地図・オープンストリートマップ(OSM)から選べる。あらかじめ、定数 MAPSERVIC に値を設定すること。
住所検索サービスは、GoogleYahoo!JAPANHeartRails Geo APIOSM Nominatim Search API国土地理院ジオコーディングAPI から選べる。あらかじめ、定数 GEOSERVICE に値を設定すること。
逆ジオコーディングサービスは、GoogleYahoo!JAPANHeartRails Geo API簡易ジオコーディングサービスから選べる。あらかじめ、定数 REVGEOSERVICE に値を設定すること。
PHPで空き室のあるホテルを検索する
地理院地図(淡色)
PHPで空き室のあるホテルを検索する
OpenStreetMap

準備:pahooRakuten クラス

  16: // 楽天ウェブサービス・クラス ===============================================
  17: class pahooRakuten {
  18:     var $error;         //エラー・フラグ
  19:     var $errmsg;        //エラー・メッセージ
  20:     var $hits;          //検索ヒット件数
  21:     var $webapi;        //直前に呼び出したWebAPI URL
  22: 
  23:     //楽天ウェブサービス
  24:     //https://www.pahoo.org/e-soul/webtech/php06/php06-01-02.shtm#Rakuten 参照
  25:     var $APPLICATIONID      = '*******************';    //アプリID
  26:     var $APPLICATION_SECRET = '****************';       //シークレット
  27:     var $AFFILIATEID        = '*******************';    //アフィリエイトID

楽天トラベルのホテル検索、楽天市場の商品検索など、楽天ウェブサービスを利用するために、クラスファイル "pahooRakuten.php" を使用する。組み込み関数  require_once  を使って読めるディレクトリに配置する。ディレクトリは、設定ファイル php.ini に記述されているオプション設定 include_path に設定しておく。
クラスについては「PHPでクラスを使ってテキストの読みやすさを調べる」を参照されたい。

楽天ウェブサービスには、アプリIDアフィリエイトID が必要で、その入手方法は「楽天ウェブサービス - WebAPIの登録方法」を参照されたい。

「楽天トラベル施設検索API」による施設情報検索

「https://webservice.rakuten.co.jp/documentation/vacant-hotel-search:title=楽天トラベル空室検索API]」は、入力パラメータ(IN)は GET 渡しで、出力結果(OUT)は XML で戻るという形である。今回使う入力パラメータと出力結果のデータ構造を以下に示す。
WebAPIのURL
URL
https://app.rakuten.co.jp/services/api/Travel/VacantHotelSearch/20170426

入力パラメータ
フィールド名 要否 内  容
appid 必須 楽天ウェブサービスのアプリケーションID。
affiliateId 任意 楽天ウェブサービスのアフィリエイトID。
format 任意 レスポンス形式:'xml'または'json'
【デフォルト】json
callback 任意 JSONPとして出力する際のコールバック関数名 (UTF-8でURLエンコードした文字列)
英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上
elements 任意 出力パラメーター指定:カンマ区切りで、必要な出力パラメータを指定した場合、指定された出力パラメータのみを返却する。
【デフォルト】ALL
latitude 必須 緯度:日本測地系、単位は秒、ミリ秒は小数点以下2桁以内で指定すること。
例)128216.17
ただし、datumTypeに1を指定した場合は、世界測地系、単位は度で指定すること。
例)35.6065914
longitude 必須 経度。日本測地系、単位は秒、ミリ秒は小数点以下2桁以内で指定すること。
例)503259.29
ただし、datumTypeに1を指定した場合は、世界測地系、単位は度で指定すること。
例)139.7513225
searchRadius 任意 検索半径:緯度経度検索時の検索半径(単位km)
0.1以上、3.0以下
小数点以下は1桁までであること
datumType 任意 緯度経度タイプ:入力及び出力パラメータの緯度経度タイプを指定する。
1:世界測地系、単位は度。
2:日本測地系、単位は秒。
【デフォルト】2
応答データ(xml) root pagingInfo recordCount 検索結果総数 pageCount 総ページ数 page ページ番号 first ページ内結果開始番号 last ページ内結果終了番号 hotels hotel hotelBasicInfo hotelNo 施設番号 hotelName 施設名称 hotelInformationUrl 施設情報ページURL planListUrl 宿泊プラン一覧ページURL dpPlanListUrl ダイナミックパッケージ宿泊プラン一覧ページURL reviewUrl お客様の声ページURL hotelKanaName 施設かな名称 hotelSpecial 施設特色 hotelMinCharge 最安料金 latitude 緯度 longitude 経度 postalCode 郵便番号 address1 住所1 address2 住所2 telephoneNo 施設電話番号 faxNo ファックス番号 access 施設へのアクセス parkingInformation 駐車場情報 nearestStation 最寄駅名称 hotelImageUrl 施設画像URL hotelThumbnailUrl 施設画像サムネイルURL roomImageUrl 部屋画像URL roomThumbnailUrl 部屋画像サムネイルURL hotelMapImageUrl 施設提供地図画像URL reviewCount 投稿件数 reviewAverage ★の数(総合) userReview お客さまの声(1件目)

解説:クラウドサービス呼び出し

  76: /**
  77:  * WebAPIを呼び出して応答データを取得する(https用)
  78:  * @param   string $url リスクエストURL
  79:  * @return  string 応答データ/FALSE=失敗
  80: */
  81: function callWebAPI($url) {
  82:     $ch = curl_init($url);
  83:     curl_setopt($ch, CURLOPT_HEADER, FALSE);
  84:     curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
  85:     curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); //サーバ証明書検証をスキップ
  86:     curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); //  〃
  87:     $result = curl_exec($ch);
  88:     curl_close($ch);
  89: 
  90:     return $result;
  91: }

WebAPIはhttpsプロトコルであるため、ユーザー関数 callWebAPI のように cURL 関数を用いて呼び出している。このあたりについては「PHPセキュリティ対策:SSL通信を行う」で解説している。

解説:日付選択

チェックイン日・チェックアウト日を指定するのに、jQuery UIの Datepicker を利用した。カレンダーから年月日を選択できる。

 104: $HtmlHeader =<<< EOT
 105: <!DOCTYPE html>
 106: <html lang="ja">
 107: <head>
 108: <meta charset="{$encode}">
 109: <title>{$title}</title>
 110: <meta name="author" content="studio pahoo" />
 111: <meta name="copyright" content="studio pahoo" />
 112: <meta name="ROBOTS" content="NOINDEX,NOFOLLOW" />
 113: <meta http-equiv="pragma" content="no-cache">
 114: <meta http-equiv="cache-control" content="no-cache">
 115: <meta http-equiv="X-UA-Compatible" content="IE=edge">
 116: <link type="text/css" href="http://ajax.googleapis.com/ajax/libs/jqueryui/1/themes/ui-lightness/jquery-ui.css" rel="stylesheet" />
 117: <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js"></script>

 275: <td>チェックイン日</td><td><input type="text" name="checkin" id="checkin" size="12" value="{$spot['checkin']}" /></td>
 276: <td>チェックアウト日</td><td><input type="text" name="checkout" id="checkout" size="12" value="{$spot['checkout']}" /></td>

解説:ホテル検索

  95: var $RakutenBooksItems = array(
  96:     'title',            //書籍タイトル
  97:     'titleKana',        //書籍タイトル カナ
  98:     'subTitle',         //書籍サブタイトル
  99:     'subTitleKana',     //書籍サブタイトル カナ
 100:     'seriesName',       //叢書名
 101:     'seriesNameKana',   //叢書名カナ
 102:     'contents',         //多巻物収録内容
 103:     'contentsKana',     //多巻物収録内容カナ
 104:     'author',           //著者名
 105:     'authorKana',       //著者名カナ
 106:     'publisherName',    //出版社名
 107:     'size',             //書籍のサイズ
 108:     'isbn',             //ISBNコード(書籍コード)
 109:     'itemCaption',      //商品説明文
 110:     'salesDate',        //発売日
 111:     'itemPrice',        //税込み販売価格
 112:     'listPrice',        //定価
 113:     'discountRate',     //割引率
 114:     'discountPrice',    //割引価格
 115:     'itemUrl',          //商品URL
 116:     'affiliateUrl',     //アフィリエイトURL
 117:     'smallImageUrl',    //商品画像 64x64URL
 118:     'mediumImageUrl',   //商品画像 128x128URL
 119:     'largeImageUrl',    //商品画像 200x200URL
 120:     'chirayomiUrl',     //チラよみURL
 121:     'availability',     //在庫状況
 122:     'postageFlag',      //送料フラグ
 123:     'limitedFlag',      //限定フラグ
 124:     'reviewCount',      //レビュー件数
 125:     'reviewAverage',    //レビュー平均
 126:     'booksGenreId'      //楽天ブックスジャンルID
 127: );

 445: /**
 446:  * 楽天トラベル空室検索API のURLを取得する
 447:  * @param   double $latitude  緯度(世界測地系)
 448:  * @param   double $longitude 経度(世界測地系)
 449:  * @param   int    $searchRadius 検索半径,単位km
 450:  * @param   string $checkin  チェックイン年月日(YYYY-MM-DD)
 451:  * @param   string $checkout チェックアウト年月日(YYYY-MM-DD)
 452:  * @return  string URL 楽天トラベル空室検索API のURL
 453: */
 454: function searchVacantHotelsURL($latitude, $longitude, $searchRadius, $checkin, $checkout) {
 455:     $appid = $this->APPLICATIONID;
 456:     $affid = $this->AFFILIATEID;
 457:     $res = "https://app.rakuten.co.jp/services/api/Travel/VacantHotelSearch/20170426?applicationId={$appid}&affiliateId={$affid}&format=xml&latitude={$latitude}&longitude={$longitude}&searchRadius={$searchRadius}&checkinDate={$checkin}&checkoutDate={$checkout}&datumType=1&responseType=large&searchPattern=0";
 458: 
 459:     return $res;
 460: }

 462: /**
 463:  * 楽天トラベル系API を利用してホテルを検索する
 464:  * @param   array  $items 情報を格納する配列
 465:  * @param   double $latitude  緯度(世界測地系)
 466:  * @param   double $longitude 経度(世界測地系)
 467:  * @param   int    $searchRadius 検索半径,単位km
 468:  * @param   array  $squeezeConditions 絞込み条件の配列:省略可能
 469:  * @param   string $checkin  チェックイン年月日(YYYY-MM-DD):省略可能
 470:  * @param   string $checkout チェックアウト年月日(YYYY-MM-DD):省略可能
 471:  * @return  ヒットした件数/FALSE:検索に失敗
 472: */
 473: function searchHotels(&$items, $latitude, $longitude, $searchRadius, $squeezeConditions=array(''), $checkin='', $checkout='') {
 474:     //楽天トラベル空室検索API
 475:     if (preg_match('/\d{4}\-\d{2}\-\d{2}/i', $checkin> 0) {
 476:         $url = $this->searchVacanthotelsURL($latitude, $longitude, $searchRadius, $checkin, $checkout);
 477:     //楽天トラベル施設検索API
 478:     } else {
 479:         $url = $this->searchHotelsURL($latitude, $longitude, $searchRadius, $squeezeConditions);
 480:     }
 481: 
 482:     //APIコール
 483:     if (($res = $this->callWebAPI($url)) == FALSE) {
 484:         $this->error  = TRUE;
 485:         $this->errmsg = 'WebAPI呼び出しに失敗';
 486:         return FALSE;
 487:     }
 488:     $this->webapi = $url;
 489: 
 490: //PHP4用; DOM XML利用
 491:     if ($this->isphp5over() == FALSE) {
 492:         if (($dom = domxml_open_mem($res)) == NULL) {
 493:             $this->error  = TRUE;
 494:             $this->errmsg = '楽天トラベルAPIの不具合';
 495:             $this->hits = 0;
 496:             return FALSE;
 497:         }
 498:         $pagingInfo = $dom->get_elements_by_tagname('pagingInfo');
 499:         //レスポンス・チェック
 500:         if (! is_object($pagingInfo )) {
 501:             $this->error  = TRUE;
 502:             $this->errmsg = 'ホテルが見当たらない';
 503:             $this->hits = 0;
 504:             return FALSE;
 505:         }
 506:         $rc = $pagingInfo[0]->get_elements_by_tagname('recordCount');
 507:         if (! is_object($rc)) {
 508:             $this->error  = TRUE;
 509:             $this->errmsg = 'ホテルが見当たらない';
 510:             $this->hits = 0;
 511:             return FALSE;
 512:         }
 513:         $rc = (int)$rc[0]->get_content();
 514:         if ($rc <0) {
 515:             $this->error  = TRUE;
 516:             $this->errmsg = 'ホテルが見当たらない';
 517:             $this->hits = 0;
 518:             return FALSE;
 519:         }
 520:         //検索結果取りだし
 521:         $hotels = $dom->get_elements_by_tagname('hotels');
 522:         $hotel  = $hotels[0]->get_elements_by_tagname('hotel');
 523:         $cnt = 1;
 524:         foreach ($hotel as $val) {
 525:             foreach ($this->RakutenHotelItems as $name) {
 526:                 $node = $val->get_elements_by_tagname('hotelBasicInfo');
 527:                 $node = $node[0]->get_elements_by_tagname($name);
 528:                 if ($node !NULL) {
 529:                     $items[$cnt][$name] = (string)$node[0]->get_content();
 530:                 }
 531:             }
 532:             $items[$cnt]['id']          = $this->num2alpha($cnt);
 533:             $items[$cnt]['title']       = $items[$cnt]['hotelName'];
 534:             $items[$cnt]['description'] =<<< EOT
 535: <a href="{$items[$cnt]['hotelInformationUrl']}" target="_blank">{$items[$cnt]['hotelName']}</a>&nbsp;({$items[$cnt]['address1']}{$items[$cnt]['address2']})
 536: EOT;
 537:             $cnt++;
 538:         }
 539: 
 540: //PHP5用; SimpleXML利用
 541:     } else {
 542:         $xml = simplexml_load_string($res);
 543:         if ($xml == '' || $xml == FALSE) {
 544:             $this->error  = TRUE;
 545:             $this->errmsg = '楽天トラベルAPIの不具合';
 546:             $this->hits = 0;
 547:             return FALSE;
 548:         }
 549:         //レスポンス・チェック
 550:         if ($xml->pagingInfo->recordCount <0) {
 551:             $this->error  = TRUE;
 552:             $this->errmsg = 'ホテルが見当たらない';
 553:             $this->hits = 0;
 554:             return FALSE;
 555:         }
 556:         //検索結果取りだし
 557:         $cnt = 1;
 558:         $hotel = $xml->hotels->hotel;
 559:         foreach ($hotel as $element) {
 560:             foreach ($this->RakutenHotelItems as $name) {
 561:                 if (isset($element->hotelBasicInfo->$name)) {
 562:                     $items[$cnt][$name] = (string)$element->hotelBasicInfo->$name;
 563:                 } else if (isset($element->hotelDetailInfo->$name)) {
 564:                     $items[$cnt][$name] = (string)$element->hotelDetailInfo->$name;
 565:                 }
 566:             }
 567:             //部屋設備情報取り出し
 568:             if (isset($element->hotelFacilitiesInfo->roomFacilities->item)) {
 569:                 $node = $element->hotelFacilitiesInfo->roomFacilities->item;
 570:                 $i = 0;
 571:                 while (isset($node[$i])) {
 572:                     $items[$cnt]['roomFacilities'][$i] = (string)$node[$i];
 573:                     $i++;
 574:                 }
 575:             }
 576:             //Googleマップ描画用
 577:             $items[$cnt]['id']          = $this->num2alpha($cnt);
 578:             $items[$cnt]['title']       = $items[$cnt]['hotelName'];
 579:             $items[$cnt]['description'] =<<< EOT
 580: <a href="{$items[$cnt]['hotelInformationUrl']}" target="_blank">{$items[$cnt]['hotelName']}</a>&nbsp;({$items[$cnt]['address1']}{$items[$cnt]['address2']})
 581: EOT;
 582:             $cnt++;
 583:         }
 584:     }
 585:     $this->hits = $cnt - 1;
 586: 
 587:     return $this->hits;
 588: }

応答データの要素が多いので、取得したい要素を $RakutenHotelItems にあらかじめ定義しておき、ユーザー関数 searchHotels の中で付き合わせながら配列$items に格納していく。

ユーザー関数 searchHotels の引数 $checkin$checkout は省略可能で、省略した場合は、今回使用している「楽天トラベル空室検索API」を呼び出す。省略しなければ、「楽天トラベル施設検索API」を呼び出す。

参考サイト

(この項おわり)
header