Download OpenAPI specification:Download
Mapray Tileset Dataset API はラスターおよびベクター地理空間情報データの管理機能を提供します。
Tileset Datasetはラスターおよびベクター地理空間情報データを意味します。
Response body | HTTP status code | 説明 |
---|---|---|
invalid request | 400 | 無効なリクエスト |
not found | 404 | 該当データが存在しません |
認証情報から得たorganizationIDに紐づくTileset 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": "5979479326288593",
- "owner_id": "6062859285729275",
- "created_at": "2022-03-30T05:03:52.761984Z",
- "updated_at": "2022-03-30T05:03:52.761984Z",
- "statuses": [
- {
- "type": "tiles",
- "status": "queued"
}
], - "info": {
- "description": "./ortho-dem.tif",
- "driverShortName": "GTiff",
- "driverLongName": "GeoTIFF",
- "files": [
- "./ortho-dem.tif"
], - "size": [
- [
- 4289,
- 5612
]
], - "coordinateSystem": {
- "wkt": "string",
- "dataAxisToSRSAxisMapping": [
- [
- 2,
- 1
]
]
}, - "geoTransform": [
- [
- 140.43392886025845,
- 0.0000013227283488,
- 0,
- 35.84971998769358,
- 0,
- -0.0000010769339717
]
], - "metadata": { },
- "cornerCoordinates": {
- "upperLeft": [
- [
- 140.4339289,
- 35.84972
]
], - "lowerLeft": [
- [
- 140.4339289,
- 35.8436762
]
], - "lowerRight": [
- 0
], - "upperRight": [
- [
- 140.439602,
- 35.84972
]
], - "center": [
- [
- 140.4367655,
- 35.8466981
]
]
}, - "wgs84Extent": {
- "type": "Polygon",
- "coordinates": [
- [
- 0
]
]
}, - "bands": [
- {
- "band": 1,
- "block": [
- [
- 256,
- 256
]
], - "type": "Float32",
- "colorInterpretation": "Gray",
- "noDataValue": -32767,
- "overviews": [
- {
- "size": [
- 0
]
}
], - "unit": "string",
- "metadata": { }
}
]
}, - "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "tiles": {
- "tilesize": 256,
- "resampling": "average",
- "max_zoom": 10,
- "min_zoom": 4,
- "tiledriver": "png",
- "webp_quality": 75,
- "webp_lossless": false
}, - "contour": {
- "band": 1,
- "elev_attribute": "elev",
- "elev_attribute_min": "elev_min",
- "elev_attribute_max": "elev_max",
- "3d": false,
- "ignore_nodata": false,
- "nodata_value": -9999,
- "offset": 0,
- "layer_name": "contour",
- "polygons": false,
- "interval": 5
}, - "heightmap": {
- "resolution": 0.1,
- "offset": -10000,
- "bounds": [
- 139.5,
- 35.5,
- 139.6,
- 35.6
], - "minzoom": 10,
- "maxzoom": 15
}, - "image": {
- "format": "png",
- "bounds": [
- 139.5,
- 35.5,
- 139.6,
- 35.6
], - "minzoom": 10,
- "maxzoom": 15
}
}
]
新しいTileset datasetを作成します。
name | string [ 1 .. 128 ] characters 名前 |
description | string [ 0 .. 300 ] characters Default: " " 説明 |
srid | number Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。 |
src_file_type | string Value: "geotiff" コンバート前のデータフォーマット |
object (tilesetTilesOption) | |
tilesetContourOption (object) or tilesetContourOption (object) or tilesetContourOption (object) (tilesetContourOption) gdal_contour用のオプション | |
object (tilesetHeightmapOption) | |
object (tilesetImageOption) | |
Array of objects (attributions) |
{- "name": "tokyo",
- "description": " ",
- "srid": 4326,
- "tiles": {
- "tilesize": 256,
- "resampling": "average",
- "max_zoom": 10,
- "min_zoom": 4,
- "tiledriver": "png",
- "webp_quality": 75,
- "webp_lossless": false
}, - "contour": {
- "band": 1,
- "elev_attribute": "elev",
- "elev_attribute_min": "elev_min",
- "elev_attribute_max": "elev_max",
- "3d": false,
- "ignore_nodata": false,
- "nodata_value": -9999,
- "offset": 0,
- "layer_name": "contour",
- "polygons": false,
- "interval": 5
}, - "heightmap": {
- "resolution": 0.1,
- "offset": -10000
}, - "image": {
- "format": "png"
}, - "src_file_type": "geotiff"
}
{- "id": "5979479326288593",
- "owner_id": "6062859285729275",
- "created_at": "2022-03-30T05:03:52.761984Z",
- "updated_at": "2022-03-30T05:03:52.761984Z",
- "statuses": [
- {
- "type": "tiles",
- "status": "queued"
}
], - "info": {
- "description": "string",
- "driverShortName": "string",
- "driverLongName": "string"
}, - "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "tiles": {
- "resampling": "average",
- "max_zoom": 0,
- "min_zoom": 0
}, - "contour": {
- "band": 1,
- "3d": false,
- "ignore_nodata": false,
- "nodata_value": 0,
- "offset": 0,
- "layer_name": "contour",
- "polygons": false,
- "interval": 0
}, - "heightmap": {
- "resolution": 0.1,
- "offset": -10000
}, - "image": {
- "format": "png"
}
}
指定したTileset datasetの情報を取得します。
TilesetDatasetID required | string 指定するTilesetDatasetのID |
{- "id": "5979479326288593",
- "owner_id": "6062859285729275",
- "created_at": "2022-03-30T05:03:52.761984Z",
- "updated_at": "2022-03-30T05:03:52.761984Z",
- "statuses": [
- {
- "type": "tiles",
- "status": "queued"
}
], - "info": {
- "description": "./ortho-dem.tif",
- "driverShortName": "GTiff",
- "driverLongName": "GeoTIFF",
- "files": [
- "./ortho-dem.tif"
], - "size": [
- [
- 4289,
- 5612
]
], - "coordinateSystem": {
- "wkt": "string",
- "dataAxisToSRSAxisMapping": [
- [
- 2,
- 1
]
]
}, - "geoTransform": [
- [
- 140.43392886025845,
- 0.0000013227283488,
- 0,
- 35.84971998769358,
- 0,
- -0.0000010769339717
]
], - "metadata": { },
- "cornerCoordinates": {
- "upperLeft": [
- [
- 140.4339289,
- 35.84972
]
], - "lowerLeft": [
- [
- 140.4339289,
- 35.8436762
]
], - "lowerRight": [
- 0
], - "upperRight": [
- [
- 140.439602,
- 35.84972
]
], - "center": [
- [
- 140.4367655,
- 35.8466981
]
]
}, - "wgs84Extent": {
- "type": "Polygon",
- "coordinates": [
- [
- 0
]
]
}, - "bands": [
- {
- "band": 1,
- "block": [
- [
- 256,
- 256
]
], - "type": "Float32",
- "colorInterpretation": "Gray",
- "noDataValue": -32767,
- "overviews": [
- {
- "size": [
- 0
]
}
], - "unit": "string",
- "metadata": { }
}
]
}, - "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "tiles": {
- "tilesize": 256,
- "resampling": "average",
- "max_zoom": 10,
- "min_zoom": 4,
- "tiledriver": "png",
- "webp_quality": 75,
- "webp_lossless": false
}, - "contour": {
- "band": 1,
- "elev_attribute": "elev",
- "elev_attribute_min": "elev_min",
- "elev_attribute_max": "elev_max",
- "3d": false,
- "ignore_nodata": false,
- "nodata_value": -9999,
- "offset": 0,
- "layer_name": "contour",
- "polygons": false,
- "interval": 5
}, - "heightmap": {
- "resolution": 0.1,
- "offset": -10000,
- "bounds": [
- 139.5,
- 35.5,
- 139.6,
- 35.6
], - "minzoom": 10,
- "maxzoom": 15
}, - "image": {
- "format": "png",
- "bounds": [
- 139.5,
- 35.5,
- 139.6,
- 35.6
], - "minzoom": 10,
- "maxzoom": 15
}
}
Tileset datasetのプロパティを更新します。 request bodyで指定したTileset datasetオブジェクトのデータで データがすべて更新されます。(部分更新はできません)
TilesetDatasetID required | string 指定するTilesetDatasetの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": "5979479326288593",
- "owner_id": "6062859285729275",
- "created_at": "2022-03-30T05:03:52.761984Z",
- "updated_at": "2022-03-30T05:03:52.761984Z",
- "statuses": [
- {
- "type": "tiles",
- "status": "queued"
}
], - "info": {
- "description": "./ortho-dem.tif",
- "driverShortName": "GTiff",
- "driverLongName": "GeoTIFF",
- "files": [
- "./ortho-dem.tif"
], - "size": [
- [
- 4289,
- 5612
]
], - "coordinateSystem": {
- "wkt": "string",
- "dataAxisToSRSAxisMapping": [
- [
- 2,
- 1
]
]
}, - "geoTransform": [
- [
- 140.43392886025845,
- 0.0000013227283488,
- 0,
- 35.84971998769358,
- 0,
- -0.0000010769339717
]
], - "metadata": { },
- "cornerCoordinates": {
- "upperLeft": [
- [
- 140.4339289,
- 35.84972
]
], - "lowerLeft": [
- [
- 140.4339289,
- 35.8436762
]
], - "lowerRight": [
- 0
], - "upperRight": [
- [
- 140.439602,
- 35.84972
]
], - "center": [
- [
- 140.4367655,
- 35.8466981
]
]
}, - "wgs84Extent": {
- "type": "Polygon",
- "coordinates": [
- [
- 0
]
]
}, - "bands": [
- {
- "band": 1,
- "block": [
- [
- 256,
- 256
]
], - "type": "Float32",
- "colorInterpretation": "Gray",
- "noDataValue": -32767,
- "overviews": [
- {
- "size": [
- 0
]
}
], - "unit": "string",
- "metadata": { }
}
]
}, - "name": "tokyo",
- "description": "test",
- "srid": 4326,
- "tiles": {
- "tilesize": 256,
- "resampling": "average",
- "max_zoom": 10,
- "min_zoom": 4,
- "tiledriver": "png",
- "webp_quality": 75,
- "webp_lossless": false
}, - "contour": {
- "band": 1,
- "elev_attribute": "elev",
- "elev_attribute_min": "elev_min",
- "elev_attribute_max": "elev_max",
- "3d": false,
- "ignore_nodata": false,
- "nodata_value": -9999,
- "offset": 0,
- "layer_name": "contour",
- "polygons": false,
- "interval": 5
}, - "heightmap": {
- "resolution": 0.1,
- "offset": -10000
}, - "image": {
- "format": "png"
}
}
TilesetファイルをアップロードするためのURLを取得し、データを送信することでアップロードできます。
TilesetDatasetID required | string 指定するTilesetDatasetのID |
filename required | string ファイル名 |
content_type required | string ファイルのContent-Type https://www.iana.org/assignments/media-types/media-types.xhtml |
[- {
- "filename": "test.tif",
- "content_type": "application/octet-stream"
}
]
[- {
- "filename": "test.tif",
- "content_type": "application/octet-stream",
}
]
ファイルアップロードを実行します。
upload_url required | string |
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: 2022-04-01T10:00:00+00:00</Details> </Error>
Tileset datasetのコンバートを開始します
TilesetDatasetID required | string 指定するTilesetDatasetのID |
types required | Array of strings |
{- "types": [
- "info",
- "contour",
- "heightmap",
- "image",
- "tiles"
]
}
指定したTileset datasetのコンバート情報のリストを取得します。
TilesetDatasetID required | string 指定するTilesetDatasetのID |
[- {
- "id": "2022040459062735",
- "userID": "6062859285729275",
- "3DDatasetID": "5979479326288593",
- "start_at": "2022-04-04T07:15:32.234156Z",
- "finish_at": "2022-04-04T07:15:32.234156Z",
- "type": "tiles",
- "options": [
- {
- "flag": "xyz",
- "value": "true"
}
], - "status": "queued"
}
]