読者です 読者をやめる 読者になる 読者になる

koogawa log

iOS、Android、foursquareに関する話題

【foursquare API】2014年6月1日よりv=20120609以前のバージョンが使用できなくなります #4sqdevjp

今朝、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. カテゴリアイコンのデザインが強制的に変更される

これまでのデザイン

f:id:koogawa:20140223020300p:plain

が次の新デザインに変更になります。

f:id:koogawa:20140223020316p:plain

一見すると真っ白に見えますが、これはアイコンが透過色で描かれているためです。

よって、開発者はアイコンの背景に白以外の背景画像を重ねるなどして、アイコンが正常に表示されるようにする必要があります。拙作アプリ FastCheckin では、灰色の背景にアイコンを重ねるようにしています。

f:id:koogawa:20140223020425j:plain

参考:【foursquare】新カテゴリアイコンについて調べてみた - koogawa blog

2. ベニュー検索結果のJSON構造等が変わる場合がある

いつのタイミングかは忘れましたが、ベニュー検索結果のJSON構造が微妙に変わっています。このため、新しいJSON構造に対応しないサービスは、2014年6月1日以降は正常に動作しなくなる可能性があります。(スマートフォンアプリの場合は最悪クラッシュする可能性もあります)

brownoutテスト

2014年5月15日に1日だけbrownoutテストが実施されます。この期間中に 20120609 以前のバージョンを指定するとすべて拒否されます。心配な方は、この機会にサービスが正常に動くことを確認すると良いでしょう。

合わせて読みたい