Query Analysis Time Series

指定した時間に使われた検索Queryを分析してfield別に計算します。

city1: 都市区分フィールド1 ex) ソウル特別市、京畿道、忠清北道
city2: 都市区分フィールド2 ex) 江南区、瑞草、九老区
city3: 都市区分フィールド2 ex) ヨクサン洞、ジョンジャ洞、ソチョ洞
country: 国家
word : 検索Queryを形態素解析したword

POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/analysis/timeseries

リクエスト

リクエストパラメータ

パラメータ名	必須	タイプ	制約事項	説明
name	Yes	string		作成されているDomain名

リクエストボディ

パラメータ名	必須	タイプ	説明
from	Yes	string	開始時間(UTC, ex: 20161027T171340Z )
to	Yes	string	終了時間(UTC, ex: 20161027T171340Z )
field	Yes	QueryAnalysisField	集計field設定
field_value	No	string	該当パラメータと一致するfield valueのみをリターン
max_size	Yes	int	aggregateするkeyの最大個数
interval	Yes	int	aggregationする時間 / 単位 : 分

レスポンス

フィールド名	タイプ	説明	備考
key_as_string	string	aggregate基準時間	例示: 2019-09-25T09:50:00.000Z
key	number	aggreagte基準時間(milliseconds)	例示: 1569405000000
doc_count	number	基準時間の間にaggregateされた結果の合計
aggregated_result.sum_other_doc_count	number	aggregate結果が指定したmax_size値より大きい時、結果に出力されてないすべての値の合計
aggregated_result.buckets[]	array	aggreagte結果のkey別のグルーピング
aggregated_result.buckets[].key	string	該当時間の間、queryに使われたfieldの値
aggregated_result.buckets[].doc_count	string	該当時間の間、queryに使われたkeyの回数

レスポンスStatus

Http Status	Desc
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Internal Server Error

例示

例示1 : field_valueがない場合

リクエスト

POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/car_dev/analysis/timeseries

POST /CloudSearch/real/v1/domain/car_dev/analysis/timeseries HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "field": "word",
  "maxSize": 5,
  "interval": 1
}

レスポンス例示

[
  {
    "key_as_string": "2019-09-25T09:50:00.000Z",
    "key": 1569405000000,
    "doc_count": 2,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "kia",
          "doc_count": 1
        },
        {
          "key": "hyundai",
          "doc_count": 1
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T09:53:00.000Z",
    "key": 1569405180000,
    "doc_count": 2,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "kia",
          "doc_count": 2
        }
      ]
    }
  }
]

例示2 : field_valueがある場合

リクエスト

POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/car_dev/analysis/timeseries

POST /CloudSearch/real/v1/domain/car_dev/analysis/timeseries HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "field": "word",
  "field_value": "bmw",
  "max_size": 10,
  "interval": 1
}

レスポンス例示

[
  {
    "key_as_string": "2019-09-25T10:35:00.000Z",
    "key": 1569407700000,
    "doc_count": 2,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 2
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T10:38:00.000Z",
    "key": 1569407880000,
    "doc_count": 13,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 13
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T11:14:00.000Z",
    "key": 1569410040000,
    "doc_count": 11,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 11
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T11:15:00.000Z",
    "key": 1569410100000,
    "doc_count": 12,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 12
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T11:16:00.000Z",
    "key": 1569410160000,
    "doc_count": 1013,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 1013
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T11:17:00.000Z",
    "key": 1569410220000,
    "doc_count": 1016,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 1016
        }
      ]
    }
  },
  {
    "key_as_string": "2019-09-25T11:18:00.000Z",
    "key": 1569410280000,
    "doc_count": 960,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "bmw",
          "doc_count": 960
        }
      ]
    }
  }
]