Platform LoginContact Support
Data Feeds
Start typing to search…

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.

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.

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

Sample metadata file

Updated 11 days ago