WOLFRAM

Wolfram Language & System Documentation Center
"Factual" (Service Connection)

"Factual" (Service Connection)

Obsolete
Connect to Factual using the Wolfram Language to get data on stores, restaurants, businesses, and other points of interest.

Connecting & Authenticating

ServiceConnect["Factual"] creates a connection to the Factual API.
Use of this connection requires an internet connection and a Factual API key.

Requests

ServiceExecute["Factual","request",params] sends a request to the Factual API, using parameters params. The following give possible requests.

List of Places

Requests:

"PlacesList" — a List of rules with information on local businesses (restaurants, hotels, spas, salons, etc.) and points of interest (museums, airports, beaches, landmarks, etc.)

"PlacesDataset" — a Dataset of information on local businesses and points of interest

Parameters:
  • "Query"(required)place names or other keywords to search for
    "Location"NoneGeoPosition to search near
    "Radius"Nonesearch radius in meters (only valid with "Location")
    "Region"NoneUS state to search within
    "Locality"NoneUS city to search near
    MaxItems10number of results to return per request
    "Sort""Distance"sorting order parameter (i.e. "Distance", "Name")
    "InterpretEntities"Falseuse Interpreter to find canonical Wolfram Language representations of cities, states, dates, etc.

    • Examples

    Basic Examples  (1)

    Create a new connection:

    Wolfram Language code: factual = ServiceConnect["Factual"]

    Get information about places:

    Wolfram Language code: results = factual["PlacesDataset", {"Location" -> ["Wolfram Research"], "Radius" -> ["500 yards"], "Sort" -> "Distance", "Query" -> "coffee"}];
    Wolfram Language code: results[All, {"Name", "Address", "Distance"}]
    Wolfram Language code: GeoListPlot[ Tooltip[#["Location"], Column[{#["Name"], #["HourDisplay"]}]]& /@ results, GeoRangePadding -> Quantity[200, "Yards"]]
    Wolfram Language code: hours = (# -> (# /. Flatten[results[2, "Hours"]//Normal]))& /@ {"Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"};
    Wolfram Language code: TimelinePlot[hours[[All, 2]], PlotLegends -> hours[[All, 1]], ImageSize -> Medium]

    Get information about places given a locality or a region:

    Wolfram Language code: results = factual["PlacesDataset", "Locality" -> ["champaign"], "Query" -> "Vegan and vegetarian food", MaxItems -> 5]
    Wolfram Language code: factual["PlacesDataset", "Region" -> Entity["AdministrativeDivision", {"Illinois", "UnitedStates"}], "Query" -> "Vegan and vegetarian food", MaxItems -> 5]