コンテンツにスキップ

データカタログ シンプルAPI

GET
/datacatalog/plateau-datasets
curl --request GET \
--url https://api.plateauview.mlit.go.jp/datacatalog/plateau-datasets

3D Tiles/MVT のデータセット一覧、複合 tileset.json のリスト、および CityGML データセット一覧がJSON形式で返却されます。

成功時のレスポンス

Media type application/json
object
datasets
required
Array<object>

3D Tiles/MVT のデータセットを表すオブジェクト。

object
id
required

データセットのID

string
name
required

データの名称

string
pref
required

都道府県名

string
pref_code
required

2桁の都道府県コード

string
city
required

市区町村名

string
city_code
required

5桁の市の市区町村コード

string
ward

区名。政令指定都市の場合のみ、区の名前が含まれる。

string
nullable
ward_code

5桁の区の市区町村コード。政令指定都市の場合のみ、区ごとの市区町村コードが含まれる。

string
nullable
type
required

配信している3D都市モデルの地物型の種別。 例: “建築物モデル”

string
type_en
required

種別の英語名。 例: “bldg” は建築物モデルを意味する。

string
url
required

3D Tiles の場合は tileset.json の URL。 MVT の場合は {z}/{x}/{y}.mvt のようなタイル URL。

string format: uri
layers

MVTのみ利用可能なレイヤー名リスト。3D Tilesの場合はnull。

Array<string>
nullable
year
required

データが整備された年度。 例: 2023 は2023年度に整備されたデータ。

integer
registration_year
required

データがPLATEAU VIEWに登録された年度。 例: 2023 は2023年度に登録されたデータ。

integer
spec
required

原典となるCityGMLデータが準拠するPLATEAU 3D都市モデル標準製品仕様書のバージョン(文字列)。

string
format
required

データ形式

string
Allowed values: 3D Tiles MVT
format_version

3D Tiles のフォーマットバージョン。3D Tiles の場合のみ "1.0" または "1.1" が入ります。 2025年度以降に Flow で変換されたデータは "1.1"、それ以外(従来の FME 等で変換されたもの)は "1.0" です。 MVT など 3D Tiles 以外のフォーマットでは省略されます。

string
nullable
Allowed values: 1.0 1.1
lod
required

データのLOD

string
texture
required

3D Tilesでテクスチャがある場合は true。テクスチャがない場合やMVTの場合は false

boolean
interior

CityGML 3.0 の屋内モデル区分。true のデータセットは 屋内モデル専用で、屋外モデルとは別行として現れます。 interior 概念がそもそも適用されないデータでは省略されます。

boolean
nullable
composite_url

このデータセットを単独で利用するための動的生成 URL。

  • 3D Tiles: 複合 tileset.json (/datacatalog/3dtiles/{spec}/tileset.json)
  • MVT: 自治体単位の TileJSON (/datacatalog/mvt/{spec}/tilejson.json) データの市区町村コードや整備年度などが揃っていない行は null
string format: uri
nullable
composite_tilesets
required

実データから派生して列挙された複合 tileset.json のリスト。 全国(area: "all")と都道府県別(area: "pref")を含みます。 各 (area, type, lod) の組について、整備年度ごとのエントリ (year が西暦4桁文字列)に加えて、各自治体の最新整備年度を 自動採用する year: "latest" のエントリも列挙されます。 テクスチャ別のバリエーション(-texture/-notexture)は、同一の (area, type, lod, year) に対して両方のデータが存在する場合のみ列挙されます。

Array<object>
object
id
required

Spec 文字列。例 all-bldg-lod1-2025

string
url
required

複合 tileset.json の完全な URL

string format: uri
area
required

all は全国、pref は都道府県単位

string
Allowed values: all pref
pref_code

都道府県コード(areapref の場合のみ)

string
nullable
pref

都道府県名(areapref の場合のみ)

string
nullable
type
required

種別の日本語名

string
type_en
required

