Mapray Tileset API (2.0.0)

Download OpenAPI specification:Download

Mapray Tileset API はラスターおよびベクター地理空間情報データの管理機能を提供します。

Tileset Datasetはラスターおよびベクター地理空間情報データを意味します。

ファイルのアップロード手順

Tileset Datasetの作成
Tileset DatasetのIDを用いてファイルアップロード用のURLを取得
アップロード用のURLにファイルをアップロード
データをコンバート

エラー一覧

Response body	HTTP status code	説明
invalid request	400	無効なリクエスト
not found	404	該当データが存在しません

tilesetdatasetsv2

Mapray Tileset API (2.0.0)

List Tilesets

認証情報から得たorganizationIDに紐づくtilesetのリストを取得します。

Authorizations:

OAuthApi-Key

query Parameters

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" ソート方向

Responses

Response samples

Content type

application/json

[{"id": "5979479326288593",
"owner_id": "6062859285729275",
"created_at": "2022-03-30T05:03:52.761984Z",
"updated_at": "2022-03-30T05:03:52.761984Z",
"url": "https://dummy.appspot.com/tileset/5979479326288593/",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
],
"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": 2451,
"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
}
}
]

Create Tileset Dataset

新しいTileset datasetを作成します。

Authorizations:

OAuthApi-Key

Request Body schema: application/json

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)

Responses

Request samples

Payload

Content type

application/json

{"name": "tokyo",
"description": "test",
"srid": 2451,
"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",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
]
}

Response samples

Content type

application/json

{"id": "5979479326288593",
"owner_id": "6062859285729275",
"created_at": "2022-03-30T05:03:52.761984Z",
"updated_at": "2022-03-30T05:03:52.761984Z",
"url": "https://dummy.appspot.com/tileset/5979479326288593/",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
],
"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": 2451,
"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"
}
}

Count Tileset Datasets

認証情報から得たorganizationIDに紐づくTileset datasetの数を取得します。

Authorizations:

OAuthApi-Key

Responses

Response samples

Content type

application/json

{"count": 0
}

Retrieve Tileset Dataset

指定したTileset datasetの情報を取得します。

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Responses

Response samples

Content type

application/json

{"id": "5979479326288593",
"owner_id": "6062859285729275",
"created_at": "2022-03-30T05:03:52.761984Z",
"updated_at": "2022-03-30T05:03:52.761984Z",
"url": "https://dummy.appspot.com/tileset/5979479326288593/",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
],
"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": 2451,
"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
}
}

Update Tileset Dataset

Tileset datasetのプロパティを更新します。 request bodyで指定したTileset datasetオブジェクトのデータでデータがすべて更新されます。（部分更新はできません）

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Request Body schema:
application/json

name required	string [ 1 .. 128 ] characters 名前
description	string [ 0 .. 300 ] characters 説明
	Array of objects (attributions)

Responses

Request samples

Payload

Content type

application/json

{"name": "tokyo",
"description": "test",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
]
}

Response samples

Content type

application/json

{"id": "5979479326288593",
"owner_id": "6062859285729275",
"created_at": "2022-03-30T05:03:52.761984Z",
"updated_at": "2022-03-30T05:03:52.761984Z",
"url": "https://dummy.appspot.com/tileset/5979479326288593/",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
],
"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": 2451,
"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"
}
}

Delete Tileset Dataset

指定したデータセットを削除します。アップロードしたデータ全部を削除します。一度削除したファイルはもとに戻すことができません。

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Responses

Response samples

Content type

application/json

No sample

Reset Tileset Dataset

Tileset dataset をコンバートリクエスト前の状態に戻します。再度ファイルをアップロードする必要があります。

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Request Body schema: application/json

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)

Responses

Request samples

Payload

Content type

application/json

{"name": "tokyo",
"description": "test",
"srid": 2451,
"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",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
]
}

Response samples

Content type

application/json

