Core Attributes
SKU:
DPK-POI-COREField 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-RICHPlease 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 = Free1 = Inexpensive2 = Moderately Expensive3 = Expensive4 = 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-OTAPlease 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-CONTACTPlease 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 |