DescribeDatasets

説明

DescribeDatasets サービスでは、Spectrum™ Technology Platform サーバーに追加されたルーティング データベースに対応するデータセットに関するメタデータ情報を取得できます。応答は、データセット パスに存在するメタデータ情報に似たものになります。

この機能は、REST サービスでのみ使用できます。

HTTP GET URL 形式

すべてのデータセット: すべてのデータセットを対象にした HTTP GET リクエストには、次の形式を使用します。

http://<server>:<port>/rest/Spatial/erm/v1/datasets.json

単一のデータセット: 単一のデータセットを対象にした HTTP GET リクエストには、次の形式を使用します。

http://<server>:<port>/rest/Spatial/erm/v1/datasets/<dataset_ID>.json

dataset_ID は、DescribeDatabases サービスからの ‘dataSets’ 配列の中の要素に対応する ‘id’ です。

応答

このサービスの応答は、JSON 配列です。

すべてのデータセットの場合、JSON 配列の長さは、Management Console で設定したデータベースに追加された、(メタデータが存在する) データセット パスの総数と同じです。データセット パスにメタデータが存在しない場合、そのエントリは無視されます。

1 つのデータセットの場合、JSON 配列の長さは、データセット パスにメタデータが存在する場合に限り、1 となります。それ以外の場合は、空の JSON 配列が返ります。

例

2 つのルーティング データベースが Spectrum™ Technology Platform に追加されているとします。データベースの名前とデータセット パスは以下のとおりです。

1. US_NE: E:\\db\\ERM-US\\2014.09\\driving\\northeast
2. US: E:\\db\\ERM-US\\2014.09\\driving\\midwest と E:\\db\\ERM-US\\2014.09\\driving\\south

http://<server>:<port>/rest/Spatial/erm/v1/datasets.json

レスポンス:

{
  "dataSets": [{
    "component": "routing",
    "description": "USA Test dataset",
    "ext": {
      "bbox": [68.291015625, 7.9721977144, 97.55859375, 35.4606699515],
      "crs": "epsg:4326",
      "cvr": true,
      "historicTrafficTimeBuckets": {
        "amPeak": {
          "lowerBound": 700,
          "upperBound": 1000
        },
        "nightTime": {
          "lowerBound": 2200,
          "upperBound": 400
        },
        "offPeak": {
          "lowerBound": 1000,
          "upperBound": 1600
        },
        "pmPeak": {
          "lowerBound": 1600,
          "upperBound": 1900
        }
      },
      "locale": "EN",
      "type": "driving"
    },
    "id": "US dataset",
    "name": "USA",
    "product": "Spatial",
    "vintage": "September 2015"
  }]
}

http://<server>:<port>/rest/Spatial/erm/v1/datasets/US%20dataset.json

レスポンス:

{
  "dataSets": [{
    "component": "routing",
    "description": "USA Test dataset",
    "ext": {
      "bbox": [68.291015625, 7.9721977144, 97.55859375, 35.4606699515],
      "crs": "epsg:4326",
      "cvr": true,
      "historicTrafficTimeBuckets": {
        "amPeak": {
          "lowerBound": 700,
          "upperBound": 1000
        },
        "nightTime": {
          "lowerBound": 2200,
          "upperBound": 400
        },
        "offPeak": {
          "lowerBound": 1000,
          "upperBound": 1600
        },
        "pmPeak": {
          "lowerBound": 1600,
          "upperBound": 1900
        }
      },
      "locale": "EN",
      "type": "driving"
    },
    "id": "US dataset",
    "name": "USA",
    "product": "Spatial",
    "vintage": "September 2015"
  }]
}