šŸ”¢

POI Data Fields Definitions

Core Attributes

šŸ”¢
SKU: DPK-POI-CORE
Field Name
Defintion
Type
Example
poi_id šŸ”‘
Unique identifier of a POI. Use it to recognise the point of interest or as a foreign key to link different files and/or packages together.
STRING
470ee4c45aXXXX9d8b9028e4fefbcbdc45a839a4
name
Name of a POI
STRING
Accademia di Belle Arti di Brera
street_address
Full street address of a POI
STRING
20 Hanover Square, London W1S 1JY, United Kingdom
latitude
The latitude is given in decimal form (according to the WGS84 standard), where the value does not exceed 7 decimal places.
DOUBLE
51.5137282
longitude
The longitude is given in decimal form (according to the WGS84 standard), where the value does not exceed 7 decimal places.
DOUBLE
0.144407
industry
The industry to which the POI belongs (Hospitality, Food & Beverage, Retail...). ā†’ find the full list here.
STRING
Retail
category
The category, hierarchical leaf of the industry attribute, to which the POI belongs (Hotel, Bar, Pub, Restaurant, B&B, Museum...). ā†’ find the full list here.
STRING
Rental
date_refreshed
The date on which the POI was last updated.Please note that due to technical reasons this date might not be the same for all rows in the same file. We strive to always provide you with the most updated information.
DATE
2023-09-13

Rich Attributes

šŸ”¢
SKU: DPK-POI-RICH
šŸ“Œ
Please note the Core Attributes are always included in this file.
Field Name
Defintion
Type
Example
name_translated
Array of JSON objects, in which each object represents the original name translated into a specific language (depending on online available languages). The array can hold multiple objects, each for a different language translation. Please note that at the moment the only available language is english.
ARRAY (JSON)
[{"language": "en","name": "Brera Academy"}]
country
Country to which the POI belongs.
STRING
united kingdom
state
Region or State to which the POI belongs. Please be aware that the availability of this field varies based on the level of administrative detail specific to each country. See the complete list here.
STRING
england
county
Province or County to which the POI belongs. Please be aware that the availability of this field varies based on the level of administrative detail specific to each country. See the complete list here.
STRING
greater london
city
City to which the POI belongs. Please be aware that the availability of this field varies based on the level of administrative detail specific to each country. See the complete list here.
STRING
westminster
stars
Number of stars (valid range from 1 to 5).This information is only valid for those POIs that belong to the Hospitality industry.
INTEGER
3
rooms
Number of rooms.This information, when available, is only valid for those POIs that belong to Hospitality or Short Term Rentals industries.For more info on Industries and Categories, please refer to this page.
INTEGER
52
price_class
The price class, if available, associated with those POIs belonging only to the Food & Beverage industry. The valid range of values goes from 0 to 4, where: 0 = Free 1 = Inexpensive 2 = Moderately Expensive 3 = Expensive 4 = Very Expensive
INTEGER
3
sentiment
Proprietary percentage KPI (valid range from 1 to 100) which measures the level of customers global satisfaction of a POI.The score is calculated over a period of time equal to the last 12 months, starting from the value of the date_refreshed attribute, and is obtained through a proprietary semantic algorithm that takes into consideration multiple attributes of the online content (feedbacks, topics, opinions, languages...).
DOUBLE
91.82
popularity
Proprietary percentage KPI (uncapped range) that measures the popularity of a POI over time.The score is calculated over a period of time equal to the last 12 months, starting from the value of the date_refreshed attribute, and is obtained through the analysis of multiple factors such as the number of geo-localised reviews and social media content.This KPI can be used for comparison of POIs belonging to the same Industry. For more info on Industries and Categories, please see this page. Instead, for info about the Popularity Index click here.
DOUBLE
74.66
hours_popular
JSON representation of the timeframe, provided for each day of the week, in which the greatest influx of visitors is detected.Time slots are calculated with a proprietary analysis algorithm and takes into consideration the valid scans of the last year starting from the date on which the data-pack was requested.The mapping of values to timeframes is: Early Morning = 4:00 AM - 8:00 AM Late Morning = 9:00 AM - 12:00 AM Mid Day = 11:00 AM - 2:00 PM Afternoon = 3:00 PM - 6:00 PM Evening = 6:00 PM - 10:00 PM Night = 10:00 PM - 4:00 AM Please note that these times are sometimes overlapping due to data quality requirements. This does not effect the outcome as we are not measuring absolute values but only the relative importance.
STRING (JSON)
{"monday":"afternoon","tuesday":"afternoon","wednesday":"evening","thursday":"mid_day","friday":"evening","saturday":"evening","sunday":null}
main_clusters
Array in which each element represents a binary pair composed of Sentiment KPI (valid range from 1 to 100) and cluster.Each value in the array is calculated over statistically reliable clusters, a super set of topics on which a user expresses opinions, that can be inherent to multiple industries and/or categories. All elements are sorted in alphabetical order, based on the nome of the cluster, and the array can contain multiple elements that correspond to the most relevant clusters identified. For each cluster, the score is calculated over a period of time equal to the last 12 months, starting from the value of the date_refreshed attribute, and is obtained through a proprietary semantic algorithm that takes into consideration multiple attributes of the online content (feedbacks, topics, opinions, languages...).Please note that a cluster name is supplied in English by default; it is possible to request another language among the following: French, German, Italian, Spanish, Portuguese.
ARRAY (JSON)
[{"cluster": "Appearance","sentiment": 91.18},{"cluster": "Atmosphere","sentiment": 94.26},{"cluster": "Costs","sentiment": 50.00},{"cluster": "Food Quality","sentiment": 87.70},{"cluster": "Hospitality","sentiment": 94.69},{"cluster": "Position","sentiment": 100.00},{"cluster": "Services","sentiment": 50.00}]
most_discussed_topics
JSON representation of the top 5 most discussed topics. Each element represents a binary pair composed of Sentiment KPI (valid range from 1 to 100) and topic. Each value in the array is calculated over statistically reliable topics, a subject on which a user expresses opinions, that can be inherent to multiple industries and/or categories. All elements are sorted in ascending order, based on the value of the Sentiment KPI, and the array can contain a maximum of five elements that correspond to the most relevant topics identified. For each topic, the score is calculated over a period of time equal to the last 12 months, starting from the value of the date_refreshed attribute, and is obtained through a proprietary semantic algorithm that takes into consideration multiple attributes of the online content (feedbacks, topics, opinions, languages...).Please note that a topic name is supplied in English by default; it is possible to request another language among the following: French, German, Italian, Spanish, Portuguese.
ARRAY (JSON)
[{"topic": "food","sentiment": 97.11},{"topic": "service","sentiment": 94.19},{"topic": "restaurant","sentiment": 90.70},{"topic": "staff","sentiment": 96.30},{"topic": "wine","sentiment": 100.00}]
spoken_languages
JSON representation of the top 5 languages spoken, identified through the online content of the POI.For each of the languages, two values are provided: Sentiment KPI, obtained through a proprietary semantic algorithm that takes into consideration multiple attributes of the online content in the target language (feedbacks, topics, opinions...); percentage, which expresses the impact ratio of contents identified in the target language with respect to the total contents.
ARRAY (JSON)
[{"language": "it","sentiment": 85.93,"percentage": 94.39},{"language": "en","sentiment": 87.93,"percentage": 3.93},{"language": "de","sentiment": 100,"percentage": 0.56},{"language": "fr","sentiment": 100,"percentage": 0.42},{"language": "pt","sentiment": 100,"percentage": 0.28},{"language": "other","sentiment": 100,"percentage": 0.42}]
ā„¹ļø
Please be aware that the window for gathering and using reviews extends 12 months prior to this update date, including both the start and end dates in the range.

