Python ArcGIS Item.usage用法及代码示例

本文简要介绍 python 语言中 arcgis.gis.Item.usage 的用法。

用法:

usage(date_range='7D', as_df=True)

返回：

Pandas DataFrame 或字典

注意：

usage 方法仅适用于 ArcGIS 在线。

对于项目所有者和管理员，usage 方法提供有关项目的使用详细信息，帮助您衡量其受欢迎程度。使用详细信息显示该项目在您选择的时间段内被使用的次数。提供过去一年的历史使用信息。根据项目类型，使用情况详细信息可以包括查看次数、请求次数或下载次数，以及每天的平均查看次数、请求次数或下载次数。

浏览次数是指该项目被查看或打开的次数。对于Map、场景、非托管图层和 Web 应用程序，当您打开项目页面或在 Map Viewer 中打开项目时，视图计数会增加 1。例如，如果您打开Map图像图层的项目页面并单击在 Map Viewer 中打开，则计数将增加 2。对于其他项目(例如移动应用程序、KML 等)，当您打开该项目时，查看次数会增加 1；当您打开项目详细信息页面时，计数不会增加。

对于托管 Web 图层(要素、切片和场景)，提供请求数而不是视图数。请求数是指对该层内的数据发出请求的次数。例如，某人可能会打开包含托管要素图层的应用程序。打开应用程序算作应用程序的一个视图，但可能需要多个请求才能绘制托管层中的所有要素，因此也算作该视图。

对于可下载的文件项类型(例如 CSV、SHP 等)，会显示下载次数。对于已注册的应用程序，“使用情况”选项卡还显示用户登录该应用程序的次数。允许通过组织订阅访问订阅者内容的应用程序按积分显示使用情况。此外，信用使用报告期的时间范围可以更改。

Parameter	Description
date_range	可选字符串。默认值为 7 天。这是查询给定项目的使用情况的时间段。 24H 过去 24 小时 7D 过去 7 天(默认) 14D 过去 14 天 30D 过去 30 天 60D 过去 60 天 6M 过去 6 个月 1Y 过去 12 个月 (日期 1，日期 2) 定义自定义日期范围的 2 个日期时间对象的元组
as_df	可选布尔值。当 True 时返回 Pandas DataFrame，当 False 时以字典形式返回数据

例子：

# Usage Example #1: Standard date_range

>>> flyr_item = gis.content.get("8961540a52da402876e0168fa29bb82d")
>>> result = flyr_item.usage(date_range = "7D")
    Date  Usage
0 2022-08-05      0
1 2022-08-06      0
2 2022-08-07      0
3 2022-08-08      0
4 2022-08-09      0
5 2022-08-10      0
6 2022-08-11      0
7 2022-08-12      8

# Usage Example #2: Custom date_range

>>> import datetime as dt

>>> flyr_item = gis.content.get("8961540a52da402876e0168fa29bb82d")
>>> date_1 = dt.datetime(2022,7,31)
>>> date_2 = dt.datetime.now(2022,8,12)
    # Early value, later value
>>> result = flyr_item.usage(date_range = (date_1, date_2))
>>> result
         Date  Usage
0  2022-07-31      0
1  2022-08-01      0
2  2022-08-02      0
3  2022-08-03      0
4  2022-08-04      0
5  2022-08-05      0
6  2022-08-06      0
7  2022-08-07      0
8  2022-08-08      0
9  2022-08-09      0
10 2022-08-10      0
11 2022-08-11      0
12 2022-08-12     10