Please see here for a list of frequently asked questions regarding Factual Places. If your question is not answered below, please contact your Factual representative.
Factual delivers all POI records we have for each country to our customers, including those that have been deemed to be closed businesses, duplicates, or junky data. In order to filter out those records, you will need to leverage our existence attribute.
Factual's data processing pipeline is language-agnostic. We publish our POI data in the same language as our input data. In most cases, this tends to be the most commonly spoken language of the country.
How do restaurant categories relate to the 'cuisine' field found in Restaurants extended attributes?
Factual assigns categories to all businesses and places of interest using a hierarchically arranged taxonomy. These are broad categories, intended make it easy to search and filter businesses in our global place data. Among the categories, you'll find a number of granular categories for types of restaurants, such as
Restaurants extended attributes contain a more granular field called
cuisinethat may list various types of cuisines available at each restaurant. Data in the
cuisinefield is not guaranteed to be consistent with the restaurant categorization. For example, it is both valid (and likely) to find a restaurant categorized as
Americanthat serves cuisine that includes either
Factual uses an ID based system to define the taxometric relationship between categories. Businesses are assigned to as many as three
category_ids. Correspondingly, English-readable representations of the category, including hierarchical relationships, are provided for convenience in the
category_labelsfield. Relying on IDs provides an abstraction layer with a number of significant advantages:
- Changes to names of categories can be made without disturbing the relationship of categories
- Changes to category relationships can be made without changing the names of categories
- Categories can be searched/filtered in a regionally agnostic manner.
We will deliver the data upon notice of payment from our accounting department. We aim to deliver your files within 48 hours of receiving payment confirmation. Please note that we require payment prior to releasing the data - contract execution is not sufficient.
We provide the data via a Dropbox folder specifically created for you. You will need to provide us with the email address(es) that should have access to the folder and that will receive notifications from Dropbox. Factual data files are provided in compressed, tab-delimited format and the filename includes a UNIX timestamp in milliseconds, ex:
Compression is gzip format -- it can be opened with most Windows, Linux, and Mac compression utilities.
It's possible that our accounting team has not yet processed your payment. If that's not the case, please check your spam folder to make sure the notification from Dropbox did not skip your inbox and go straight to spam.
We release updated data files roughly once a month, at which points we will replace the old data files in your Dropbox folders with the latest ones.
We do not provide notification each time we release updated data files, however, every 4 to 6 weeks you can expect that new data files will be uploaded to your Dropbox folder.
We replace the old file with a new file containing the entirety of the data. Our standard arrangement is to not provide diffs.
When we release new data files, we will upload them to your Dropbox folder.
The previous data files will be placed into the will_remove_30_days folder until the next data file is released, at which point they will be removed from the folder entirely.
We furnish our data in plain text format encoded with UTF-8. Fields are delimited by the
tabcharacter. The files are compressed
Factual files contain millions of records. If you're trying to use Excel, don't. Do not load the entire file into memory, and don't try to view with an editor - use
grep, and other utilities. These are all available for Windows at http://gnuwin32.sourceforge.net.
You will most likely not be able to open documents in tab delimited formats in programs like Excel, etc. There are a number of known text editors and command-line tools we can recommend, such as emacs, vim, etc. If you continue to experience issues, contact Factual and we can help.
What do I do if I submit data to a Trusted Data Contributor and it doesn’t show up in Factual’s data?
Please direct your questions directly to the Trusted Data Contributor with whom you submitted your data. We are working with our partners to ensure that your contributions to them are reflected in our dataset as soon as possible, but make no specific guarantees.
If you submitted data about your chain or business through a TDC, your data may take as long as 8 weeks to appear. If you submitted data through Factual's online submission form, there is no guarantee that your data will appear in Factual's dataset, as it is contingent on us receiving other submissions and inputs that verify your contribution.
Updated almost 4 years ago