インクカートリッジ里帰りプロジェクト 使用済みインクカートリッジの回収・リサイクルを推進するプリンターメーカーの共同活動

使い終わったら、僕のマークの回収箱まで連れて行ってね!

トップページに戻る

インクカートリッジ里帰りAPIリファレンス

REST形式のAPIを提供しております。


  

・東日本大震災の復興支援活動への繋がり

当活動の一環としてSATOYAMAイニシアティブ国際パートナーシップ(以下、IPSI)への寄付を行っています。
この寄付を通じて、IPSIが実施している東日本大震災復興支援活動と自然共生社会の構築に向けた活動を支援します。
(これまでの寄付実績および復興支援に関するプレスリリース
郵便局や自治体関係施設に設置してある「インクカートリッジ里帰りプロジェクト」の共同回収箱に、家庭用プリンターの
使用済みインクカートリッジを投入することで、IPSIが推進する社会貢献活動に参加することができます。
当APIを活用することでこの活動を支援・促進させることに繋げて頂ければ幸いに思います。
詳しくはこちらをご覧ください。


  

・リクエストURL形式

http://www.inksatogaeri.jp/~map/api.php?パラメタ名=パラメタ値...
与えられた位置情報の範囲(緯度経度や都道府県コード)に設置されている回収箱情報を返します


  

・リクエストパラメタ

検索パラメタ   ※必須項目以外は指定なしで構いません
パラメタ名説明
d使用するサイトのドメイン名を指定します。 ※必須 (例:d=www.domain.com)
※http://や/Path情報は必要ありません
p取得したい地点を以下いずれかの形式で指定します。※必須

Case1:

取得したい都道府県コードを指定します。

 

Case2:

緯度経度をカンマ区切りで指定すると、その地点を中心に大よそ5キロ四方にある回収箱情報を返却します。
例)p=36.12345,138.54321(世界測地系 degree形式)

 

Case3:

南西,北東(SW,NE)の順番で緯度経度をカンマ区切りで指定すると、(地図で表現した場合の)右下と左上を対角の頂点とする矩形領域の範囲にある回収箱情報を返却します。(Ex.GoogleMapsAPIのLatLngBoundsインスタンスに相当)
例)p=35.675913,139.678514,35.702404,139.723145
p=[SouthWest.lat],[SouthWest.lng],[NorthEast.lat],[NorthEast.lng])(世界測地系 degree形式)

 

Case4:

取得したい市区郡名を指定します。
例)p=%E8%AB%8F%E8%A8%AA(諏訪市)
※指定文字列は原則URLエンコードを施して利用してください。(クライアントによっては自動変換される場合もあります)なお非公式ながら文字列の部分一致での検索にも対応しています。
cコールバック関数名を任意に指定したい場合その関数名※任意項目(例:c=callbackfunc)
※jQuery.getJSON()でJSONPの指定をする場合はJQueryが指定するcallback関数名を当APIにて自動で付与しますので、ここでの指定は不要です
vバージョンを指定。※任意項目(例:v=1.02)
通常この指定を行う必要はなく常に最新バージョンをご利用ください。実装上の理由(機能追加の際の不具合が出た場合等)でVersion Stableにしたい場合のみ指定してください。
デフォルト値:最新バージョン(Ver1.02)
fフォーマットを指定。※任意項目(例:f=csv)
csv=所在地情報をCSV形式で返却(Excelで表示したい時などにご利用下さい)
kml=所在地情報をKML形式で返却(GoogleEarthやマイマップで表示したい時にご利用下さい)
デフォルト値:json(指定の必要はありません)

  

・リターンパラメタ

ヒットしたデータをJSON(P)形式で返します。なお原則としてマルチバイトデータはUTF-8形式で返します。
返答パラメタ
パラメタ名説明
scodestring局コード
(数値の場合は郵便局、アルファベット入りの場合は自治体・施設等の識別できます)
dlatnumber回収拠点の緯度(世界測地系 degree形式)
dlonnumber回収拠点の経度(世界測地系 degree形式)
divinumber回収拠点の都道府県コード
citystring回収拠点の市区郡名(データがない場合がありますのでご了承ください)
snamestring回収拠点名(郵便局や自治体・施設等)
※JSONPの場合はcontent-type: application/javascript;として返却します

  

・サンプル

Case1:東京都にある回収拠点をコールバック関数名を指定して取得する
http://www.inksatogaeri.jp/~map/api.php?d=www.mydomain.com&p=13&c=callbackfunc

Case2:東京都庁付近にある回収拠点を取得する(中心地からの指定)
http://www.inksatogaeri.jp/~map/api.php?d=www.mydomain.com&p=35.68627,139.69487