{"id": "5979479326288593",
"owner_id": "6062859285729275",
"created_at": "2022-03-30T05:03:52.761984Z",
"updated_at": "2022-03-30T05:03:52.761984Z",
"url": "https://dummy.appspot.com/tileset/5979479326288593/",
"attributions": [{"display": "©Mapray",
"link": "https://mapray.com",
"description": "Mapray",
"logo": "https://mapray.com/images/logo.svg"
}
],
"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": 2451,
"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"
}
}

Create Upload URL

TilesetファイルをアップロードするためのURLを取得し、データを送信することでアップロードできます。

アップロードファイルごとにURLを取得します。
upload URLの有効期間は15分になります。
同一のupload URLは有効期間内であれば何回でも使用できます。
upload URLは何回でも作り直せます。

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Request Body schema: application/json
required

Array

filename required	string ファイル名
content_type required	string ファイルのContent-Type https://www.iana.org/assignments/media-types/media-types.xhtml

Responses

Request samples

Payload

Content type

application/json

[{"filename": "test.tif",
"content_type": "application/octet-stream"
}
]

Response samples

Content type

application/json

[{"filename": "test.tif",
"content_type": "application/octet-stream",
"url": "https://dummy.appspot.com/bucket/test.tif?Expires=1626000000&GoogleAccessId=upload%40account&Signature=..."
}
]

Upload Tileset and Relative Data

ファイルアップロードを実行します。

生成したURLにデータを送信します。
multipart/form-dataではアップロードできないため、URLに対して生成時に指定したContent-Typeを指定してください。

path Parameters

upload_url

required

string

header Parameters

Content-Type

required

string

URL生成時に指定したContent-Type

Request Body schema: image/tiff; application=geotiff

any

Responses

Response samples

Content type

application/xml

<?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>

Convert Tileset Dataset

Tileset datasetのコンバートを開始します

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Request Body schema: application/json

types

required

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"types": ["info",
"contour",
"heightmap",
"image",
"tiles"
]
}

List Tileset Dataset Convert Statuses

指定したTileset datasetのコンバート情報のリストを取得します。

Authorizations:

OAuthApi-Key

path Parameters

TilesetDatasetID

required

string

指定するTilesetDatasetのID

Responses

Response samples

Content type

application/json

[{"id": "2022040459062735",
"userID": "6062859285729275",
"3DDatasetID": "5979479326288593",
"inputFilePath": "https://dummy.appspot.com/tileset/5869839798464838/input",
"outputFilePath": "https://dummy.appspot.com/tileset/5869839798464838/output",
"start_at": "2022-04-04T07:15:32.234156Z",
"finish_at": "2022-04-04T07:15:32.234156Z",
"type": "tiles",
"options": [{"flag": "resampling",
"value": "average"
}
],
"status": "queued"
}
]

Mapray Tileset API (2.0.0)

ファイルのアップロード手順

エラー一覧

tilesetdatasetsv2

List Tilesets

Authorizations:

query Parameters

Responses

Response samples

Create Tileset Dataset

Authorizations:

Request Body schema: application/json

Responses

Request samples

Response samples

Count Tileset Datasets

Authorizations:

Responses

Response samples

Retrieve Tileset Dataset

Authorizations:

path Parameters

Responses

Response samples

Update Tileset Dataset

Authorizations:

path Parameters

Request Body schema: application/jsonapplication/xmlmultipart/form-dataapplication/json

Responses

Request samples

Response samples

Delete Tileset Dataset

Authorizations:

path Parameters

Responses

Response samples

Reset Tileset Dataset

Authorizations:

path Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Create Upload URL

Authorizations:

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Upload Tileset and Relative Data

path Parameters

header Parameters

Request Body schema: image/tiff; application=geotiff

Responses

Response samples

Convert Tileset Dataset

Authorizations:

path Parameters

Request Body schema: application/json

Responses

Request samples

List Tileset Dataset Convert Statuses

Authorizations:

path Parameters

Responses

Response samples

Request Body schema:
application/json

Request Body schema: application/json
required