【foursquare API】2014年6月1日よりv=20120609以前のバージョンが使用できなくなります #4sqdevjp
And here we go: we're officially deprecating API versions 20120609 and lower. Get your upgrade on! https://t.co/Cv6jHTtST4
— Foursquare API (@FoursquareAPI) 2014年2月21日
今朝、foursquareアカウントから公式アナウンスがありました。
要約すると、2014年6月1日より v=20120609
以前のバージョンが使用できなくなるようです。
現時点でも 20120609 より前の日付(例えば20120608)を指定すると次のような警告が出ます。
{ "meta": { "code": 200, "errorDetail": "This API version will be deprecated soon. Please switch to using an API version v >= 20120609. For more information, see http://bit.ly/IdewPO and http://bit.ly/vywCav", "errorType": "deprecated" },
何をすればいいの?
2014年6月1日0時までに、v= の値を 20120610
もしくはそれ以降の日付にセットし、なおかつサービスが正常に動作することを確認する必要があります。
対応しないとどうなるの?
2014年6月1日に、次のような仕様変更が実施されます。
1. カテゴリアイコンのデザインが強制的に変更される
これまでのデザイン
が次の新デザインに変更になります。
一見すると真っ白に見えますが、これはアイコンが透過色で描かれているためです。
よって、開発者はアイコンの背景に白以外の背景画像を重ねるなどして、アイコンが正常に表示されるようにする必要があります。拙作アプリ FastCheckin では、灰色の背景にアイコンを重ねるようにしています。
参考:【foursquare】新カテゴリアイコンについて調べてみた - koogawa blog
2. ベニュー検索結果のJSON構造等が変わる場合がある
いつのタイミングかは忘れましたが、ベニュー検索結果のJSON構造が微妙に変わっています。このため、新しいJSON構造に対応しないサービスは、2014年6月1日以降は正常に動作しなくなる可能性があります。(スマートフォンアプリの場合は最悪クラッシュする可能性もあります)
brownoutテスト
2014年5月15日に1日だけbrownoutテストが実施されます。この期間中に 20120609 以前のバージョンを指定するとすべて拒否されます。心配な方は、この機会にサービスが正常に動くことを確認すると良いでしょう。