宿はかりが使っているデータの出どころ、更新のしかた、そして限界について書いています。
どこから取っているか
すべて楽天ウェブサービスが公開している楽天トラベル系APIから取っています。
| いま使っているAPI | 何を取るか |
|---|---|
| 施設検索API（SimpleHotelSearch） | 施設名、座標、評価、料金、設備、アクセス、施設が載せている案内文 |
使っているのはこの1種類だけです。取っている地域も、いまのところ金沢駅周辺・札幌駅周辺・軽井沢エリアの3つに限られます。
どこまで見ているか
1回の検索で受け取るのは30件までです。検索そのものはもっと多くの件数を返します。たとえば2026-09-18の金沢は110件、2026-09-19の軽井沢は279件、2026-09-20の札幌は102件でした。当サイトが比較しているのは、そのうちAPIが返した1ページ目の30件で、残りの施設は比較していません。記事の中の「30軒のうち」という数え方は、すべてこの30件を指しています。
楽天トラベルのページを見て手で書き写しているのではなく、APIから機械的に取っています。正確さのためでもあり、いつ・何を見たかを後から確かめられるようにするためでもあります。受け取った内容はその日ごとのファイルに保存していますが、同じ日に取り直した場合は同じファイルを上書きします。
取得しているデータ
評価
- 総合評価（
reviewAverage） - レビュー件数（
reviewCount） - 項目別評価8種：サービス／立地／部屋／設備／風呂／朝食／夕食／清潔感
事実
- 最低料金
- 最寄り駅、アクセス
- 駐車場情報
- チェックイン／チェックアウト時刻、最終チェックイン時刻
- キャンセルポリシー
- 緯度・経度
記事に使わないデータ
クチコミの本文は、分析にも記事にも使いません。APIのレスポンスには最新1件だけ含まれるため、保存している生データにも残りますが、記事の根拠には一切使っていません。全体の傾向を語れるだけの本文データではないこと、そして楽天アフィリエイトのガイドラインがクチコミ本文の転載を禁じていることが理由です。当サイトは「口コミでは〇〇と評判です」といった書き方をしません。
更新のしかた
- データは毎日1回取得しています
- 記事に書かれている数字は、その記事に明記された取得日時点のものです
- 取得に失敗した日は、前回の値で埋めることはしません。欠測として記録します
- 定点観測している施設については、月ごとの変化を記事にすることがあります
徒歩距離について
「駅から徒歩○分」は施設ごとに基準が異なります。当サイトでは、施設の緯度経度と駅の緯度経度から直線距離を計算して表示しています。
これは実際に歩く距離ではありません。地下道や踏切、坂道は反映されません。施設間を同じ基準で比べるための数字として使っています。実際の所要時間は各施設の公式情報をご確認ください。
数字を読むときの注意
- レビュー件数が少ない施設 — 件数が20件に満たない施設には「参考値」と明記しています。平均値は件数が少ないほど大きく振れます
- 項目別評価のばらつき — 総合評価が同じでも内訳は違います。総合4.2でも風呂が4.6の宿と3.5の宿があります
- 料金 — 表示しているのは確認した時点の最低料金です。最も安いプラン・日程・最少人数の金額であることが多く、実際に予約する条件では変わります
- 評価がない施設 — レビューがまだ付いていない施設は評価が空欄になります。評価が低いのではなく、データがないという意味です
画像について
掲載している施設の画像は、楽天トラベル系APIから取得したものです。楽天トラベルアフィリエイトの規定に従い、該当施設への誘導を目的とする場合にのみ使用しています。
クレジット
Supported by Rakuten Developers
誤りを見つけたら
データの取得や処理を間違えている可能性はあります。お気づきの点があればお問い合わせからお知らせください。確認のうえ訂正します。