人流量数据服务-BestTime API

什么是BestTime API的人流量数据服务?

什么是BestTime API的人流量数据服务接口？

BestTime API的人流量数据服务有哪些核心功能？

BestTime API的人流量数据服务的核心优势是什么？

自动策划城市指南 非常适合列出场所的面向消费者的应用程序。可以在软件 API 之上构建自动策划的本地城市指南。 例如： 用户附近当前繁忙的酒吧。 根据游客停留时间长短，周五最受欢迎的景点。 周三晚上好评如潮的安静餐厅。 去健身房避开人群的最佳日期和时间。
	避开人群 告知用户最佳日期和时间，以避免在旅游景点或博物馆排队。
高效的资源调度 通过应用 来自场馆客流量数据的洞察。通过在繁忙时期增加员工数量，可以提高客户满意度。在不那么拥挤的时间内减少员工数量将节省资金。
	优化场地入住率 客流量预测可用于管理场馆的供需情况。例如，优化餐厅和酒吧的入住率。通过在预计客流量较少的日期和时间在您的应用中提供折扣来优化营销。

在哪些场景会用到BestTime API的人流量数据服务？

以消费者为中心的应用 非常适合以消费者为中心的列出场所的应用程序。让您的用户更容易找到他们的理想场所，无论何时需要向他们展示安静 附近有超市，周末有繁忙的酒吧和夜总会，或者早上在特定街区有一个安静的旅游景点。
	优化数字户外广告 通过检查附近场所的客流量，找到以程序化方式展示广告的最佳时机，从而确定 吸引 特定类型的消费者，取决于场所类型。
员工时间表 使用客流量预测在您的场所安排适当数量的员工。这使您可以 减少 当它安静时，员工和劳动力成本，当它繁忙时，最大限度地提高销售额。这对人事代理机构来说也很棒。
	跟踪访客对促销活动的影响 跟踪场馆促销或活动是否使用实时数据导致更多访客。实时数据可以 表明 每周每小时，与过去几周相比，它有多繁忙或多少。

初学者指南 - 第 1 部分 - 网站工具
指导如何使用 BestTime.app 网站工具获取和分析客流量数据。我们通过向您的帐户添加柱线来证明这一点，并在周五晚上的 Mission District San Fransisco 找到最繁忙的柱线。

第一步：API 密钥
要开始使用 API，您将需要私有和公共 API 密钥。我们使用 API 密钥端点测试我们的 API 连接。使用 BestTime API 的 API 验证始终是通过在 URL 中插入 API 密钥来完成的。

fetch(
`https://besttime.app/api/v1/keys/pri_a00de9e302662c0217a9cf08ab304122`, {
  method: 'GET'
}).then(function(data) { 
	console.log(data); 
});

JSON 响应：

{
    "active": true,
    "api_key_private": "pri_a00de9e302662c0217a9cf08ab304122",
    "api_key_public": "pub_e11661721b084d36b8f469a2c012e754",
    "credits_forecast": 100,
    "credits_query": 100,
    "status": "OK",
    "valid": true
  }

第二步：向帐户添加新数据
通过名称和地址、“场所搜索”工具、地理定位器等添加场所，支持添加多个场所。

const params = new URLSearchParams({ 
 'api_key_private': 'pri_50990bf1f8828f6abbf6152013113c6b',
  'venue_name': 'Novela',
  'venue_address': '662 Mission St San Francisco, CA 94105 United States'
});

fetch(`https://besttime.app/api/v1/forecasts?${params}`, {
  method: 'POST'
}).then(function(data) { 
  console.log(data); 
});

JSON 响应：

