Points of Interest Metadata
Provided upon request to supplement the Premium Export, and Visits by Origins data feeds, the POI metadata provides additional static information, such as an address, category, store ID, etc for every entity that is included in your feed.
Data Retention and Usage
Placer's algorithms and data constantly improve. Therefore, Venue Info may change occasionally, and new venues may be added. We strongly suggest not using data provided in old exports with new ones to avoid data anomalies.
Schema Overview
Each metadata file will have the following columns:
| Column | Description | Type | Example |
|---|---|---|---|
| id | Placer's entity ID | string | '59ae96a9173f562d3c355488' |
| type | Entity type. Supported entity types: venue, complex, chain, and billboard. | string | 'venue' |
| name | Entity's Name (in many cases will be the same as the chain's name) | string | 'Dick's Sporting Goods' |
| chain_id | Parent Chain ID | string | '588795f54c0da83f6d1c1414' |
| chain_name | Parent Chain Name | string | 'Dick's Sporting Goods' |
| lat | The entity's latitude. | double | 37.786099 |
| lng | The entity's longitude. | double | -121.46352 |
| category | Entity's Category | string | 'Apparel' |
| sub_category | Entity's Sub-category. *** Based on the categories scheme | string | 'Recreational & Sporting Goods' |
| store_id | If available, the official store ID as defined by the parent chain. | string | '82358' |
| address | Entity's address (Street + number) | string | 700-706 Mission St |
| city | Entity's city name | string | San Francisco |
| state_name | Entity's state name | string | California |
| state_code | Entity's state code | string | CA |
| country | Entity's country name | string | United States |
| country_code | Entity's country code | string | US |
| zipcode | Entity's zipcode | string | 94103 |
| dma_name | The DMA's name | string | "Albany, GA" |
| dma_code | The DMA's code | string | 525 |
| cbsa_name | The MSAs or micro-MSAs name | string | "San Luis Obispo-Paso Robles, CA Metro Area" |
| cbsa_code | The MSAs or micro-MSAs number | string | 42020 |
| opening_date | The first known date a certain venue was publicly opened | string formatted as ISO-8601 | 2020-08-01 |
| closing_date | The last known date a certain venue was closed | string formatted as ISO-8601 | 2020-09-01 |
| enclosing_shopping_center_id | The POI ID of the enclosing shopping center for the requested | string | '5f1da6d1e7e43b78baea93df' |
| enclosing_shopping_center_name | The POI name of the enclosing shopping center for the requested | string | 'Long Beach Towne Center' |
| category_group | Business domains. *** Based on the categories scheme | string | 'Apparel' |
| publication_date | Data publication date | string formatted as ISO-8601 | 2020-08-01 |
Deprecated Columns
The complete removal of those columns from the POI metadata file included in the DV2.1 feed will occur on September 22, 2024.
| Column | Description | Type | Example |
|---|---|---|---|
| mainType | Originating entity type. Supported values: 'venue', 'complex', 'chain', and 'billboard'. | string | 'venue' |
| mainId | Originating entity Placer ID. | string | '5965fca0173f564b883c222e' |
These deprecated fields provided additional context as to why a line was included in the report. If a venue was explicitly included, its ID and type will be noted. If the venue was included as part of a chain, the chain details will be included.
Important: These fields should not be used for any new integration, and are only provided to assist during a transition period and will be removed in future versions.
Sample file
Updated 3 months ago