Case3:東京都庁付近にある回収拠点を取得する(範囲指定)
http://www.inksatogaeri.jp/~map/api.php?d=www.mydomain.com&p=35.675913,139.678514,35.702404,139.723145

Case4:さいたま市にある回収拠点を取得する
http://www.inksatogaeri.jp/~map/api.php?d=www.mydomain.com&p=さいたま市

※JSON以外の形式の場合:

・東京都にある回収拠点をCSV形式で取得する
http://www.inksatogaeri.jp/~map/api.php?d=www.mydomain.com&p=13&f=csv

・東京都にある回収拠点をKML形式で取得する
http://www.inksatogaeri.jp/~map/api.php?d=www.mydomain.com&p=13&f=kml


  

・都道府県コード

1北海道 11埼玉県 21岐阜県 31鳥取県 41佐賀県
2青森県 12千葉県 22静岡県 32島根県 42長崎県
3岩手県 13東京都 23愛知県 33岡山県 43熊本県
4宮城県 14神奈川県 24三重県 34広島県 44大分県
5秋田県 15新潟県 25滋賀県 35山口県 45宮崎県
6山形県 16富山県 26京都府 36徳島県 46鹿児島県
7福島県 17石川県 27大阪府 37香川県 47沖縄県
8茨城県 18福井県 28兵庫県 38愛媛県
9栃木県 19山梨県 29奈良県 39高知県

10群馬県 20長野県 30和歌山県 40福岡県 99全国

  

・オリジナルマーカー画像

必要に応じて以下のマーカー画像を利用できます。


マーカー


アイコン

その他利用できる素材集はこちらです。
※当APIを利用したサービス以外ので利用は禁じます。また画像への直リンクでの利用も行わないでください。


  

◆利用規約

・当APIは「インクカートリッジ里帰りプロジェクト」普及活動を目的とし、本目的以外でのご利用はできません。
・APIによるアクセスは1リクエスト/秒までを目安としてください。
 ※なおサービスに影響の出る過剰なアクセスは制限させて頂く場合がありますのでご了承ください
・当APIを利用したサイトやアプリを作成する場合は、必ず当ページへのリンクをお願いします。
 ※利用規約に沿わないと判断した場合にAPIへのアクセスを制限させて頂く場合がありますのでご了承ください
・当APIを利用したサイトやアプリは当プロジェクトが動作を保証しておりませんので、予めご承知置き下さい。


  

・当プロジェクトの活動内容

「インクカートリッジ里帰りプロジェクト」は、インクカートリッジの回収から再資源化までのリサイクル活動を推進する
プリンターメーカー共同のプロジェクトです。郵便局や自治体を活動の拠点として活用することで、
回収率のさらなる向上を目指し、循環型社会の形成に貢献することを目指しています。


  

・当プロジェクトの最新情報を取得する

当プロジェクトの新着情報をRSSにて配信しています。RSSリーダーやプログラムからご利用ください。


  

・Twitterによる回収実績の「見せる化」実験中

毎日の回収拠点数や回収No1の拠点を自動配信しています。ぜひフォローしてください!

  @inksatogaeri (里帰り君)


  

・展示会用お役立ちツール(里帰り君ビンゴ!)

当プロジェクト展示会等のイベントでノベルティ配布に利用している里帰り君ビンゴを
以下の使用方法および利用規約に基づき一般公開していますのでご利用ください。

■使用方法
URIに付加するパラメタですべてを制御できます。
end=2以上の整数を指定。1~指定数値までのランダムな数値を返します
ignore=カンマ区切りの整数。指定された数値を結果から除外します

例: http://www.inksatogaeri.jp/~map/contents/?p=fortune&end=30&ignore=3,17
1~30の間で3と17を除いた数値をランダムに返却
※結果の数値をクリックすると、その数値が自動的にignoreに追加されます。
(そのままビンゴを継続できます)
■利用規約
・「インクカートリッジ里帰りプロジェクト」普及活動を目的とし、本目的以外でのご利用はできません。
 ※利用者に当プロジェクトの趣旨等ご紹介頂ければご利用頂いて結構です
・サービスに影響の出る過剰なアクセスは制限させて頂く場合がありますのでご了承ください
 ※利用規約に沿わないと判断した場合にアクセスを制限させて頂く場合がありますのでご了承ください
・ご利用の際に当プロジェクトへのご連絡は必要ありません(可能であれば使っている様子などTweet等して頂けると幸いです)
・当ツールを利用した結果や動作等に関する一切の保証をしておりませんのでその旨ご承知置き下さい。