Venue Information

On this page

Snap type:

Read

Description:

This Snap obtains the Venue information from Foursquare.

  • Expected upstream Snaps: No upstream Snap is expected.
  • Expected downstream Snaps: Any file formatter followed by File Writer.
  • Expected input: No input is required.
  • Expected output: Obtains Venue Groups information or recent updates and notifications from Foursquare.


Prerequisites:

[None]

Support and limitations:Works in Ultra Task Pipelines.
Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring Foursquare Accounts for information on setting up this type of account. 

Views:
InputThis Snap has no input views.
OutputThis Snap has exactly one document output view.
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label


Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Latitude and longitude 


The latitude and longitude (ll) of the user's location (required for query searches). Required unless Near is provided. Optional if using intent=global.

Near


Required for Latitude and longitude and query searches. A string that identifies a place in the world. If the Near string is not geocodable, it returns a failed_geocode error. Otherwise, it searches within the bounds of the geocode. Adds a geocode object to the response. 

Intent

Use one of the following values to indicate your intent in performing the search. If no value is specified, Intent defaults to checkin.

checkin

Finds results that the current user (or, for requests without a user, a typical user) is likely to check in to at the ll that is supplied at the current moment in time.

browse

Finds venues within a given area. Unlike checkinbrowse searches an entire region instead of only finding Venues closest to a point. You must define a region to search that includes either the ll and radius parameters, or the sw and ne parameters. The region will be a spherical cap if you include the ll and radius parameters, or it will be a bounding quadrangle if you include the sw and ne parameters.

globalFinds the most globally-relevant venues for the search, independent of location. Ignores all other parameters other than query and limit.
matchFinds venues that are are nearly-exact matches for the given query and ll. This is helpful when trying to correlate an existing place database with that of Foursquare. It is highly sensitive to the supplied location. The results are sorted best match first — taking distance, spelling mistakes, and variations into account.
Radius

Limits the results to venues within this many meters of the specified location. Defaults to a city-wide area. Only valid for requests with intent=browse, or requests with intent=checkin and categoryId or query. Does not apply to the intent=match requests. The maximum supported radius is currently 100,000 meters.

Limit

The number of results to return, up to 50.

Query

A search term to be applied against venue names.

South west

With North east, limits the results to the bounding quadrangle defined by the latitude and longitude given by South west as its south-west corner, and North east as its north-east corner. The bounding quadrangle is only supported for intent=browse searches. Not valid with ll or radius. Bounding quadrangles with an area of up to approximately 10,000 square kilometers are supported.

North east

See South west.

Category ID

A comma-separated list of categories to limit results to. If you specify categoryId, also specifying a radius might improve results. If specifying a top-level category, all sub-categories will also match the query. Does not apply to match intent requests.

URL

A third-party URL that attempts to match against Foursquare's map of venues to URLs.

Provider ID

Identifier for a known third party that is part of Foursquare's map of venues to URLs, used in conjunction with linkedId

Linked ID

The 1002207971611 identifier used by a third party specified in providerId, which Foursquare attempts to match against its map of venues to URLs.

Snap Execution

Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.


Example


The example assumes that you have configured & authorized a valid Foursquare account (See Configuring Foursquare Accounts) to be used with this Snap. The following Venue Information Snap retrieves venue related information from Foursquare. In this example, the Snap retrieves venue information of a venue that has the term Westin in it and which is in Hyderabad, India area:

 


After a successful validation of the above Snap, you will see a data preview that shows the following venue related information: 


 


Snap Pack History

 Click to view/expand
ReleaseSnap Pack VersionDateTypeUpdates
4.27main12833 StableUpgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25main9554StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
 
Stable

Upgraded with the latest SnapLogic Platform release.

4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21snapsmrc542
 
StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19snaprsmrc528
 
StableUpgraded with the latest SnapLogic Platform release.
4.18snapsmrc523
 
StableUpgraded with the latest SnapLogic Platform release.
4.17ALL7402
 
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
 
Stable

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16snapsmrc508
 
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
 
StableUpgraded with the latest SnapLogic Platform release.
4.14snapsmrc490
 
StableUpgraded with the latest SnapLogic Platform release.
4.13

snapsmrc486

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

 
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
 
StableUpgraded with the latest SnapLogic Platform release.
4.10

snapsmrc414

 
StableUpgraded with the latest SnapLogic Platform release.
4.9

snapsmrc405

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.8

snapsmrc398

 
StableUpgraded with the latest SnapLogic Platform release.
4.7

snapsmrc382

 
StableUpgraded with the latest SnapLogic Platform release.
4.6

rcmsf233

 
StableUpgraded with the latest SnapLogic Platform release.
4.5.1

rcmsf231

 
StableUpgraded with the latest SnapLogic Platform release.
4.5rcmsf231 Stable

Doc Enhancement: Example added to Foursquare Snap Pack.

January 2014NA

Initial release of this Snap Pack, with Get Lists, Get Tips, Recent Checkins, User Information, Venue Information, Venue Groups and Updates.