Download OpenAPI specification:Download
Mapray Point Cloud Dataset API は3次元地理空間の点群データの管理機能を提供します。
PC Datasetは3次元の点群データを意味します。
Response body | HTTP status code | 説明 |
---|---|---|
invalid request | 400 | 無効なリクエスト |
unauthorized | 401 | 権限がありません |
not found | 404 | 該当データが存在しません |
userIDに紐づくPC datasetリストを取得します。
userID required | string 対象データが紐づいているユーザーID |
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": "5698378922983424",
- "owner_id": "6252052887896064",
- "created_at": "2021-08-12T02:58:27.377537Z",
- "updated_at": "2021-08-18T02:58:27.377537Z",
- "format": "raw",
- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "status": "ready",
- "bbox": [
- 1,
- 2,
- 3
], - "content_root": [
- 11,
- 22,
- 33
], - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
]
新しいPC datasetを作成します。
userID required | string 対象データが紐づいているユーザーID |
name required | string [ 1 .. 128 ] characters 名前 |
description | string [ 0 .. 300 ] characters Default: "" 説明 |
srid required | 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/ で示されるコード。 |
x | number Default: 0 sridで指定した座標系での位置 x (座標系の定義による) |
y | number Default: 0 sridで指定した座標系での位置 y (座標系の定義による) |
z | number Default: 0 sridで指定した座標系での位置 z (座標系の定義による) |
xyz_type | integer xyzフォーマットの種類番号 |
object keyがコンバートオプションのMap | |
Array of objects (attributions) | |
src_file_type | string Value: "las" コンバート前のデータフォーマット |
dst_file_type | string Value: "raw" コンバート後のデータフォーマット |
{- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "src_file_type": "las",
- "dst_file_type": "raw",
- "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
{- "id": "5698378922983424",
- "owner_id": "6252052887896064",
- "created_at": "2021-08-12T02:58:27.377537Z",
- "updated_at": "2021-08-12T02:58:27.377537Z",
- "format": "raw",
- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "status": "ready",
- "bbox": [
- 1,
- 2,
- 3
], - "content_root": [
- 11,
- 22,
- 33
], - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
指定したPC datasetの情報を取得します。
userID required | string 対象データが紐づいているユーザーID |
PCdatasetID required | string 指定するPCdatasetのID |
{- "id": "5698378922983424",
- "owner_id": "6252052887896064",
- "created_at": "2021-08-12T02:58:27.377537Z",
- "updated_at": "2021-08-18T02:58:27.377537Z",
- "format": "raw",
- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "status": "ready",
- "bbox": [
- 1,
- 2,
- 3
], - "content_root": [
- 11,
- 22,
- 33
], - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
PC datasetのプロパティを更新します。 request bodyで指定したPC datasets オブジェクトのデータで データが全て更新されます。(部分更新はできません)
userID required | string 対象データが紐づいているユーザーID |
PCdatasetID required | string 指定するPCdatasetのID |
name required | string [ 1 .. 128 ] characters 名前 |
description | string [ 0 .. 300 ] characters 説明 |
Array of objects (attributions) |
{- "name": "tokyo",
- "description": "test",
- "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
{- "id": "5698378922983424",
- "owner_id": "6252052887896064",
- "created_at": "2021-08-12T02:58:27.377537Z",
- "updated_at": "2021-08-18T02:58:27.377537Z",
- "format": "raw",
- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "status": "ready",
- "bbox": [
- 1,
- 2,
- 3
], - "content_root": [
- 11,
- 22,
- 33
], - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
PC Dataset をコンバートリクエスト前の状態に戻します。 再度ファイルをアップロードする必要があります。
userID required | string 対象データが紐づいているユーザーID |
PCdatasetID required | string 指定するPCdatasetのID |
name required | string [ 1 .. 128 ] characters 名前 |
description | string [ 0 .. 300 ] characters Default: "" 説明 |
srid required | 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/ で示されるコード。 |
x | number Default: 0 sridで指定した座標系での位置 x (座標系の定義による) |
y | number Default: 0 sridで指定した座標系での位置 y (座標系の定義による) |
z | number Default: 0 sridで指定した座標系での位置 z (座標系の定義による) |
xyz_type | integer xyzフォーマットの種類番号 |
object keyがコンバートオプションのMap | |
Array of objects (attributions) | |
src_file_type | string Value: "las" コンバート前のデータフォーマット |
dst_file_type | string Value: "raw" コンバート後のデータフォーマット |
{- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "src_file_type": "las",
- "dst_file_type": "raw",
- "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
{- "id": "5698378922983424",
- "owner_id": "6252052887896064",
- "created_at": "2021-08-12T02:58:27.377537Z",
- "updated_at": "2021-08-12T02:58:27.377537Z",
- "format": "raw",
- "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "x": 1,
- "y": 2,
- "z": 3,
- "xyz_type": 0,
- "status": "ready",
- "bbox": [
- 1,
- 2,
- 3
], - "content_root": [
- 11,
- 22,
- 33
], - "attributions": [
- {
- "display": "©Mapray",
- "description": "Mapray",
}
]
}
PointCloudファイルをアップロードするためのURLを取得し、データを送信することでアップロードできます。
userID required | string 対象データが紐づいているユーザーID |
PCdatasetID required | string 指定するPCdatasetのID |
アップロードするファイル情報
filename required | string ファイル名 |
content_type required | string ファイルのContent-Type https://www.iana.org/assignments/media-types/media-types.xhtml |
[- {
- "filename": "test.las",
- "content_type": "application/octet-stream"
}
]
[- {
- "filename": "test.las",
- "content_type": "application/octet-stream",
}
]
ファイルアップロードを実行します。
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>
指定したPC datasetのコンバート情報を取得します。
userID required | string 対象データが紐づいているユーザーID |
PCdatasetID required | string 指定するPCdatasetのID |
{- "id": "6833388005540832",
- "userID": "6252052887896064",
- "3DDatasetID": "6252052887896064",
- "inputFilePath": "dummy.appspot.com/pcdataset/6252052887896064/6252052887896064/input",
- "outputFilePath": "dummy.appspot.com/pcdataset/6252052887896064/6252052887896064/output",
- "error": "",
- "startAt": "2021-08-12T02:58:27.377537Z",
- "finishAt": "2021-08-12T02:59:27.377537Z",
- "options": [
- {
- "flag": "jzone",
- "value": "1"
}
], - "status": "ready"
}