コンテンツにスキップ

クイックスタート

このページでは、PLATEAU 配信サービスから最初のデータを取得するまでの最短手順を紹介します。

API に慣れていない方は、まず データセット一覧 ページがおすすめです。 都道府県・市区町村・種別・形式などで絞り込み、配信 URL をその場でコピーできます。 コピーした URL は、次の「3. 表示する」のサンプルコードにそのまま貼り付けて使えます。

API から直接取得したい場合は、データカタログ API を使ってデータを検索します。例えば、東京都千代田区(自治体コード 13101)のデータセット一覧を取得:

Terminal window
curl 'https://api.plateauview.mlit.go.jp/datacatalog/plateau-datasets' \
| jq '.datasets[] | select(.city_code == "13101")'

または GraphQL でも取得できます:

Terminal window
curl -X POST https://api.plateauview.mlit.go.jp/datacatalog/graphql \
-H 'Content-Type: application/json' \
-d '{"query":"{ area(code: \"13101\") { datasets { name items { url format } } } }"}'

レスポンスの composite_url フィールドが、CesiumJS や MapLibre などのクライアントから利用しやすい配信 URL です。

  • 3D Tiles の場合: 自治体単位の tileset.json を動的生成した URL(複合 tileset.json API
  • MVT の場合: 自治体単位の TileJSON 3.0 を動的生成した URL(MVT TileJSON API

url フィールドは原典となる配信 URL(3D Tiles なら tileset.json、MVT なら {z}/{x}/{y}.mvt 形式)で、PLATEAU CMS から直接配信されます。

最も手軽なのは CesiumJS での 3D Tiles 表示です。

<!doctype html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<script src="https://cesium.com/downloads/cesiumjs/releases/1.117/Build/Cesium/Cesium.js"></script>
<link href="https://cesium.com/downloads/cesiumjs/releases/1.117/Build/Cesium/Widgets/widgets.css" rel="stylesheet">
<style>html, body, #cesiumContainer { width:100%; height:100%; margin:0; padding:0; overflow:hidden; }</style>
</head>
<body>
<div id="cesiumContainer"></div>
<script>
const viewer = new Cesium.Viewer("cesiumContainer", {});
Cesium.Cesium3DTileset.fromUrl(
'https://api.plateauview.mlit.go.jp/datacatalog/3dtiles/13101-bldg-lod1-latest/tileset.json'
).then(tileset => {
viewer.scene.primitives.add(tileset);
viewer.zoomTo(tileset);
});
</script>
</body>
</html>

このファイルをブラウザで開けば、千代田区の 3D 建物モデルが表示されます。