DescribeDatasets

説明

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

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

要求 URL (すべてのデータベース)

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

要求 URL (1 つのデータベース)

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

メタデータ情報は、E:\\db\\ERM-US\\2014.09\\driving\\northeastと 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",
                    "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 Midwest",
                "name": "USA",
                "product": "Spatial",
                "vintage": "September 2015"
            },
            {
                "component": "routing",
                "description": "USA Test dataset",
                "ext":
                {
                    "bbox":
                    [
                        68.291015625,
                        7.9721977144,
                        97.55859375,
                        35.4606699515
                    ],
                    "crs": "epsg:4326",
                    "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 NE",
                "name": "USA",
                "product": "Spatial",
                "vintage": "September 2015"
            }
        ]
    }

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

レスポンス:

{
        "dataSets":
        [
            {
                "component": "routing",
                "description": "USA Test dataset",
                "ext":
                {
                    "bbox":
                    [
                        68.291015625,
                        7.9721977144,
                        97.55859375,
                        35.4606699515
                    ],
                    "crs": "epsg:4326",
                    "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 Midwest",
                "name": "USA",
                "product": "Spatial",
                "vintage": "September 2015"
            }
        ]
    }