フォースクエア検索ツール

フォースクエア検索ツールを使用すると、場所によってフォースクエアベニューAPIを検索し、複数のオプションで返されたデータを拡張することができます。

このマクロを使用するには、アプリケーションをフォースクエアに登録する必要があります。これは、https://foursquare.com/login を訪問し、' 新しいアプリを作成する ' を選択することによって設定することができます。必須フィールドは ' ダウンロード/ウェルカムページの url ' と ' リダイレクト url ' ですが、http://www.foursquare.comはそれらのフィールド https://foursquare.com/login のプレースホルダとして受け入れられます。したら、あなたが提供されるアプリケーションのフォームを提出している ' クライアント ID ' と ' クライアントシークレット ' トークン、マクロを構成するために必要です。

ツールを設定する

3つのタブがあります:認証、仕様、場所

認証タブ

クライアント id:フォースクエアアプリケーションクライアント id を入力します。
クライアントシークレット:フォースクエアアプリケーションクライアントシークレットを入力します。
フォースクエア api のご利用条件: このマクロを実行するためには、あなたが読んで、フォースクエア api の利用規約に同意する必要があります。

仕様タブ

検索タイプを指定します。

標準検索:指定した場所の近くにある会場のリストを返します。

キーワードの追加:このチェックボックスをオンにすると、入力した検索語に関連するものだけが返されます。

キーワード: キーワード検索用語をコンマで区切って指定します。単一の「検索用語」は1つ以上の単語で、一度に最大10の検索語を指定することができます。 (ハンバーガー、アイスクリーム、ステーキなど)カンマで区切られた各検索用語には、最大50の会場が返されます。（前の例では、合計で最大150のレコードを、検索語ごとに50まで取得できます）。

検索の傾向: 現在チェックインされているほとんどの人と、指定した場所の近くに50の会場までのリストを返します。 (キーワードはトレンド検索では使用できません)。

拡張出力：

フォースクエアマクロを使用すると、一次出力を強化したり、追加の二次出力を生成したりして、返される一次ベニュー関連データを強化できます。これらのオプションを選択すると、フォースクエアAPIからの応答を待っているため、さまざまな程度で、重要なランタイムがプロセスに追加される場合があることに注意してください。
"好き" を含める: プライマリ会場の出力でフォースクエア "好き" の列を設定するには、このチェックボックスをオンにします。

二次出力:プライマリ会場の出力に関連付けられたデータの ' セカンダリ ' 出力ストリームを生成するためにこれらのオプションのいずれかを選択します。一次および二次出力データストリームの両方にあるFoursquareVenueID列によって、二次データ出力を一次ベニュー出力に結合します。選択肢には次が含まれます：

None:セカンダリ出力は生成されません。
次の会場:現在 (すなわち、"プライマリ") 会場の後に人々が頻繁にチェックインする会場を返します。それぞれの "一次" 会場で最大5つの "次の" ベニューが返されます。
ヒント:ヒントは、メンバーがフォースクエアに掲載している。
写真:会場に関連する写真。それぞれのベニューで最大200の写真レコードが返されます。

[実際の画像データを含める]:既定では、写真出力には、写真に関連する URL 情報とその他のメタデータ (ユーザー名、写真の幅/高さなど) が含まれますが、実際の画像は表示されません。このボックスをチェックして、画像を含めます。

実際の画像を含めると、マクロの実行に必要な時間と返されるデータの量の両方が大幅に増加します。

場所タブ

検索方法を2通りの内の1つの方法で入力してください：

住所:番地、市区町村、都道府県、郵便番号を指定します。

アドレスに基づいて検索するには、キャスとジオコーダライセンスを持っている必要があります。

緯度/経度:緯度と経度のポイントを指定します。

[半径サイズ]: 会場検索の半径を指定します。

フォースクエアがサポートする最大半径の検索は、標準的なベニュー検索では100km（約60マイル）、傾向検索では20km（約12マイル）です。入力した半径が大きい場合は、自動的に適切な制限まで短縮されます。

半径の単位:半径の測定単位として、マイル、キロ、メートル、またはフィートを指定します。

出力を見る

フォースクエアツールは2つの出力を生成します：

Pアンカー: 一次出力。これは、インターフェースで選択された基準に合致し、"P" マクロ出力を介して返されるベニューのリストです。
Sアンカー: 二次出力。このオプションの出力は、"S" マクロ出力を介して戻り、これらのオプションの1つがインタフェースで選択されている場合、NextVenues、ヒント、または写真のいずれかを含みます；二次出力が選択されていない場合は空になります。

マクロによって返されるデータの詳細については、フォースクエア API ドキュメントサイトを参照してください。