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