{
    "status": "OK",
    "epoch_analysis": "1619165472",
    "venue_info": {
        "venue_id": "ven_73736634746861716337745241596841324856536453344a496843",
        "venue_name": "Novela",
        "venue_address": "662 Mission St San Francisco, CA 94105 United States",
        "venue_timezone": "America/Los_Angeles"
    },
    "analysis": [
        {
            "day_info": {
                "day_int": 4,
                "day_text": "Friday",
                "venue_open": 17,
                "venue_closed": 2,
                "day_rank_mean": 1,
                "day_rank_max": 1,
                "day_mean": 61,
                "day_max": 100
            },
            "busy_hours": [
                20,
                21,
                22,
                23,
                0
            ],
            "quiet_hours": [
                2
            ],
            "peak_hours": [
                {
                    "peak_start": 18,
                    "peak_max": 22,
                    "peak_end": 1,
                    "peak_intensity": 5,
                    "peak_delta_mean_week": 60
                }
            ],
            "surge_hours": {
                "most_people_come": 17,
                "most_people_leave": 1
            },
            "day_raw": [
              0,0,0,0,0,0,0,0,0,10,20,25,20,40,50,50,90,85,0,0,0,0,0,0
            ],
            "hour_analysis": [
                ...
                {
                    "hour": 18,
                    "intensity_txt": "Average",
                    "intensity_nr": 0
                },
                {
                    "hour": 19,
                    "intensity_txt": "Average",
                    "intensity_nr": 0
                },
                {
                    "hour": 20,
                    "intensity_txt": "Above average",
                    "intensity_nr": 1
                },
                {
                    "hour": 21,
                    "intensity_txt": "High",
                    "intensity_nr": 2
                },
                {
                    "hour": 22,
                    "intensity_txt": "High",
                    "intensity_nr": 2
                },
                {
                    "hour": 23,
                    "intensity_txt": "High",
                    "intensity_nr": 2
                },
                {
                    "hour": 0,
                    "intensity_txt": "Above average",
                    "intensity_nr": 1
                },
                {
                    "hour": 1,
                    "intensity_txt": "Average",
                    "intensity_nr": 0
                },
                ...
            ]
        }
    ],
    "api_key_private": "pri_50990bf1f8828f6abbf6152013113c6b"
}

HTML - Javascript 示例页面：

第三步：查询已有的客流量数据
每次我们使用其中一个 API 端点获取新的客流量数据时，生成的客流量数据都会在您的帐户中存储一定天数。我们可以通过调用相同的新客流量 API 端点来刷新客流量。

fetch(`https://besttime.app/api/v1/venues?api_key_private=pri_50990bf1f8828f6abbf6152013113c6b`, {
  method: 'GET'
}).then(function(data) { 
  console.log(data); 
});

JSON 响应：

    {
        "venue_address": "199 Valencia St San Francisco, CA 94103 United States",
        "venue_forecasted": true,
        "venue_id": "ven_554a4d72466171666f517a5241346a2d426951393838554a496843",
        "venue_name": "Zeitgeist"
    },{
        "venue_address": "679 3rd St San Francisco, CA 94107 United States",
        "venue_forecasted": true,
        "venue_id": "ven_6b4458536e714c784a54435241346a5f5a4e4e716459584a496843",
        "venue_name": "Alchemist Bar & Lounge"
    }
]

第四步：实时数据
上一次 API 调用根据人流量预测返回了人流量数据。BestTime 还提供特定数量的场所的实时（实时）数据（即并非所有具有客流量预测数据的场所都有实时数据）。此外，实时数据仅在营业时间内可用，而无论营业时间如何，都可以检索预测和查询数据。使用实时客流量数据 API 端点，我们可以获取实时客流量信息：

import requests

url = "https://besttime.app/api/v1/forecasts/live"

params = {
    'api_key_private': 'pri_50990bf1f8828f6abbf6152013113c6b',
    'venue_name': 'McDonalds',
    'venue_address': 'Ocean Ave, San Fransisco'
}

response = requests.request("POST", url, params=params)
print(response.json())

const params = new URLSearchParams({ 
  'api_key_private': 'pri_50990bf1f8828f6abbf6152013113c6b',
  'venue_name': 'McDonalds',
  'venue_address': 'Ocean Ave, San Fransisco'
});

fetch(`https://besttime.app/api/v1/forecasts/live?${params}`, {
  method: 'POST'
}).then(function(data) { 
  console.log(data); 
});

{
    "analysis": {
        "venue_forecasted_busyness": 60,
        "venue_live_busyness": 20,
        "venue_live_busyness_available": true,
        "venue_live_forecasted_delta": -40
    },
    "status": "OK",
    "venue_info": {
        "venue_current_gmttime": "Friday 2021-04-23 07:19AM",
        "venue_current_localtime": "Friday 2021-04-23 03:19PM",
        "venue_id": "ven_51387131543761435650505241346a394a6432395362654a496843",
        "venue_name": "McDonald's",
        "venue_timezone": "America/Los_Angeles"
    }
}