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

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

http://oasis.mogya.com/api/v0/search

• n,s,w,e 北端南端東端西端の緯度経度(必須)
• lat,lng 中心点の緯度経度。
  lat,lngを渡すと、戻り値のspotにdistanse がついてくる他、結果がdistanseの小さい順でソートされる
• tag タグ情報
  これを使って、検索するお店の種類を絞り込みます。
  「電源OK」: お客様用コンセントが用意されているお店/ホームページなどで、電源を利用していい旨が表明されているお店
  「電源:実績あり」: 壁コンセントなどで、店員さんに聞いたらOKをもらえたことのあるお店
  「Qi」: 非接触充電「Qi(おくだけ充電)」充電器設置店舗
  何も指定していない場合には、「電源OK」が使用されます。
  

status

• "OK" エラーが発生せず、正常に処理が完了した
• "ZERO_RESULTS" 正常に処理が行われたが、指定された条件では返すべきデータが存在しない
• "OVER_QUERY_LIMIT" リクエストが割り当て量を超えている(未使用)
• "REQUEST_DENIED" リクエストが拒否された(未使用)
• "INVALID_REQUEST" 渡された引数が不足している、不適切。

message

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

results

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

• entry_id：モバイラーズオアシス内でユニークなIDです。
• url_title：モバイラーズオアシス内でスポット情報を表示するための文字列です(後述)
• title：店名
• address：住所
• tel：電話番号
• wireless：無線LAN
• category：カテゴリ
• latitude：緯度
• longitude：経度
• url_pc：店舗公式サイトのURL
• tag：電源、Qi、禁煙喫煙などの情報
• other：その他店舗に関する情報(HTML)
• mo_url：モバイラーズオアシスでの情報ページURL
• tag：電源、Qi、禁煙喫煙などの情報
• distance；(lat,lngを渡した場合のみ)指定した緯度経度からのおおよその距離。km単位です。

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

大阪梅田駅周辺で、公式に電源を使えるスポット一覧を取得
http://oasis.mogya.com/api/v0/search?n=34.70849&w=135.48775&s=34.69727&e=135.50951

{
    "results": [
        {
            "entry_id": 28188,
            "url_title": "entry_2530",
            "address": "大阪府大阪市北区曽根崎2-8-12",
            (略)
            "powersupply": "公式にOK",
            "tel": "0663167586",
            "other": "<dl><dt>TEL</dt><dd>06-6316-7586</dd>\n<dt>客席数</dt><dd>97席</dd>\n<dt>駐車場</dt><dd>0台</dd>\n<dt>営業時間</dt><dd>平日:24時間<br />土曜:24時間<br />休日:24時間<br />年中無休 ■3:30-5:00までは、客席清掃のためお持ち帰りのみの営業となります。 ■毎週日曜日3:00-5:00は機器メンテナンスの為、限定商品にて販売。第2・4日曜日3:00-5:00までは、機器調整のためドリンクのみの営業となります。<br /></dd>\n</dl>\n",
            "tag": "電源OK",
            (略)
            "category": [
                "ファストフード",
                "マクドナルド"
            ]
        },
        (略)
    ],
    "status": "OK"
}

この場合、url_titleが"entry_2530"なので、http://oasis.mogya.com/spot/entry_2530 にリンクを貼ってください。

• 利用サンプル：[Titanium]電源コンパス - もぎゃろぐ
• 利用サンプル：[ruby]モバイラーズオアシスAPIの使用サンプル - もぎゃろぐ
• こういうAPIだとたまに「キャッシュもとってはいけません」みたいに厳しいAPIがありますが、モバイラーズオアシスAPIはキャシュをとったりしていただいて構いません。
• 今回はお試し公開ということで、2013-03-31までの期間限定公開を予定しています。 公開期間終了後、取得したキャッシュは破棄してください。
  お試し期間は終了いたしましたが、業務利用のサンプルという位置づけで引き続きご利用いただけます。有償利用のご契約をいただいた会社様には個別にAPIを提供させていただいておりますので、お気軽にお問い合わせくださいませ。

モバイラーズオアシス 電源マップAPI

このAPIは、モバイラーズオアシスの結果ページのURLを取得します

http://oasis.mogya.com/api/v0/map

• lat,lng 中心点の緯度経度。
• tag タグ情報
  これを使って、検索するお店の種類を絞り込みます。
  「電源OK」: お客様用コンセントが用意されているお店/ホームページなどで、電源を利用していい旨が表明されているお店
  「電源:実績あり」: 壁コンセントなどで、店員さんに聞いたらOKをもらえたことのあるお店
  「Qi」: 非接触充電「Qi(おくだけ充電)」充電器設置店舗
  何も指定していない場合には、「電源OK」が使用されます。
  

status

• "OK" エラーが発生せず、正常に処理が完了した
• "ZERO_RESULTS" 正常に処理が行われたが、指定された条件では返すべきデータが存在しない
• "OVER_QUERY_LIMIT" リクエストが割り当て量を超えている(未使用)
• "REQUEST_DENIED" リクエストが拒否された(未使用)
• "INVALID_REQUEST" 渡された引数が不足している、不適切。

url

結果ページのURL。ちなみにこのURLにスマートフォンや携帯電話でアクセスした場合でも、各機種向けの適切なページが表示されます。

大阪梅田駅周辺の電源マップURLを取得
http://oasis.mogya.com/api/v0/map?lat=34.70556&lng=135.498205

{"url":"http://oasis.mogya.com/result/50886f8a31e9d","status":"OK"}

• 利用サンプル：[ruby]電源マップをメールで送信 - もぎゃろぐ
• こちらのAPIについては、基本的にずっと無料でサービスが提供できる予定です。