モバイラーズオアシスのデータを利用したWEBサイトやアプリケーションを開発できるようにAPIを提供しております。

(以前提供していたv0 APIは提供を終了しました。パラメタや処理速度が改善されたv1 APIを提供しておりますので、こちらをご利用ください)

モバイラーズオアシス 電源情報API v1

概要

このAPIは、モバイラーズオアシスに寄せられた電源の使えるお店情報を取得します。

エンドポイント

http://oasis.mogya.com/api/v1/spots.json

パラメータ

n,s,w,e

北端南端東端西端の緯度経度(必須)

latitude,longitude

中心点の緯度経度。省略した場合は、n,w,s,eの中心点が使われます。
(v0のときはlat,lngを付けないとdistanceが計算されませんでしたが、v1では常にdistanceが付加されて、距離でソートされた結果が返されます)

tags タグ情報

これを使って、検索するお店の種類を絞り込みます。

• 「電源:お客様用コンセント」: お客様用コンセントが用意されているお店/ホームページなどで、電源を利用していい旨が表明されているお店
• 「電源:壁コンセント」: お客様用ではないんだけど、店員さんに聞いたら壁コンセントなどを使う許可をもらえたことのあるお店
• 「電源:USB」: マクドナルドやタリーズなど、電源コンセントじゃなくてUSBケーブルを刺すコンセント(USBポート)が用意されているお店
• 「Qi」: 非接触充電「Qi(おくだけ充電)」充電器設置店舗

カンマで区切って複数のキーワードを列挙できます。複数指定した場合、いずれかのパラメータに合致するものが出力されます

categories カテゴリ

これを使って、検索するお店の種類を絞り込みます。「マクドナルド」「喫茶店」などが使えます。
カンマで区切って複数のキーワードを列挙できます。複数指定した場合、いずれかのパラメータに合致するものが出力されます

wireless 無線LAN

これを使って、検索するお店の種類を絞り込みます。 「Tullys Wi-Fi」「ソフトバンクWi-Fi」などが使えます。 カンマで区切って複数のキーワードを列挙できます。複数指定した場合、いずれかのパラメータに合致するものが出力されます

tags, categories, wireless一つ一つはOR検索ですが、全体としてはAND検索です。例えば tags=電源:お客様用コンセント&wireless=au Wi-Fi,ソフトバンクWi-Fi と指定すると、「ソフトバンクWiFiまたはau WiFiが使えて、電源の使えるお店」リストが返ります

「ソフトバンクWiFiとau WiFi両方が使えるお店」のような検索はできません

レスポンス

status

• "OK" エラーが発生せず、正常に処理が完了した
• "ZERO_RESULTS" 正常に処理が行われたが、指定された条件では返すべきデータが存在しない
• "OVER_QUERY_LIMIT" リクエストが割り当て量を超えている(未使用)
• "REQUEST_DENIED" リクエストが拒否された(未使用)
• "TOO_MUCH_SPOTS" 検索結果が多すぎる。日本全国みたいな広すぎるパラメタを指定したときに戻ってきます。範囲を狭めて試してみてください
• "INVALID_REQUEST" 渡された引数が不足している、不適切。

message

状況に応じて、statusの他にmessageが付加されることがあります。 これはAPIを呼び出したプログラマ向けの簡単なメッセージで、エラーの原因となったパラメタ名などが記載されていることがあります。 注意）messageはデバッグ時に原因を突き止める目的で人間が読むことを想定して提供されているもので、messageを用いて処理を分岐させるべきではありません。messageの内容は連絡なしに変更されることがあります。

results

スポット情報の配列です。

スポット情報

• id：モバイラーズオアシス内でユニークなIDです。
• title：店名
• address：住所
• tel：電話番号
• latitude：緯度
• longitude：経度
• url：店舗公式サイトのURL
• wireless：無線LAN(配列)
• categories：カテゴリ(配列)
  • name: カテゴリ名
  • image: イメージアイコンのURL
  • importance: カテゴリの重要度。1が最低で、大きいほど重要度の高い(具体的な)カテゴリです
  • parent_id: カテゴリに親子関係がある場合の親カテゴリID
• tags：電源、Qi、禁煙喫煙などの情報(配列)
• other：その他店舗に関する情報(HTML)
• mo_url：モバイラーズオアシスでの情報ページURL
• distance；latitude,longitudeで指定した緯度経度からのおおよその距離。km単位です。なお、スポット情報はこの距離が近い順でソートされています。

スポット情報を表示する場合、mo_urlのURL宛にリンクを貼ってください(必須) 上記URLには、APIでは取得できないユーザーからのコメントや電源位置に関する詳細情報などが掲載されています。 ユーザーさんはこのページを見ることで、具体的な電源の位置やお店の情報を取得できるようになります。

例

大阪梅田駅周辺で、公式に電源を使えるスポット一覧を取得

https://oasis.mogya.com/api/v1/spots.json?n=34.70849&w=135.48775&s=34.69727&e=135.50951

{
  "results: [
    {
      "id: 71461,
      "title: "ちょうつがひ",
      "address: "大阪府大阪市北区角田町8-47 阪急グランドビル32番街28F",
      "tel: "",
      "latitude: 34.70302,
      "longitude: 135.49901,
      "url: "http://www.opefac.com/choutsugai/",
      "wireless: [],
      "categories: [
        {
          "name: "飲食店(その他)",
          "image: "//oasis.mogya.com/images/design/spot_icon_19_[type]_[size]px.png",
          "image_id: 19,
          "sprite_pos: null,
          "importance: 9,
          "parent_id: 252
        },
        ；
      ],
      "tags: [
        "用途:充電",
        "Qi",
        ：
      ],
      "other: "<dl><dt>TEL</dt><dd>06-6131-2242</dd><dt>営業時間</dt><dd>11:00-23:30ランチ11:00-15:00ディナー17:00-23:30</dd><dt>定休日</dt><dd>無休</dd><dt>禁煙・喫煙</dt><dd>分煙</dd></dl>",
      "distance: 0.03810727404068,
      "mo_url: "https://oasis.mogya.com/spot/opefac_choutsugai",
    },
    (略)
  ],
  "status: "OK"
}

v0からの主な変更点

• API名の変更
• パラメータtag: 複数列挙可能なtagsになりました
• パラメータtag: 電源の扱いに関わるタグ名が変更になりました
• lat,lngを指定しなくても、常に結果が中心点からの距離でソートされるようになりました
• 戻ってくるスポット情報の変更
  • タグ、無線LANは配列で出力されるようになりました。これにともなって、キーワードもtags,categoreisに変更されています
  • カテゴリはオブジェクトの配列で出力されるようになりました。
• entry_idはidに変更されました

---

APIの利用について

---