featureIdによる使用量の取得方法

このチュートリアルでは、フィーチャーIDを使用して組織の使用量を取得する方法を説明します。

プラットフォームでは、HEREが提供するフィーチャーはフィーチャーHRNで識別されます。これはfeatureIdパラメーターとも呼ばれます。このチュートリアルでは、featureIdパラメーターを使用して特定のフィーチャーの結果をフィルターする方法を説明します。

フィーチャーHRNを見つけるには、プラットフォームランチャーの[サービス]オプションをクリックします。クリックすると、サービスが記載されたウェブページが表示されます。サービスを選択すると、選択したサービスのHRNが記載されたウェブページが表示されます。フィーチャーHRN このサンプルリクエストでは、realmIdに_org123456789_、startDateに_2021-07-01T10:39:51_、endDateに_2021-08-30T10:39:51_、featureIdに_hrn:here:service::org123456789:search-geocoding-1_を使用しています。

    GET https://usage.bam.api.here.com/v2/usage/realms/org123456789/startDate=2021-07-01T10:39:51&endDate=2021-08-30T10:39:51&featureId=hrn:here:service::org123456789:search-geocoding-1

パラメーター

ここに示されているパラメーターは、このサンプルリクエストに必要なパラメーターのみです。パラメーターの全リストは、コスト管理の使用量API v2 APIリファレンスを参照してください。


realmId 必須	文字列[ 5 ...30 ]文字。 _例：_org123456789 組織ID。
startDate 必須	文字列"date-time"。例：startDate=yyyy-MM-dd'T'HH:mm:ss 検索する期間の開始日。
endDate 必須	文字列"date-time"。例：endDate=yyyy-MM-dd'T'HH:mm:ss >検索する期間の終了日。
featureId	256文字以下の文字列。例：featureId=hrn:here:service::org123456789:search-geocoding-1 フィーチャーHRNがフィーチャーIDです。

ヘッダーパラメーター


X-Request-ID	string サービスに送信された単一のリクエストまたは一連のリクエストの追跡に使用するユーザー提供のトークン。
X-Correlation-ID 必須	string 自動生成されるID。リクエストを一意に識別し、レスポンスで利用可能。サポートチームに特定のリクエストの問い合わせを行う場合は、このヘッダーの値を共有します。こちらは問題のトラブルシューティングで役に立ちます。

レスポンス：HTTP 200 OK

リクエストは次のサンプルレスポンスを返します。

{
  "total": 10,
  "limit": 100,
  "items": [
    {
      "realmId": "org123456789",
      "billingSubscriptionId": "",
      "billingChargeNumber": "",
      "featureId": "hrn:here:service::org123456789:search-geocoding-1",
      "category": "service",
      "name": "Geocoder Autosuggest",
      "valueDriver": "Transactions",
      "usageValue": "10",
      "billableValue": "10"
    },
  ],
  "nextOffset": 0,
  "lastOffset": 0
}