In the following table you may find processing duration measurements taken based on a variety of test cases for each endpoint. This information can assist you when planning the utilization of Placer API.

Retry triggering

The system is built in a manner that it uses a caching mechanism for reports. As reports producing duration may take a while the system will first verify the reports caching. If the report is found then it will be immediately returned in the response. Otherwise, you will be getting the indication of IN_PROGRESS response (http-code=202) and would be asked to re-trigger the same report for receiving the full report. It is recommended to be advised of the duration estimates above when planning the retry mechanism when utilizing reports’ endpoints.

⏱Processing duration statistics

Report Name# entitiesDate range (Years)GranularityScopeRegionAverage processing time(sec.)
Ranking Index - Closely Ranked1N/AN/Acategorynationwide5.37
Ranking Index - Closely Ranked1N/AN/Achainnationwide5.26
Ranking Index - Closely Ranked1N/AN/AgroupCategorynationwide5.23
Ranking Index - Closely Ranked1N/AN/AgroupCategory153.27
Ranking Index - Closely Ranked1N/AN/Acategory152.6
Ranking Index - Closely Ranked1N/AN/Achain152.16
Visitor Journey - Favorite Chains15N/AN/AN/A1.81
Visitor Journey - Favorite Chains11N/AN/AN/A1.55
Visitor Journey - Favorite Places15N/AN/AN/A5.04
Visitor Journey - Favorite Places11N/AN/AN/A3.88
Ranking metrics For Multiple properties100lastWeekN/AN/AN/A0.62
Ranking metrics For Multiple properties100year2018N/AN/AN/A0.6
Ranking metrics For Multiple properties1lastWeekN/AN/AN/A0.51
Ranking metrics For Multiple properties1year2018N/AN/AN/A0.45
Ranking metrics for a single property11N/Acategory158.81
Ranking metrics for a single property11N/AN/AN/A8.46
Ranking metrics for a single property15N/Acategory158.44
Ranking Index - Top Ranked1N/AN/AgroupCategory153.79
Ranking Index - Top Ranked1N/AN/Acategorynationwide2.68
Ranking Index - Top Ranked1N/AN/AgroupCategorynationwide2.67
Ranking Index - Top Ranked1N/AN/Acategory152.62
Ranking Index - Top Ranked1N/AN/Achainnationwide2.34
Ranking Index - Top Ranked1N/AN/Achain152.19
Trade Area Demographics Profile Report15N/AN/AN/A1.66
Trade Area Demographics Profile Report11N/AN/AN/A1.5
Trade Area Report11N/AN/AN/A3.15
Trade Area Report15N/AN/AN/A1.32
Visit Metrics Summary Report15N/AN/AN/A15.88
Visit Metrics Summary Report11N/AN/AN/A10.3
Visit Metrics Summary Report1005N/AN/AN/A8.38
Visit Metrics Summary Report1001N/AN/AN/A5.46
Visits by days report15N/AN/AN/A0.74
Visits by days report11N/AN/AN/A0.7
Visits by Dwell Time report15N/AN/AN/A0.86
Visits by Dwell Time report11N/AN/AN/A0.68
Visits by Hours report11N/AN/AN/A0.82
Visits by Hours report15N/AN/AN/A0.75
Visit Trends Report1001dayN/AN/A13.12
Visit Trends Report1005weekN/AN/A10.2
Visit Trends Report1003weekN/AN/A6.66
Visit Trends Report15dayN/AN/A4.14
Visit Trends Report1005monthN/AN/A3.68
Visit Trends Report1001weekN/AN/A3.06
Visit Trends Report13dayN/AN/A3.02
Visit Trends Report1003monthN/AN/A2.75
Visit Trends Report1001monthN/AN/A1.89
Visit Trends Report11dayN/AN/A1.71
Visit Trends Report15weekN/AN/A1.39
Visit Trends Report13weekN/AN/A1.25
Visit Trends Report15monthN/AN/A1.22
Visit Trends Report11weekN/AN/A1.15
Visit Trends Report11monthN/AN/A1.07
Visit Trends Report13monthN/AN/A1.02

Timeout troubleshooting

We have identified cases where the gateway responds with a timeout (http-code=504). Those cases are mostly requests spanning a large date range and/or narrowed granularity (i.e., day) and/or many POIs. The Placer team is working to fix this issue. Until this issue is resolved, please use narrowed time frames and/or longer granularity and/or fewer POIs within the bulk query.