%META:TOPICPARENT{name="VirtSpongerCartridgeSupportedDataSourcesVendorNonRDF"}%

---+<nowiki>Foursquare</nowiki> Cartridge - Configuration Guidelines and Implementation Notes

The Sponger cartridge for [[https://foursquare.com/][<nowiki>Foursquare</nowiki>]] is written to the [[https://developer.foursquare.com/overview/][<nowiki>Foursquare</nowiki> REST API]]. In order to use this API, the cartridge must be configured with a <nowiki>Foursquare</nowiki> OAuth token. To [[https://developer.foursquare.com/overview/auth][obtain an OAuth token]], register the Sponger as a <nowiki>Foursquare</nowiki> application. Any application name can be used, for example '<b>Sponger_{your-virtuoso-host}</b>'. However the OAuth redirect URL must point to the <nowiki>/foursquare_oauth</nowiki> virtual path defined when the [[https://virtuoso.openlinksw.com/download/][Cartridges]] VAD is installed, e.g. <b><nowiki>http://{your-virtuoso-host:port}/foursqaure_oauth/foursqaure_access_token.vsp</nowiki></b>.

%TOC% 

---++Registering the Sponger as a <nowiki>Foursquare</nowiki> Application

Before you can obtain access tokens for the cartridge, you first need to register the Sponger as a <nowiki>Foursquare</nowiki> application. 

   1 Register the Sponger using the [[https://foursquare.com/oauth][<nowiki>Foursquare</nowiki> My OAuth Consumers]]. 
%BR%%BR%<img src="%ATTACHURLPATH%/1.png" />%BR%%BR%
   1 Click "Register a New Consumer".
   1 Specify application name, application website, callback url:
%BR%%BR%<img src="%ATTACHURLPATH%/2.png" />%BR%%BR%
   1 You have successfully registered your Sponger instance as a <nowiki>Foursquare</nowiki> application and you have a Client ID and a Client Secret on the [[https://foursquare.com/oauth][<nowiki>Foursquare</nowiki> My OAuth Consumers]]:
%BR%%BR%<img src="%ATTACHURLPATH%/3.png" />%BR%%BR%
   1 Using the instruction from [[https://developer.foursquare.com/overview/auth.html][<nowiki>Foursquare</nowiki> API]] get the Oath token for your application:
%BR%%BR%<img src="%ATTACHURLPATH%/4.png" />%BR%%BR%
   1 Now go to your local Conductor at http://your-virtuoso-host:port/conductor 
   1 Go to Linked Data -> Sponger -> Extractor Cartridges:
%BR%%BR%<img src="%ATTACHURLPATH%/5.png" />%BR%%BR%
   1 Find "<nowiki>Foursquare</nowiki>" and click on its link in order to edit its properties. Enter the OAuth token noted in the cartridge's "Options" field as values for options <nowiki>oauth_token</nowiki>:
%BR%%BR%<img src="%ATTACHURLPATH%/6.png" />%BR%%BR%
   1 Click 'Update" to save the "Options" settings.

---++View the Retrieved Data

The cartridge is configured to trigger on URI pattern http*://.*.foursquare.com/.*. It is assumed that a <nowiki>Foursquare</nowiki> venue URL will be used as the starting point for sponging their profile: <b>http://uriburner.com/about/html/{your-Foursquare-venue-url}</b>. For example:

   1 Access http://uriburner.com/about/html/https://foursquare.com/v/lexington-green/4bab8662f964a5203fb03ae3 :
%BR%%BR%<img src="%ATTACHURLPATH%/7.png" />
   1 Click the primary topic value link "Lexington Green":
%BR%<img src="%ATTACHURLPATH%/8.png" />%BR%%BR%


---++Alternative Follow-Your-Nose friendly view

We can take a look at the /fct variant of the primaryTopic object page:

   1 Click the <b>Facets</b> link from the footer section "Alternative Linked Data Views" of the page from above:
%BR%<img src="%ATTACHURLPATH%/9.png" />%BR%%BR%

---++Related

   * [[VirtSponger][Virtuoso Sponger]]
   * [[VirtConfigureCartridges][Configure Sponger Cartridges Guide]]
   * [[http://ode.openlinksw.com/][The OpenLink Data Explorer Extension]]
   * [[http://delicious.com/kidehen/goodrelations][Meshups (links and lookups across Web 2.0 Services and LOD Cloud]]
   * [[VirtSpongerCartridgeSupportedDataSources][OpenLink-supplied Virtuoso Sponger Cartridges]]
      * [[VirtSpongerCartridgeSupportedDataSourcesVendorNonRDF][Complete list of supported Vendor-specific Non-RDF Data Formats]]
      * [[VirtSpongerCartridgeSupportedDataSourcesNonRDF][Complete list of supported Standard Non-RDF Data Formats]]
      * [[VirtSpongerCartridgeSupportedDataSourcesMeta][Complete list of supported Meta Cartridges]]
         * [[VirtSpongerCartridgeSupportedDataSourcesMetaREST][Meta Cartridge Usage via REST Request]]
         * [[VirtSpongerCartridgeSupportedDataSourcesMetaRESTExamples][Parametrized Examples of Meta Cartridge Usage via REST Request]]