Phot.on API マニュアル
Phot.on API の使用方法について解説致します。
1. Phot.on API について
Phot.on APIを使うと、Phot.on に投稿されたスナップを、外部のサードパーティアプリケーションから検索/表示することができます。
Phot.on API を活用する事で、
・Phot.on API とあなたのアイデアを組み合せ、あらたなサービスを生み出す
・既存のあなたのサービスに Photon API を加えサービスに新機能を追加する
といった事を実現する事ができます。
Phot.on API は現在のところ個人・法人に関らず、また商用・非商用を問わず使用する事が可能です。 不明な点があればご気軽にお問いあわせください。
※APIは開発中のベータ版のため、予告なく仕様変更することがあります。
2. Phot.on API を使用するには (API キーの取得)
Phot.on API を使用するには API キーを取得する必要があります。API キーを取得するには以下の内容を記述したメールを運営事務局宛 (support@photon.st) に送信してください。確認が取れ次第、運営事務局より API キーを発行しお知らせいたします。
--------
宛先 : support@photon.st
件名 : 申請】Phot.on API キーの申請
お名前 :
メールアドレス :
API 使用サイト URL :
API 使用サイト 概要 :
API の利用方法について :
--------
Phot.on API 仕様
Description (スナップ検索)
http://photon.st/api/snaps/get.php
Parameters
page: ページャーのページ番号
nums : 一ページ辺りの要求枚数
lblng : 要求する範囲の左下の経度
lblat : 要求する範囲の左下緯度
rtlng : 要求する範囲の右上の経度
rtlat : 右上の緯度
tag : 検索ワード
color : 色 （#色コード）
sort : ソート (新着順 : new 人気順 : popular)
category : 属性 (店員 : staff, 関係者 : friends, 一般 : fun)
addr : 住所 (※緯度経度と住所を共に設定している場合、住所を優先)
addr_dist : 取得するスナップの範囲 (住所の中心点からの距離 メートル デフォルト1000m)
要求例
http://photon.st/api/snaps/get.php?addr=東京都渋谷区&page=1&nums=2&tag=帽子&color=#ffffff&addr_dist=500&key=******
応答例
応答は XML の形式で返却されます
<?xml version="1.0" encoding="UTF-8"?>
<searchsnap>
<is_success>1</is_success>
<all>
<nums>8</nums>
<page>4</page>
</all>
<page>1</page>
<nums>2</nums>
<snaps>
<id>245</id>
<name>プリヤン</name>
<modelcomment />
<shotplace>原宿</shotplace>
<sex>1</sex>
<lat>35.6662223410348</lat>
<lng>139.706783294678</lng>
<dispdate>2006-12-08 17:50:50</dispdate>
<imgname>245.jpg</imgname>
<is_popular>0</is_popular>
<is_new>0</is_new>
<img_url_l>http://photon.st/image/snaps/upL/245.jpg</img_url_l>
<img_url_m>http://photon.st/image/snaps/upM/245.jpg</img_url_m>
<img_url_s>http://photon.st/image/snaps/upS/245.jpg</img_url_s>
<img_url_t>http://photon.st/image/snaps/upThumb/245.jpg</img_url_t>
<detail_url>http://photon.st/?module=Snap&action=Detail&sid=245</detail_url>
</snaps>
<snaps>
<id>244</id>
<name>サジー６９</name>
<modelcomment />
<shotplace>原宿</shotplace>
<sex>1</sex>
<lat>35.6662223410348</lat>
<lng>139.70721244812</lng>
<dispdate>2006-12-08 17:40:01</dispdate>
<imgname>244.jpg</imgname>
<is_popular>0</is_popular>
<is_new>0</is_new>
<img_url_l>http://photon.st/image/snaps/upL/244.jpg</img_url_l>
<img_url_m>http://photon.st/image/snaps/upM/244.jpg</img_url_m>
<img_url_s>http://photon.st/image/snaps/upS/244.jpg</img_url_s>
<img_url_t>http://photon.st/image/snaps/upThumb/244.jpg</img_url_t>
<detail_url>http://photon.st/?module=Snap&action=Detail&sid=244</detail_url>
</snaps>
</searchsnap>
 |
|---|