For example, if the date_refreshed is 2023-10-16, the reviews employed for KPI calculations are collected from the inclusive period between 2022-10-16 and 2023-10-16.

Accommodation Focus

šŸ”¢
SKU: DPK-POI-OTA
šŸ“Œ
Please note the Core Attributes are always included in this file.
Field Name
Defintion
Type
Example
traveler_origin
JSON representation of the top 5 travellers's countries of origin, identified through the online content of the POI.For each of the countries, two values are provided: Sentiment KPI, obtained through a proprietary semantic algorithm that takes into consideration multiple attributes of the online content in the target country (feedbacks, topics, opinions...); percentage, which expresses the impact ratio of contents identified in the target country with respect to the total contents.
ARRAY (DOUBLE)
[{"country": "it","sentiment": 84.67,"percentage": 19.93},{"country": "br","sentiment": 84.96,"percentage": 7.89},{"country": "gb","sentiment": 84.87,"percentage": 7.56},{"country": "es","sentiment": 85.37,"percentage": 6.82},{"country": "fr","sentiment": 84.65,"percentage": 5.11},{"country": "other","sentiment": 83.71,"percentage": 52.69}]
traveler_type
JSON representation of the top 5 travellers's types, identified through the online content of the POI.For each of the types, two values are provided: Sentiment KPI, obtained through a proprietary semantic algorithm that takes into consideration multiple attributes of the online content in the target type (feedbacks, topics, opinions...); percentage, which expresses the impact ratio of contents identified in the target type with respect to the total contents.
ARRAY (DOUBLE)
[{"traveler_type": "couple","sentiment": 83.51,"ercentage" 44.12},{"traveler_type": "family","sentiment": 85.21,"percentage": 32.63},{"traveler_type": "groups","sentiment": 85.59,"percentage": 15.68},{"traveler_type": "solo","sentiment": 81.81,"percentage": 7.38},{"traveler_type": "business","sentiment": 92.90,"percentage": 0.19}]

Contacts & Brand

šŸ”¢
SKU: DPK-POI-CONTACT
šŸ“Œ
Please note the Core Attributes are always included in this file.
Field Name
Defintion
Type
Example
phone
Phone number associated with the POI
STRING
+44 20 XXXX 2384
website
Website URL associated with the POI
STRING
https://www.datappeal.io
brand_name
The name of the Brand associated with the POI. ā€”> For more information on the methodology used and the list of covered brands please visit this page.
STRING
Western Union

Others

šŸ“Œ
Please note the Core Attributes are always included in this file.
āš ļø
Please note that these fields are only applicable to recurring deliveries. To better understand the available update frequencies, please refer to this link.
Field Name
Defintion
Type
Example
date_first_presence
Date corresponding to the first digital presence identified for the POI. The digital identity is created from the first event known of the POI present in our proprietary systems; the value of this field is therefore not necessarily linked to the first moment in which the POI appeared on the map.
DATE
2019-09-14
date_closed
The date the POI was marked as closed in our proprietary systems.This does not necessarily mean that the POI is physically closed on the reported date.This field has a value only for those data-packs that are updated and released periodically, while it will be empty in other cases.
DATE
2023-09-14