種別の英語コード(例 bldg

string
lod
required
integer
interior

true の場合は CityGML 3.0 屋内モデルの集約。 屋外モデルとは別エントリとして現れ、interior 概念が 適用されないデータでは省略されます。

boolean
nullable
texture

null: 自動(テクスチャ優先、無ければテクスチャなし)。 true: テクスチャあり限定。false: テクスチャなし限定。

boolean
nullable
year
required

整備年度(西暦4桁文字列、例 "2025")または "latest""latest" の場合、URL は各自治体の最新整備年度の 3D Tiles を採用する複合 tileset.json を返します。

string
format_version
required

複合 tileset.json の wrapper の asset.version。 wrapper が参照する各子 tileset.json のうち、判明しているフォーマットバージョンの最大値を採用し、 すべて不明な場合は "1.0" にフォールバックします。子のうちひとつでも 1.1 があれば wrapper も 1.1 になります。

string
Allowed values: 1.0 1.1
citygml
required

自治体ごとの CityGML データセットのリストです。 地物型ごとには分かれず、各自治体の全地物型を 1 つの zip ファイルにまとめた形で、自治体ごとに 1 件返却されます。

Array<object>

自治体ごとの全地物型をまとめた CityGML データセットを表すオブジェクト。

object
id
required

データセットのID(市区町村コードと一致)

string
pref
required

都道府県名

string
pref_code
required

2桁の都道府県コード

string
city
required

市区町村名

string
city_code
required

5桁の市区町村コード

string
url
required

CityGML の zip ファイルの URL。地物型ごとには分かれず、各自治体の全地物型を 1 つにまとめた zip ファイルです。

string format: uri
composite_url

自治体・整備年度を指定して zip ファイルへリダイレクトする安定 URL (/datacatalog/citygml/{spec}/citygml.zip)。url の CMS 直リンクが 将来変わってもアプリケーション側の URL を書き換える必要がありません。

string format: uri
nullable
feature_types
required

この CityGML が含む地物型コードのリスト。 例: ["bldg", "tran", "dem"]

Array<string>
year
required

データが整備された年度(西暦)。

integer
registration_year
required

データがPLATEAU VIEWに登録された年度(西暦)。

integer
spec
required

原典となる CityGML データが準拠する PLATEAU 3D 都市モデル標準製品仕様書のバージョン(文字列)。

string
latest_datasets
required

自治体単位の -latest 3D Tiles / MVT エントリのリスト。 (自治体, 種別, LOD, 形式) の組ごとに最新整備年度の行から派生し、 url には -latest で解決される動的エンドポイントが入ります。 新しい整備年度のデータが公開されるとレスポンス内容が自動的に追従するため、 アプリケーション側で URL を書き換える必要がありません。

Array<object>
object
id
required
string
name
required
string
pref
required
string
pref_code
required
string
city
string
nullable
city_code
string
nullable
ward
string
nullable
ward_code
string
nullable
type
required
string
type_en
required
string
url
required

-latest で解決される動的 URL。

  • 3D Tiles: /datacatalog/3dtiles/{spec}/tileset.json
  • MVT: /datacatalog/mvt/{spec}/tilejson.json
string format: uri
layers
Array<string>
nullable
year
required
string
Allowed values: latest
format
required
string
Allowed values: 3D Tiles MVT
format_version

3D Tiles のフォーマットバージョン。3D Tiles の場合のみ "1.0" または "1.1" が入ります。 MVT など 3D Tiles 以外のフォーマットでは省略されます。

string
nullable
Allowed values: 1.0 1.1
lod
string
nullable
interior

CityGML 3.0 屋内モデルの場合に true

boolean
nullable
texture
boolean
nullable
latest_citygml
required

自治体単位の -latest CityGML エントリのリスト。 自治体ごとに最新整備年度の zip にリダイレクトする URL を提供し、 新しいデータ公開時にも URL の変更が不要です。

Array<object>
object
id
required
string
pref
required
string
pref_code
required
string
city
required
string
city_code
required
string
url
required

/datacatalog/citygml/{cityCode}-latest/citygml.zip

string format: uri
feature_types
required
Array<string>
year
required
string
Allowed values: latest
Example
{
"datasets": [
{
"type": "建築物モデル",
"type_en": "bldg",
"year": 2023,
"registration_year": 2023,
"spec": "3.3",
"format": "3D Tiles",
"format_version": "1.0",
"lod": "1"
}
],
"composite_tilesets": [
{
"area": "all",
"format_version": "1.0"
}
],
"citygml": [
{
"year": 2024,
"registration_year": 2024,
"spec": "4.1"
}
],
"latest_datasets": [
{
"year": "latest",
"format": "3D Tiles",
"format_version": "1.0"
}
],
"latest_citygml": [
{
"year": "latest"
}
]
}