Download OpenAPI specification:Download
Mapray Building 3D Dataset API は３次元地理空間の建物3Dデータの管理機能を提供します。
Building 3D Datasetは3次元の建物3Dデータを意味します。
| Response body | HTTP status code | 説明 |
|---|---|---|
| invalid request | 400 | 無効なリクエスト |
| unauthorized | 401 | 権限がありません |
| not found | 404 | 該当データが存在しません |
認証情報から得たorganizationIDに紐づく全てのB3D datasetリストを取得します。
| page | integer >= 1 Default: 1 1ページの要素数がlimitの場合のページ番号 |
| limit | integer [ 1 .. 100 ] Default: 5 1ページの要素数 |
| sort | string Default: "updatedAt" Enum: "id" "name" "updatedAt" ソートを行うプロパティ |
| direction | string Default: "desc" Enum: "asc" "desc" ソート方向 |
[- {
- "id": "4811188005240832",
- "owner_id": "4098494030324145",
- "created_at": "2017-09-04T05:56:10Z",
- "updated_at": "2017-09-08T08:12:13Z",
- "format": "b3d",
- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "status": "ready",
- "fileinfo": {
- "format": 1,
- "rho": 7,
- "transform": [
- 742.4224066826572,
- 0,
- 0
]
}, - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
]新しいB3D datasetを作成します。
| name required | string [ 1 .. 128 ] characters 名前 |
| description | string [ 0 .. 300 ] characters Default: "" 説明 |
| srid | number (srid) Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 4326 空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。 |
Array of objects (attributions) | |
| src_file_type | string Value: "gml" コンバート前のデータフォーマット |
| dst_file_type | string Value: "b3d" コンバート後のデータフォーマット |
{- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "src_file_type": "gml",
- "dst_file_type": "b3d",
- "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}{- "id": "4811188005240832",
- "owner_id": "4098494030324145",
- "created_at": "2017-09-04T05:56:10Z",
- "updated_at": "2017-09-04T05:56:10Z",
- "format": "b3d",
- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "status": "ready",
- "fileinfo": {
- "format": 1,
- "rho": 7,
- "transform": [
- 742.4224066826572,
- 0,
- 0
]
}, - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}指定したB3D datasetの情報を取得します。
| B3DdatasetID required | string 指定するB3DdatasetのID |
{- "id": "4811188005240832",
- "owner_id": "4098494030324145",
- "created_at": "2017-09-04T05:56:10Z",
- "updated_at": "2017-09-08T08:12:13Z",
- "format": "b3d",
- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "status": "ready",
- "fileinfo": {
- "format": 1,
- "rho": 7,
- "transform": [
- 742.4224066826572,
- 0,
- 0
]
}, - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}B3D datasetのプロパティを更新します。 request bodyで指定したB3D datasets オブジェクトのデータで データが全て更新されます。（部分更新はできません）
| B3DdatasetID required | string 指定するB3DdatasetのID |
| name required | string [ 1 .. 128 ] characters 名前 |
| description | string [ 0 .. 300 ] characters 説明 |
Array of objects (attributions) |
{- "name": "shinagawa_area",
- "description": "test",
- "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}{- "id": "4811188005240832",
- "owner_id": "4098494030324145",
- "created_at": "2017-09-04T05:56:10Z",
- "updated_at": "2017-09-08T08:12:13Z",
- "format": "b3d",
- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "status": "ready",
- "fileinfo": {
- "format": 1,
- "rho": 7,
- "transform": [
- 742.4224066826572,
- 0,
- 0
]
}, - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}B3D Dataset をコンバートリクエスト前の状態に戻します。 再度ファイルをアップロードする必要があります。
| B3DdatasetID required | string 指定するB3DdatasetのID |
| name required | string [ 1 .. 128 ] characters 名前 |
| description | string [ 0 .. 300 ] characters Default: "" 説明 |
| srid | number (srid) Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 4326 空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。 |
Array of objects (attributions) | |
| src_file_type | string Value: "gml" コンバート前のデータフォーマット |
| dst_file_type | string Value: "b3d" コンバート後のデータフォーマット |
{- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "src_file_type": "gml",
- "dst_file_type": "b3d",
- "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}{- "id": "4811188005240832",
- "owner_id": "4098494030324145",
- "created_at": "2017-09-04T05:56:10Z",
- "updated_at": "2017-09-04T05:56:10Z",
- "format": "b3d",
- "name": "shinagawa_area",
- "description": "test",
- "srid": 4326,
- "status": "ready",
- "fileinfo": {
- "format": 1,
- "rho": 7,
- "transform": [
- 742.4224066826572,
- 0,
- 0
]
}, - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}Building 3DファイルをアップロードするためのURLを取得し、データを送信することでアップロードできます。
| B3DdatasetID required | string 指定するB3DdatasetのID |
アップロードするファイル情報
| filename required | string ファイル名 |
| content_type required | string ファイルのContent-Type https://www.iana.org/assignments/media-types/media-types.xhtml |
[- {
- "filename": "test.gml",
- "content_type": "application/gml+xml"
}
][- {
- "filename": "test.gml",
- "content_type": "application/gml+xml",
}
]ファイルアップロードを実行します。
| upload_url required | string Create Upload URLで取得したUpload URL |
| Content-Type required | string URL生成時に指定したContent-Type |
アップロードするデータ
<?xml version='1.0' encoding='UTF-8'?> <Error> <Code>ExpiredToken</Code> <Message>The provided token has expired.</Message> <Details>Request signature expired at: 2021-07-01T10:00:00+00:00</Details> </Error>
指定したB3D datasetのコンバート情報を取得します。
| B3DdatasetID required | string 指定するB3DdatasetのID |
{- "id": "6833388005240832",
- "userID": "4098494030324145",
- "3DDatasetID": "4811188005240832",
- "inputFilePath": "dummy.appspot.com/b3ddataset/4098494030324145/4811188005240832/input",
- "outputFilePath": "dummy.appspot.com/b3ddataset/4098494030324145/4811188005240832/output",
- "error": "",
- "startAt": "2017-09-04T05:56:10Z",
- "finishAt": "2017-09-04T05:57:15Z",
- "options": [
- {
- "flag": "target-crs",
- "value": "4326"
}
], - "status": "ready"
}