API docs by Redocly

Mapray API (2.0.0)

Download OpenAPI specification:Download

2D Datasets V2

Mapray Dataset API (2.0.0)

Mapray Datasets API はGeoJSONフォーマットを基本とした地図データの管理機能を提供します。

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

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

エラー一覧

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

List Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Dataset

認証情報から得たorganizationIDに紐づく新しいdatasetを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
required
string [ 0 .. 300 ] characters
Default: ""

説明

src_file_type
string
Default: "geojson"
Enum: "json" "geojson" "kml" "gpx" "shp"

コンバート前のデータフォーマット

dst_file_type
string
Default: "geojson"
Value: "geojson"

コンバート後のデータフォーマット

srid
number (srid)
Default: 4326
Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 3097 3098 3099 3100 3101 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 4326 32651 32652 32653 32654 32655 32656

空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。

geoid
string
Default: "EGM96_15"
Enum: "EGM96_15" "JGD2011" "ELLIPSOID"

使用しているジオイドモデル

Array of objects (attributions)

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset",
  • "description": "example",
  • "bounds": [
    ],
  • "features": [
    ],
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-03-11T11:09:17.855Z",
  • "status": "ready",
  • "attributions": []
}

Count Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset",
  • "description": "example",
  • "bounds": [
    ],
  • "features": [
    ],
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-03-11T11:09:17.855Z",
  • "status": "ready",
  • "attributions": []
}

Update Dataset

Request bodyで指定した内容にDatasetを更新します。

※部分更新はできません

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset update",
  • "description": "example update",
  • "bounds": [
    ],
  • "features": [
    ],
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-04-08T18:35:02.322Z",
  • "status": "ready",
  • "attributions": []
}

Reset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
required
string [ 0 .. 300 ] characters
Default: ""

説明

src_file_type
string
Default: "geojson"
Enum: "json" "geojson" "kml" "gpx" "shp"

コンバート前のデータフォーマット

dst_file_type
string
Default: "geojson"
Value: "geojson"

コンバート後のデータフォーマット

srid
required
number (srid)
Default: 4326
Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 3097 3098 3099 3100 3101 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 4326 32651 32652 32653 32654 32655 32656

空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。

geoid
required
string
Enum: "EGM96_15" "JGD2011" "ELLIPSOID"

使用しているジオイドモデル

Array of objects (attributions)

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset",
  • "description": "example",
  • "bounds": null,
  • "features": null,
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-03-11T11:09:17.855Z",
  • "status": "before_queued",
  • "attributions": []
}

Delete Dataset

指定したdatasetを削除します。

featuresも同時に削除されます。

一度削除したファイルは元に戻すことはできません。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Create Upload URL

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

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

指定するdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
[]

Get Dataset File List

指定したdatasetのファイル一覧情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
[
  • "test.kml",
  • "test.gpx"
]

List Features

datasetIDに紐づくすべてのfeaturesリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Insert Feature

GeoJSONのfeatureをdatasetに追加します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json

GeoJSON featureを指定します。

1つのfeatureにつき1MBの上限があり、その他のパラメータで300B程度あらかじめ使用されます。

id
string
geometrty
object
properties
object
object

Responses

Request samples

Content type
application/json
{
  • "id": "5100199366098944",
  • "geometry": {
    },
  • "properties": {
    },
  • "mapray": {
    }
}

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    },
  • "id": "geo json id",
  • "mapray": {
    }
}

Insert MultiFeatures

GeoJSONのfeatureをdatasetに追加します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
required

GeoJSON featureを指定します。

1つのfeatureにつき1MBの上限があり、その他のパラメータで300B程度あらかじめ使用されます。

Array
id
string
geometrty
object
properties
object
object

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Update Feature

Featureを更新します。 Request Bodyで指定した内容に置き換わります。 （部分更新はできません）

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
maprayFeatureID
required
string

指定するfeatureのID。

Request Body schema: application/json

GeoJSON featureを指定します。 1つのfeatureにつき1MBの上限があり、その他のパラメータで300B程度あらかじめ使用されます。

id
string
geometrty
object
properties
object
object

Responses

Request samples

Content type
application/json
{
  • "id": "62707111317995529",
  • "geometry": {
    },
  • "properties": {
    },
  • "mapray": {
    }
}

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    },
  • "id": "geo json id",
  • "mapray": {
    }
}

Retrieve Feature

指定されたuserIDが持つdatasetIDに対してfeatureIDで指定されたfeatureを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
maprayFeatureID
required
string

指定するfeatureのID。

Responses

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    },
  • "id": "geo json id",
  • "mapray": {
    }
}

Delete Feature

指定したfeatureを削除します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
maprayFeatureID
required
string

指定するfeatureのID。

Responses

Response samples

Content type
application/json
{ }

Convert 2D Dataset

2D datasetのコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Responses

Retrieve 2D Dataset Convert Status

指定した2D datasetのコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "6833388005240832",
  • "jobType": "",
  • "userID": "4098494030324145",
  • "3DDatasetID": "4811188005240832",
  • "inputFilePath": "dummy.appspot.com/dataset/4098494030324145/4811188005240832/input",
  • "outputFilePath": "dummy.appspot.com/dataset/4098494030324145/4811188005240832/output",
  • "error": "",
  • "startAt": "2017-09-04T05:56:10Z",
  • "finishAt": "2017-09-04T05:57:15Z",
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

3D Datasets V2

Mapray 3D Dataset API (2.0.0)

Mapray 3D Dataset API は３次元地理空間情報データの管理機能を提供します。

3D datasetは3次元データを意味しており、3D datasetオブジェクトはmaprayJSで利用されるmaprayシーンファイルに相当します。

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

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

エラー一覧

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

List 3D Datasets

組織に紐づく全ての3D datasetリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create 3D Dataset

新しい3D datasetを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
src_file_type
string
Enum: "glTF" "obj"

コンバート前のデータフォーマット

dst_file_type
string
Default: "glTF"

コンバート後のデータフォーマット

name
required
string [ 1 .. 128 ] characters

名前

description
string [ 0 .. 300 ] characters
Default: ""

説明

scene_id
string
Default: "0"

デフォルトで有効にしたいシーンID。glTFの場合は0以上の整数を文字列にしたもの

x
number
Default: 0

sridで指定した座標系での位置 x (座標系の定義による)

y
number
Default: 0

sridで指定した座標系での位置 y (座標系の定義による)

z
number
Default: 0

sridで指定した座標系での位置 z (座標系の定義による)

roll
number
Default: 0

sridで指定した座標系でのx軸の回転

tilt
number
Default: 0

sridで指定した座標系でのy軸の回転

heading
number
Default: 0

sridで指定した座標系でのz軸の回転

sx
number
Default: 1

sridで指定した座標系でのx軸の縮尺比率

sy
number
Default: 1

sridで指定した座標系でのy軸の縮尺比率

sz
number
Default: 1

sridで指定した座標系でのz軸の縮尺比率

offset_x
number
Default: 0

sridで指定した座標系でのoffset位置 x

offset_y
number
Default: 0

sridで指定した座標系でのoffset位置 y

offset_z
number
Default: 0

sridで指定した座標系でのoffset位置 z

offset_roll
number
Default: 0

sridで指定した座標系でoffset位置でのx軸の回転

offset_tilt
number
Default: 0

sridで指定した座標系でoffset位置でのy軸の回転

offset_heading
number
Default: 0

sridで指定した座標系でoffset位置でのz軸の回転

offset_sx
number
Default: 1

sridで指定した座標系でoffset位置でのx軸の縮尺比率

offset_sy
number
Default: 1

sridで指定した座標系でoffset位置でのy軸の縮尺比率

offset_sz
number
Default: 1

sridで指定した座標系でoffset位置でのz軸の縮尺比率

Array of objects (attributions)
path
string

関連する頂点データファイル、テクスチャなどのパスが記載されたメインとなるファイルへのパス。 1文字目は"/"で、また".."を含まない

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/ で示されるコード。

altitude_mode
string
Default: "absolute"
Enum: "absolute" "relative" "clamp"

sridで指定した座標系で高度の基準

object

keyがコンバートオプションのMap

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "src_file_type": "glTF",
  • "dst_file_type": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "3ddatasets/v2/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Count 3D Datasets

組織に紐づく3D datasetの数を取得します。

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "3ddatasets/v2/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Update 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
string [ 0 .. 300 ] characters
Default: ""

説明

scene_id
string
Default: "0"

デフォルトで有効にしたいシーンID。glTFの場合は0以上の整数を文字列にしたもの

x
number
Default: 0

sridで指定した座標系での位置 x (座標系の定義による)

y
number
Default: 0

sridで指定した座標系での位置 y (座標系の定義による)

z
number
Default: 0

sridで指定した座標系での位置 z (座標系の定義による)

roll
number
Default: 0

sridで指定した座標系でのx軸の回転

tilt
number
Default: 0

sridで指定した座標系でのy軸の回転

heading
number
Default: 0

sridで指定した座標系でのz軸の回転

sx
number
Default: 1

sridで指定した座標系でのx軸の縮尺比率

sy
number
Default: 1

sridで指定した座標系でのy軸の縮尺比率

sz
number
Default: 1

sridで指定した座標系でのz軸の縮尺比率

offset_x
number
Default: 0

sridで指定した座標系でのoffset位置 x

offset_y
number
Default: 0

sridで指定した座標系でのoffset位置 y

offset_z
number
Default: 0

sridで指定した座標系でのoffset位置 z

offset_roll
number
Default: 0

sridで指定した座標系でoffset位置でのx軸の回転

offset_tilt
number
Default: 0

sridで指定した座標系でoffset位置でのy軸の回転

offset_heading
number
Default: 0

sridで指定した座標系でoffset位置でのz軸の回転

offset_sx
number
Default: 1

sridで指定した座標系でoffset位置でのx軸の縮尺比率

offset_sy
number
Default: 1

sridで指定した座標系でoffset位置でのy軸の縮尺比率

offset_sz
number
Default: 1

sridで指定した座標系でoffset位置でのz軸の縮尺比率

Array of objects (attributions)

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "test",
  • "scene_id": "0",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "3ddatasets/v2/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Delete 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Request Body schema: application/json
src_file_type
string
Enum: "glTF" "obj"

コンバート前のデータフォーマット

dst_file_type
string
Default: "glTF"

コンバート後のデータフォーマット

name
required
string [ 1 .. 128 ] characters

名前

description
string [ 0 .. 300 ] characters
Default: ""

説明

scene_id
string
Default: "0"

デフォルトで有効にしたいシーンID。glTFの場合は0以上の整数を文字列にしたもの

x
number
Default: 0

sridで指定した座標系での位置 x (座標系の定義による)

y
number
Default: 0

sridで指定した座標系での位置 y (座標系の定義による)

z
number
Default: 0

sridで指定した座標系での位置 z (座標系の定義による)

roll
number
Default: 0

sridで指定した座標系でのx軸の回転

tilt
number
Default: 0

sridで指定した座標系でのy軸の回転

heading
number
Default: 0

sridで指定した座標系でのz軸の回転

sx
number
Default: 1

sridで指定した座標系でのx軸の縮尺比率

sy
number
Default: 1

sridで指定した座標系でのy軸の縮尺比率

sz
number
Default: 1

sridで指定した座標系でのz軸の縮尺比率

offset_x
number
Default: 0

sridで指定した座標系でのoffset位置 x

offset_y
number
Default: 0

sridで指定した座標系でのoffset位置 y

offset_z
number
Default: 0

sridで指定した座標系でのoffset位置 z

offset_roll
number
Default: 0

sridで指定した座標系でoffset位置でのx軸の回転

offset_tilt
number
Default: 0

sridで指定した座標系でoffset位置でのy軸の回転

offset_heading
number
Default: 0

sridで指定した座標系でoffset位置でのz軸の回転

offset_sx
number
Default: 1

sridで指定した座標系でoffset位置でのx軸の縮尺比率

offset_sy
number
Default: 1

sridで指定した座標系でoffset位置でのy軸の縮尺比率

offset_sz
number
Default: 1

sridで指定した座標系でoffset位置でのz軸の縮尺比率

Array of objects (attributions)
path
string

関連する頂点データファイル、テクスチャなどのパスが記載されたメインとなるファイルへのパス。 1文字目は"/"で、また".."を含まない

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/ で示されるコード。

altitude_mode
string
Default: "absolute"
Enum: "absolute" "relative" "clamp"

sridで指定した座標系で高度の基準

object

keyがコンバートオプションのMap

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "src_file_type": "glTF",
  • "dst_file_type": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "3ddatasets/v2/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Create Upload URL

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

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

例: sampleディレクトリのファイルをアップロードする場合

  /home
  └── user
      └── sample
          ├── test.gltf
          └── texture
              └── test.png

ファイルフォーマットごとに注意点がありますが、 例えばglTFファイルはglTFにリンクされるbinファイル、テクスチャファイルへのパスが記述されますが、これらのパスはglTF本体からの相対パスが指定されている必要があります。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
[]

Convert 3D Dataset

3D datasetのコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Retrieve 3D Dataset Convert Status

指定した3D datasetのコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "6833388005540832",
  • "userID": "4098494030324145",
  • "3DDatasetID": "4811188005240832",
  • "inputFilePath": "dummy.appspot.com/3ddataset/4098494030324145/4811188005240832",
  • "outputFilePath": "dummy.appspot.com/3ddataset/4098494030324145/4811188005240832/output",
  • "error": "",
  • "startAt": "2017-09-04T05:56:10Z",
  • "finishAt": "2017-09-04T05:57:10Z",
  • "options": [
    ],
  • "status": "queued"
}

Retrieve Mapray Scene Data

mapray scene フォーマットのJSONを取得する。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3ddatasets_ids
required
string
query Parameters
3ddatasets_ids
required
integer
Example: 3ddatasets_ids=5106328150212608,5665678182842368

取得する3DdatasetIDの配列（カンマ区切り、要素数は1以上）

Responses

Response samples

Content type
application/json
{}

List Blob Files

3ddatasetIDに紐づく全てのblobfileのパスとblobfile IDを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "/main/main.gltf": "5171376604315648",
  • "/texture/image0.jpg": "5646954843340800",
  • "/texture/image1.jpg": "5676392851177472"
}

Retrieve Blob File

アップロードしたファイルをダウンロードします。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
3DdatasetID
required
string

指定する3DdatasetのID。

path
required
string

指定するファイルパス。

Responses

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

PC Datasets V2

Mapray Point Cloud Dataset API (2.0.0)

Mapray Point Cloud Dataset API は３次元地理空間の点群データの管理機能を提供します。

PC Datasetは3次元の点群データを意味します。

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

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

エラー一覧

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

List PC Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[]

Create PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
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/ で示されるコード。

object

ローカル座標の原点（sridを指定しない場合に必要）

object

点群の回転（sridを指定しない場合に必要）

scale
number
Default: 1

点群のスケール（sridを指定しない場合に必要）

xyz_type
integer [ 1 .. 8 ]

xyzフォーマットの種類番号。入力ファイルがxyz形式の場合に必要。（1:XYZ, 2:XYZRGB, 3:XYZIRGB, 4:XYZI, 5:XYZNxNyNzRGB, 6:XYZNxNyNzIRG, 7:XYZRGBNxNyNz, 8:XYZIRGBNxNyNz）

object

keyがコンバートオプションのMap

Array of objects (attributions)
src_file_type
string
Enum: "e57" "las" "laz" "ply" "pts" "ptx" "xyz"

コンバート前のデータフォーマット

dst_file_type
string
Default: "raw"
Value: "raw"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Count PC Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Response samples

Content type
application/json
{}

Update PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Delete PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

Request Body schema: application/json
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/ で示されるコード。

object

ローカル座標の原点（sridを指定しない場合に必要）

object

点群の回転（sridを指定しない場合に必要）

scale
number
Default: 1

点群のスケール（sridを指定しない場合に必要）

xyz_type
integer [ 1 .. 8 ]

xyzフォーマットの種類番号。入力ファイルがxyz形式の場合に必要。（1:XYZ, 2:XYZRGB, 3:XYZIRGB, 4:XYZI, 5:XYZNxNyNzRGB, 6:XYZNxNyNzIRG, 7:XYZRGBNxNyNz, 8:XYZIRGBNxNyNz）

object

keyがコンバートオプションのMap

Array of objects (attributions)
src_file_type
string
Enum: "e57" "las" "laz" "ply" "pts" "ptx" "xyz"

コンバート前のデータフォーマット

dst_file_type
string
Default: "raw"
Value: "raw"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Create Upload URL

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

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

指定するPCdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Retrieve PC Dataset Convert Status

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "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": [
    ],
  • "status": "ready"
}

Download PC Dataset source file

指定したPC datasetのソースファイルをダウンロードするためのURLにリダイレクトします。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
PCdatasetID
required
string

指定するPCdatasetのID。

path/to/file
required
string

指定するファイルパス。

Responses

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

B3D Datasets V2

Mapray Building 3D Dataset API (2.0.0)

Mapray Building 3D Dataset API は３次元地理空間の建物3Dデータの管理機能を提供します。

Building 3D Datasetは3次元の建物3Dデータを意味します。

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

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

エラー一覧

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

List B3D Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
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
Default: "gml"
Value: "gml"

コンバート前のデータフォーマット

dst_file_type
string
Default: "b3d"
Value: "b3d"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Count B3D Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Update B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
B3DdatasetID
required
string

指定するB3DdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Delete B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
B3DdatasetID
required
string

指定するB3DdatasetのID。

Request Body schema: application/json
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
Default: "gml"
Value: "gml"

コンバート前のデータフォーマット

dst_file_type
string
Default: "b3d"
Value: "b3d"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Create Upload URL

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

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

指定するB3DdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Retrieve B3D Dataset Convert Status

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "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": [
    ],
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

Tileset Datasets V2

Mapray Tileset API (2.0.0)

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

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

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

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

エラー一覧

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

List Tilesets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Tileset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
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
Default: "geotiff"
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

Content type
application/json
{
  • "name": "tokyo",
  • "description": "test",
  • "srid": 2451,
  • "tiles": {
    },
  • "contour": {
    },
  • "heightmap": {
    },
  • "image": {
    },
  • "src_file_type": "geotiff",
  • "attributions": []
}

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": [],
  • "statuses": [
    ],
  • "info": {
    },
  • "name": "tokyo",
  • "description": "test",
  • "srid": 2451,
  • "tiles": {
    },
  • "contour": {
    },
  • "heightmap": {
    },
  • "image": {
    }
}

Count Tileset Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve Tileset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
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": [],
  • "statuses": [
    ],
  • "info": {
    },
  • "name": "tokyo",
  • "description": "test",
  • "srid": 2451,
  • "tiles": {
    },
  • "contour": {
    },
  • "heightmap": {
    },
  • "image": {
    }
}

Update Tileset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
TilesetDatasetID
required
string

指定するTilesetDatasetのID。

Request Body schema:
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
{}

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": [],
  • "statuses": [
    ],
  • "info": {
    },
  • "name": "tokyo",
  • "description": "test",
  • "srid": 2451,
  • "tiles": {
    },
  • "contour": {
    },
  • "heightmap": {
    },
  • "image": {
    }
}

Delete Tileset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
TilesetDatasetID
required
string

指定するTilesetDatasetのID。

Responses

Response samples

Content type
application/json
No sample

Reset Tileset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
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
Default: "geotiff"
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

Content type
application/json
{
  • "name": "tokyo",
  • "description": "test",
  • "srid": 2451,
  • "tiles": {
    },
  • "contour": {
    },
  • "heightmap": {
    },
  • "image": {
    },
  • "src_file_type": "geotiff",
  • "attributions": []
}

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": [],
  • "statuses": [
    ],
  • "info": {
    },
  • "name": "tokyo",
  • "description": "test",
  • "srid": 2451,
  • "tiles": {
    },
  • "contour": {
    },
  • "heightmap": {
    },
  • "image": {
    }
}

Create Upload URL

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

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

指定するTilesetDatasetのID。

Request Body schema: application/json
required
Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert Tileset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
TilesetDatasetID
required
string

指定するTilesetDatasetのID。

Request Body schema: application/json
types
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "types": [
    ]
}

List Tileset Dataset Convert Statuses

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
TilesetDatasetID
required
string

指定するTilesetDatasetのID。

Responses

Response samples

Content type
[]

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

Image Datasets V2

Mapray Image API (2.0.0)

Mapray Image API は画像データの管理機能を提供します。

Image Datasetは画像データを意味します。

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

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

エラー一覧

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

List Image Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Image Dataset

新しいImage Datasetを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
Array of objects (ImageFileFormats)

ファイル一覧。
サポートするフォーマットはPNG画像(.png)、JPEG画像(.jpg/.jpeg)、GIF画像(.gif)、BMP画像(.bmp)です。

Responses

Request samples

Content type
application/json
{
  • "name": "tokyo",
  • "description": "test",
  • "files": [
    ],
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "name": "tokyo",
  • "description": "test",
  • "files": [
    ],
  • "attributions": [],
  • "url": "https://api.mapray.com/image/4811188005240832/",
  • "created_at": "2023-01-01T00:00:00.871648747Z",
  • "updated_at": "2023-01-05T00:00:00.871648747Z",
  • "status": "",
  • "error": ""
}

Count Image Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve Image Dataset

指定したImage Datasetの情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
imagedatasetID
required
string

指定するImage DatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "name": "tokyo",
  • "description": "test",
  • "files": [
    ],
  • "attributions": [],
  • "url": "https://api.mapray.com/image/4811188005240832/",
  • "created_at": "2023-01-01T00:00:00.871648747Z",
  • "updated_at": "2023-01-05T00:00:00.871648747Z",
  • "status": "ready",
  • "error": ""
}

Update Image Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
imagedatasetID
required
string

指定するImage DatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "name": "tokyo",
  • "description": "test",
  • "files": [
    ],
  • "attributions": [],
  • "url": "https://api.mapray.com/image/4811188005240832/",
  • "created_at": "2023-01-01T00:00:00.871648747Z",
  • "updated_at": "2023-01-05T00:00:00.871648747Z",
  • "status": "",
  • "error": ""
}

Delete Image Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
imagedatasetID
required
string

指定するImage DatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset Image Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
imagedatasetID
required
string

指定するImage DatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
Array of objects (ImageFileFormats)

ファイル一覧。
サポートするフォーマットはPNG画像(.png)、JPEG画像(.jpg/.jpeg)、GIF画像(.gif)、BMP画像(.bmp)です。

Responses

Request samples

Content type
application/json
{
  • "name": "tokyo",
  • "description": "test",
  • "files": [
    ],
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "name": "tokyo",
  • "description": "test",
  • "files": [
    ],
  • "attributions": [],
  • "url": "https://api.mapray.com/image/4811188005240832/",
  • "created_at": "2023-01-01T00:00:00.871648747Z",
  • "updated_at": "2023-01-05T00:00:00.871648747Z",
  • "status": "",
  • "error": ""
}

Create Upload URL

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

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

指定するImage DatasetのID。

Request Body schema: application/json
required
Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
[]

Convert Image Dataset

Image Datasetのコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
imagedatasetID
required
string

指定するImage DatasetのID。

Responses

Retrieve Image Dataset Convert Status

指定したImage Datasetのコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
imagedatasetID
required
string

指定するImage DatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "6833388005240832",
  • "jobType": "",
  • "userID": "4098494030324145",
  • "3DDatasetID": "4811188005240832",
  • "inputFilePath": "dummy.appspot.com/imagedataset/4098494030324145/4811188005240832/input",
  • "outputFilePath": "dummy.appspot.com/imagedataset/4098494030324145/4811188005240832/output",
  • "error": "",
  • "startAt": "2017-09-04T05:56:10Z",
  • "finishAt": "2017-09-04T05:57:15Z",
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

Vectile Datasets V2

Mapray Vectile Dataset API (2.0.0)

Mapray Vectile Dataset APIは３次元地理空間のベクトルタイルデータの管理機能を提供します。

Vectile Datasetは3次元のベクトルタイルデータを意味します。

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

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

エラー一覧

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

List Vectile Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Vectile Dataset

新しいVectile Datasetを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
string <= 300 characters
Default: ""

説明

layer_name
string <= 100 characters

データを読み込むレイヤーの名前

min_zoom
number [ 0 .. 20 ]
Default: 0
max_zoom
number or null
Default: null

nullの場合は妥当な最大ズームレベルを推測します

Array of objects (fileformat)

ファイル一覧

Array of objects (attributions)
src_file_type
string
Enum: "json" "geojson" "kml"

コンバート前のデータフォーマット

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "example",
  • "layer_name": "layer",
  • "min_zoom": 4,
  • "max_zoom": 10,
  • "src_file_type": "json",
  • "files": [
    ],
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/vectile/4811188005240832/mvt/",
  • "name": "shinagawa_area",
  • "description": "example",
  • "layer_name": "layer",
  • "min_zoom": 4,
  • "max_zoom": 10,
  • "files": [
    ],
  • "status": "ready",
  • "error": "",
  • "attributions": []
}

Count Vectile Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve Vectile Dataset

指定したVectile Datasetの情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/vectile/4811188005240832/mvt/",
  • "name": "shinagawa_area",
  • "description": "example",
  • "layer_name": "layer",
  • "min_zoom": 4,
  • "max_zoom": 10,
  • "files": [
    ],
  • "status": "ready",
  • "error": "",
  • "attributions": []
}

Update Vectile Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/vectile/4811188005240832/mvt/",
  • "name": "shinagawa_area",
  • "description": "example",
  • "layer_name": "layer",
  • "min_zoom": 4,
  • "max_zoom": 10,
  • "files": [
    ],
  • "status": "ready",
  • "error": "",
  • "attributions": []
}

Delete Vectile Dataset

指定したVectile Datasetを削除します。 アップロードしたデータ全てを削除します。 一度削除したファイルは元に戻すことはできません。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset Vectile Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
string <= 300 characters
Default: ""

説明

layer_name
string <= 100 characters

データを読み込むレイヤーの名前

min_zoom
number [ 0 .. 20 ]
Default: 0
max_zoom
number or null
Default: null

nullの場合は妥当な最大ズームレベルを推測します

Array of objects (fileformat)

ファイル一覧

Array of objects (attributions)
src_file_type
string
Enum: "json" "geojson" "kml"

コンバート前のデータフォーマット

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "example",
  • "layer_name": "layer",
  • "min_zoom": 4,
  • "max_zoom": 10,
  • "src_file_type": "json",
  • "files": [
    ],
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/vectile/4811188005240832/mvt/",
  • "name": "shinagawa_area",
  • "description": "example",
  • "layer_name": "layer",
  • "min_zoom": 4,
  • "max_zoom": 10,
  • "files": [
    ],
  • "status": "ready",
  • "error": "",
  • "attributions": []
}

Create Upload URL

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

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

指定するVectile DatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert Vectile Dataset

Vectile Datasetのコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Responses

Retrieve Vectile Dataset Convert Status

指定したVectile Datasetのコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "6833388005240832",
  • "userID": "4098494030324145",
  • "3DDatasetID": "4811188005240832",
  • "inputFilePath": "dummy.appspot.com/vectiledataset/4098494030324145/4811188005240832/input",
  • "outputFilePath": "dummy.appspot.com/vectiledataset/4098494030324145/4811188005240832/output",
  • "error": "",
  • "startAt": "2017-09-04T05:56:10Z",
  • "finishAt": "2017-09-04T05:57:15Z",
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

DEM Datasets V2

Mapray DEM Dataset API (2.0.0)

Mapray DEM Dataset APIは地図形状タイルの管理機能を提供します。

DEM Datasetは地図形状タイルデータを意味します。

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

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

エラー一覧

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

List DEM Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token
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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create DEM Dataset

新しい DEM Dataset を作成します。

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
src_file_type
string
Default: "geotiff"

コンバート前のデータフォーマット。

dst_file_type
string
Default: "dem"

コンバート後のデータフォーマット。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Count DEM Datasets

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

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve DEM Dataset

指定した DEM Dataset の情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
DEMDatasetID
required
string

指定する DEM Dataset の ID。

Responses

Response samples

Content type
application/json
{
  • "id": 4811188005240832,
  • "owner_id": 4098494030324145,
  • "name": "tokyo",
  • "description": "tokyo area",
  • "attributions": [],
  • "srcformat": "geotiff",
  • "format": "dem",
  • "url": "https://api.mapray.com/demdataset/4811188005240832/",
  • "fileinfo": {
    },
  • "created_at": "2023-01-01T00:00:00.871648747Z",
  • "updated_at": "2023-01-05T00:00:00.871648747Z",
  • "status": "ready",
  • "error": "",
  • "is_public": false,
  • "public_url": ""
}

Update DEM Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
DEMDatasetID
required
string

指定する DEM Dataset の ID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": 4811188005240832,
  • "owner_id": 4098494030324145,
  • "name": "tokyo",
  • "description": "tokyo",
  • "attributions": [],
  • "srcformat": "geotiff",
  • "format": "dem",
  • "url": "https://api.mapray.com/demdataset/4811188005240832/",
  • "fileinfo": {
    },
  • "created_at": "2023-01-01T00:00:00.871648747Z",
  • "updated_at": "2023-01-10T00:00:00.871648747Z",
  • "status": "ready",
  • "error": "",
  • "is_public": false,
  • "public_url": ""
}

Delete DEM Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
DEMDatasetID
required
string

指定する DEM Dataset の ID。

Responses

Response samples

Content type
application/json
{ }

Reset DEM Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
DEMDatasetID
required
string

指定する DEM Dataset の ID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
src_file_type
string
Default: "geotiff"

コンバート前のデータフォーマット。

dst_file_type
string
Default: "dem"

コンバート後のデータフォーマット。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Create Upload URL

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

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

指定する DEM Dataset の ID。

Request Body schema: application/json
required
Array
filename
required
string

ファイル名。

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert DEM Dataset

DEM Dataset のコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
DEMDatasetID
required
string

指定する DEM Dataset の ID。

Responses

Retrieve DEM Dataset Convert Status

指定した DEM Dataset のコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
DEMDatasetID
required
string

指定する DEM Dataset の ID。

Responses

Response samples

Content type
application/json
{
  • "id": 6833388005240832,
  • "userID": 4098494030324145,
  • "3DDatasetID": 4811188005240832,
  • "inputFilePath": "dummy.appspot.com/demdataset/4098494030324145/4811188005240832/input",
  • "outputFilePath": "dummy.appspot.com/demdataset/4098494030324145/4811188005240832/output",
  • "options": null,
  • "startAt": "2023-01-05T00:00:00.871648747Z",
  • "finishAt": "2023-01-05T00:00:00.871648747Z",
  • "status": "ready",
  • "error": ""
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

Scene V2

Mapray Scene API

シーンの作成、取得、更新、削除及びシーンエンティティの追加、取得、更新、削除を行うAPIです。

エラー一覧

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

Get Scene

所属組織に紐づくシーンを全て取得する

Authorizations:
OAuthApi-KeyBearer-Token
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
[
  • {
    },
  • {
    }
]

Create Scene

新しいシーンを作成する

Authorizations:
OAuthApi-KeyBearer-Token
Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

シーン名

description
string [ 0 .. 300 ] characters

説明

x
number
Default: 0

x座標

y
number
Default: 0

y座標

z
number
Default: 0

z座標

Responses

Request samples

Content type
application/json
{
  • "name": "scene1",
  • "description": "test",
  • "x": 1.1,
  • "y": 2.2,
  • "z": 3.3
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "owner_id": "string",
  • "created_at": "string",
  • "updated_at": "string",
  • "entity_3d_id": [
    ],
  • "name": "string",
  • "description": "string",
  • "x": 0,
  • "y": 0,
  • "z": 0
}

Count Scene

所属組織に紐づくシーンの数を取得する

Authorizations:
OAuthApi-KeyBearer-Token

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve Scene

指定したシーンの情報を取得する

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

Responses

Response samples

Content type
application/json
{
  • "id": "24321567809871234",
  • "owner_id": "1234567890123456",
  • "created_at": "2021-01-01 00:00:00",
  • "updated_at": "2021-01-01 00:00:00",
  • "name": "scene1",
  • "description": "test",
  • "x": 1.1,
  • "y": 2.2,
  • "z": 3.3,
  • "entity_3d_id": [
    ]
}

Update Scene

指定したシーン情報を更新する

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

シーン名

description
string [ 0 .. 300 ] characters

説明

x
number
Default: 0

x座標

y
number
Default: 0

y座標

z
number
Default: 0

z座標

Responses

Request samples

Content type
application/json
{
  • "name": "scene1",
  • "description": "test",
  • "x": 1.1,
  • "y": 2.2,
  • "z": 3.3
}

Response samples

Content type
application/json
{
  • "id": "4321567809871234",
  • "owner_id": "1234567890123456",
  • "created_at": "2021-01-01 00:00:00",
  • "updated_at": "2021-01-05 00:00:00",
  • "name": "scene1",
  • "description": "test",
  • "x": 1.1,
  • "y": 2.2,
  • "z": 3.3,
  • "entity_3d_id": [
    ]
}

Delete Scene

指定したシーンを削除する

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

Responses

Response samples

Content type
application/json
{ }

Retrieve Mapray SceneFile Dataset

指定したシーンのmapray sceneフォーマットのJSONを取得する。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

Responses

Response samples

Content type
application/json
{}

Get SceneEntity 3dDatasets

指定したシーンに紐づく3Dエンティティ情報を全て取得する

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

query Parameters
page
integer >= 1
Default: 1

1ページの要素数がlimitの場合のページ番号。

limit
integer [ 1 .. 100 ]
Default: 5

1ページの要素数。

sort
string
Default: "updatedAt"
Enum: "3ddataset_id" "name" "updatedAt"

ソートを行うプロパティ。

direction
string
Default: "desc"
Enum: "asc" "desc"

ソート方向。

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Add SceneEntity 3dDataset

指定したシーンの3Dエンティティを追加する(複数エンティティ追加可)

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

Request Body schema: application/json
required
Array
3ddataset_id
required
string

3ddatasetID

name
required
string [ 1 .. 128 ] characters

シーンエンティティ名

x
number
Default: 0

x座標

y
number
Default: 0

y座標

z
number
Default: 0

z座標

roll
number
Default: 0

x軸の回転

tilt
number
Default: 0

y軸の回転

heading
number
Default: 0

z軸の回転

sx
number
Default: 1

x軸の縮尺

sy
number
Default: 1

y軸の縮尺

sz
number
Default: 1

z軸の縮尺

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Update SceneEntity 3dDataset

指定したシーンの3Dエンティティを更新する(複数エンティティ更新可)

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

Request Body schema: application/json
required
Array
id
required
string

シーンエンティティID

name
required
string [ 1 .. 128 ] characters

シーンエンティティ名

x
number
Default: 0

x座標

y
number
Default: 0

y座標

z
number
Default: 0

z座標

roll
number
Default: 0

x軸の回転

tilt
number
Default: 0

y軸の回転

heading
number
Default: 0

z軸の回転

sx
number
Default: 1

x軸の縮尺

sy
number
Default: 1

y軸の縮尺

sz
number
Default: 1

z軸の縮尺

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Retrieve SceneEntity 3dDataset

指定した3Dエンティティ情報を取得する

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

seid
required
string

シーンエンティティID。

Responses

Response samples

Content type
application/json
{
  • "id": "1234567890123456",
  • "scene_id": "6543210987654321",
  • "3ddataset_id": "4321567809871234",
  • "owner_id": "8877665544332211",
  • "name": "scenedata1",
  • "x": 1.1,
  • "y": 2.2,
  • "z": 3.3,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 1.1,
  • "sy": 2.2,
  • "sz": 3.3,
  • "created_at": "2021-01-01 00:00:00",
  • "updated_at": "2021-01-05 00:00:00"
}

Delete SceneEntity 3dDataset

指定したシーンの3Dエンティティを削除する

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
sid
required
string

シーンID。

seid
required
string

シーンエンティティID。

Responses

Response samples

Content type
application/json
{ }

Vectile

Mapray Vectile API

Mapray Vectile APIは３次元地理空間のベクトルタイルデータの取得機能を提供します。

Vectile は3次元のベクトルタイルデータを意味します。

エラー一覧

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

Get Vector Tiles

対象のベクトルタイルを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

z
required
string

ズームレベル

x
required
string

タイル座標のX値

yfile
required
string
Enum: ".mvt" ".pbf"

タイル座標のY値とベクトルタイルの拡張子

Responses

Get Vector Tiles Metadata

対象のベクトルタイルのメタデータを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Responses

Response samples

Content type
application/json
{
  • "vector_layers": [
    ]
}

Create Vector Tiles Style

対象のベクトルタイルのstyle.jsonを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Request Body schema: application/json
name
string

ファイル名

style
string

style.jsonの中身

Responses

Request samples

Content type
application/json
{
  • "name": "samplefile.json",
  • "style": "{\r\n \"layers\": [\r\n {\r\n \"id\": \"id_観光地名称\"\r\n } \r\n ]\r\n}"
}

Response samples

Content type
application/json
"{\r\n \"layers\": [\r\n {\r\n \"id\": \"id_観光地名称\"\r\n } \r\n ]\r\n}"

Get Vector Tiles Styles

対象のベクトルタイルに紐づくstyle.jsonを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Retrieve Vector Tiles Style

対象のstyle.jsonを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

filename
required
string

指定するファイル名。

Responses

Response samples

Content type
application/json
{
  • "layers": [
    ]
}

Update Vector Tiles Style

対象のstyle.jsonを更新します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

filename
required
string

指定するファイル名。

Request Body schema: application/json

更新後のstyle.json

string

Responses

Request samples

Content type
application/json
{
  • "layers": [
    ]
}

Response samples

Content type
application/json
{
  • "layers": [
    ]
}

Delete Vector Tiles Style

対象のstyle.jsonを削除します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

filename
required
string

指定するファイル名。

Responses

Response samples

Content type
application/json
{ }

Rename Vector Tiles Style

style.jsonの名前を変更します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
VectileDatasetID
required
string

指定するVectile DatasetのID。

filename
required
string

指定するファイル名。

Request Body schema: application/json

名前変更後のファイル名

name
string

変更後のファイル名

Responses

Request samples

Content type
application/json
{
  • "name": "sample20230929.json"
}

Response samples

Content type
application/json
{ }

Organization

組織を管理するAPIです。

Get Organization

ユーザーの所属している組織リストを取得する。

Authorizations:
Bearer-Token
query Parameters
page
integer >= 1
Default: 1

1ページの要素数がlimitの場合のページ番号。

limit
integer [ 1 .. 100 ]
Default: 5

1ページの要素数。

sort
string
Default: "invitedAt"
Enum: "id" "invitedAt"

ソートを行うプロパティ。

direction
string
Default: "desc"
Enum: "asc" "desc"

ソート方向。

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Create Organization

新しい組織を作成する。

Authorizations:
Bearer-Token
Request Body schema: application/json
name
required
string

組織名

redirect_uri
Array of strings

認証後にリダイレクトするURL

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": 4321432143214321,
  • "name": "org4",
  • "is_default": false,
  • "created_at": "2021-01-01 20:21:14",
  • "token": "abcdefghijklmnopqrstuvwxyzABCD0123456789",
  • "redirect_uri": []
}

Retrieve Organization

特定の組織情報を取得する。

Authorizations:
Api-KeyBearer-Token
path Parameters
oid
required
string

対象組織ID

Responses

Response samples

Content type
application/json
{
  • "id": 4321567809871234,
  • "name": "org01",
  • "is_default": true,
  • "created_at": "2021-01-01 20:21:11",
  • "token": "abcdefghijklmnopqrstuvwxyzABCD0123456789",
  • "redirect_uri": []
}

Update Organization

組織の名前、リダイレクトURLを変更する。

条件

  • 招待を受諾している
  • adminである
  • ユーザーに紐づいた組織でない
Authorizations:
Bearer-Token
path Parameters
oid
required
string

対象組織ID

Request Body schema: application/json
name
required
string

組織名

redirect_uri
Array of strings

認証後にリダイレクトするURL

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": 4321432143214321,
  • "name": "org1-update",
  • "is_default": false,
  • "created_at": "2021-01-01 20:21:14",
  • "token": "abcdefghijklmnopqrstuvwxyzABCD0123456789",
  • "redirect_uri": []
}

Delete Organization

組織に関する全情報を削除する。(組織、所属ユーザー、データセット、APIKey、AccessToken)

条件

  • 招待を受諾している
  • adminである
  • ユーザーに紐づいた組織でない
Authorizations:
Bearer-Token
path Parameters
oid
required
string

対象組織ID

Responses

Response samples

Content type
application/json
{ }

Organization Token

Organization token API は Organization、Dataset、Token の アクセストークンを作成、取得、更新、削除する API です。

List Organization tokens

対象組織IDに紐づくすべてのOrganization tokenを取得します。

Authorizations:
Api-KeyBearer-Token
path Parameters
oid
required
string

対象組織ID

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
[
  • {
    },
  • {
    }
]

Create Organization token

新しいOrganization tokenを作成します。

Authorizations:
Api-KeyBearer-Token
path Parameters
oid
required
string

対象組織ID

Request Body schema: application/json
name
required
string [ 2 .. 128 ] characters

名前

access_ip
required
Array of strings

アクセスを許可するIPアドレスの一覧 CIDR表記

scopes
required
Array of strings
Items Enum: "organization:read" "dataset:read" "dataset:create" "dataset:update" "dataset:delete" "token:read" "token:create" "token:update" "token:delete"

付与する権限の一覧

allowedDomains
Array of strings

アクセスを許可するドメインのリストです。 指定しない場合はすべてのドメインのアクセスを許可します。

Responses

Request samples

Content type
application/json
{
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 1234567890123456,
  • "oid": 9876543210987654,
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ],
  • "token": "abcdefghIJKLMNOPQRSTUvwxyz12345678901234",
  • "created_at": "2021-01-01T01:01:01.0000001Z",
  • "updated_at": "2021-01-01T01:01:01.0000001Z"
}

Retrieve Organization token

対象組織IDに紐づく一意のOrganization tokenを取得します。

Authorizations:
Api-KeyBearer-Token
path Parameters
oid
required
string

対象組織ID

tid
required
string

トークンID

Responses

Response samples

Content type
application/json
{
  • "id": 1234567890123456,
  • "oid": 9876543210987654,
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ],
  • "created_at": "2021-01-01T01:01:01.0000001Z",
  • "updated_at": "2021-01-01T01:01:01.0000001Z"
}

Update Organization token

対象組織IDに紐づく一意のOrganization tokenを更新します。

Authorizations:
Api-KeyBearer-Token
path Parameters
oid
required
string

対象組織ID

tid
required
string

トークンID

Request Body schema: application/json
name
required
string [ 2 .. 128 ] characters

名前

access_ip
required
Array of strings

アクセスを許可するIPアドレスの一覧 CIDR表記

scopes
required
Array of strings
Items Enum: "organization:read" "dataset:read" "dataset:create" "dataset:update" "dataset:delete" "token:read" "token:create" "token:update" "token:delete"

付与する権限の一覧

allowedDomains
Array of strings

アクセスを許可するドメインのリストです。 指定しない場合はすべてのドメインのアクセスを許可します。

Responses

Request samples

Content type
application/json
{
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 1234567890123456,
  • "oid": 9876543210987654,
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ],
  • "created_at": "2021-01-01T01:01:01.0000001Z",
  • "updated_at": "2021-01-01T01:01:01.0000001Z"
}

Delete Organization token

対象組織IDに紐づく一意のOrganization tokenを削除します。

Authorizations:
Api-KeyBearer-Token
path Parameters
oid
required
string

対象組織ID

tid
required
string

トークンID

Responses

Response samples

Content type
application/json
{ }

User

User API は ユーザーのアカウント情報を取得する API です。

Get Account Profile

認証情報から得たユーザーIDに紐づくアカウント情報を取得します。

Authorizations:
Bearer-Token

Responses

Response samples

Content type
application/json
{
  • "id": "1234567890123456",
  • "email": "test@test.co.jp",
  • "name": "test1",
  • "createdAt": "2024-01-01T00:00:00",
  • "updatedAt": "2024-01-01T00:00:00"
}

User Token

User token API は User、Organization の アクセストークンを作成、取得、更新、削除する API です。

List User tokens

ユーザーIDに紐づくすべてのUser tokenを取得します。

Authorizations:
Api-KeyBearer-Token
path Parameters
uid
required
string

ユーザーID

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
[
  • {
    },
  • {
    }
]

Create User token

新しいUser tokenを作成します。

Authorizations:
Api-KeyBearer-Token
path Parameters
uid
required
string

ユーザーID

Request Body schema: application/json
name
required
string [ 2 .. 128 ] characters

名前

access_ip
required
Array of strings

アクセスを許可するIPアドレスの一覧 CIDR表記

scopes
required
Array of strings
Items Enum: "user:read" "organization:read" "organization:create" "organization:update" "organization:delete"

付与する権限の一覧

allowedDomains
Array of strings

アクセスを許可するドメインのリストです。 指定しない場合はすべてのドメインのアクセスを許可します。

Responses

Request samples

Content type
application/json
{
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 1234567890123456,
  • "name": "token1",
  • "uid": 9876543210987654,
  • "token": "abcdefghIJKLMNOPQRSTUvwxyz12345678901234",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ],
  • "created_at": "2021-01-01T01:01:01.0000001Z",
  • "updated_at": "2021-01-01T01:01:01.0000001Z"
}

Retrieve User token

ユーザーIDに紐づく一意のUser tokenを取得します。

Authorizations:
Api-KeyBearer-Token
path Parameters
uid
required
string

ユーザーID

tid
required
string

トークンID

Responses

Response samples

Content type
application/json
{
  • "id": 1234567890123456,
  • "name": "token1",
  • "uid": 9876543210987654,
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ],
  • "created_at": "2021-01-01T01:01:01.0000001Z",
  • "updated_at": "2021-01-01T01:01:01.0000001Z"
}

Update User token

ユーザーIDに紐づく一意のUser tokenを更新します。

Authorizations:
Api-KeyBearer-Token
path Parameters
uid
required
string

ユーザーID

tid
required
string

トークンID

Request Body schema: application/json
name
required
string [ 2 .. 128 ] characters

名前

access_ip
required
Array of strings

アクセスを許可するIPアドレスの一覧 CIDR表記

scopes
required
Array of strings
Items Enum: "user:read" "organization:read" "organization:create" "organization:update" "organization:delete"

付与する権限の一覧

allowedDomains
Array of strings

アクセスを許可するドメインのリストです。 指定しない場合はすべてのドメインのアクセスを許可します。

Responses

Request samples

Content type
application/json
{
  • "name": "token1",
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 1234567890123456,
  • "name": "token1",
  • "uid": 9876543210987654,
  • "access_ip": [
    ],
  • "scopes": [
    ],
  • "allowedDomains": [
    ],
  • "created_at": "2021-01-01T01:01:01.0000001Z",
  • "updated_at": "2021-01-01T01:01:01.0000001Z"
}

Delete User token

ユーザーIDに紐づく一意のUser tokenを削除します。

Authorizations:
Api-KeyBearer-Token
path Parameters
uid
required
string

ユーザーID

tid
required
string

トークンID

Responses

Response samples

Content type
application/json
{ }

OAuth

クライアントとMapray Cloud間のOAuth2.0に関連するAPI群です。

Authorization Endpoint

Issue authorization code.

Request Body schema: application/x-www-form-urlencoded
response_type
required
string
Value: "code"
client_id
required
string

ID of the organization.

redirect_uri
required
string

URI to redirect after authentication.

code_challenge
required
string

"code_verifier" calculated with SHA256 and encoded with Base64.

code_challenge_method
required
string
Value: "S256"
state
required
string

Unique string for each request for CSRF countermeasures.

Responses

Request samples

Content type
application/x-www-form-urlencoded
response_type=code&client_id=9876543210123456&redirect_uri=https%3A%2F%2Fclient.com%2Fcallback&code_challenge=OWY4NmQwODE4ODRjN2Q2NTlhMmZlYWEwYzU1YWQwMTVhM2JmNGYxYjJiMGI4MjJjZDE1ZDZjMTViMGYwMGEwOA%3D%3D&code_challenge_method=S256&state=abcde12345

Token Endpoint

Issue a new access token.

Request Body schema: application/x-www-form-urlencoded
client_id
required
string

ID of the organization.

client_secret
string

Client token string of organization.

grant_type
required
string
Enum: "authorization_code" "client_credentials" "refresh_token"
code
string

Authorization code. Required for authorization_code.

redirect_uri
string

Same as the URL sent by the authorization endpoint. Required for authorization_code.

code_verifier
string

Uncalculated value of "code_challenge". Required for authorization_code.

refresh_token
string

Refresh token string. Required for refresh_token.

Responses

Request samples

Content type
application/x-www-form-urlencoded
Example
client_id=9876543210123456&grant_type=authorization_code&code=HIJKLMNOPQRSTUVWXYZ0123456789abcd&redirect_uri=https%3A%2F%2Fclient.com%2Fcallback&code_verifier=test

Response samples

Content type
application/json
Example
{
  • "access_token": "abcdefghijklmnopqrstuvwxyzABCD0123456789",
  • "token_type": "bearer",
  • "expires_in": 3600,
  • "refresh_token": "OPQRSTUVWXYZ0123456789abcd"
}

Introspect Token

Ask if the access token is active.

Request Body schema: application/x-www-form-urlencoded
client_id
required
string

id of the organization

client_secret
required
string

client token string of organization

token
required
string

Access token string or refresh token string to introspect.

Responses

Request samples

Content type
application/x-www-form-urlencoded
client_id=9876543210123456&client_secret=ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcd&token=abcdefghijklmnopqrstuvwxyzABCD0123456789

Response samples

Content type
application/json
Example
{
  • "active": true,
  • "scope": [
    ],
  • "client_id": "9876543210123456",
  • "token_type": "bearer",
  • "exp": 1617249600,
  • "iat": 1617246000,
  • "iss": "https://api.mapray.com/"
}

Revoke Token

Revoke access token.

Request Body schema: application/x-www-form-urlencoded
client_id
required
string

id of the organization

client_secret
required
string

client token string of organization

token
required
string

Access token string or refresh token string to revoke.

Responses

Request samples

Content type
application/x-www-form-urlencoded
client_id=9876543210123456&client_secret=ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcd&token=abcdefghijklmnopqrstuvwxyzABCD0123456789

Response samples

Content type
application/json
{ }

Weather

Mapray Weather API 天気情報のラスター地理空間情報データを提供します。

天気情報一覧

Layer name データソース 説明 取得間隔 予報間隔
cloudcover https://registry.opendata.aws/noaa-gfs-bdp-pds/ 全世界の雲量データ 6時間毎 3時間おき336時間後まで

エラー一覧

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

Show layer info

対象天気情報の詳細を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
layer
required
string

対象とする天気情報のキー

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get weather tile

対象天気情報のタイルを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
layer
required
string

対象とする天気情報のキー

time
required
integer

時刻

z
required
integer

ズームレベル

x
required
integer

x座標

y
required
integer

y座標

format
required
string

タイルのフォーマット

Responses

2D Datasets V1

Mapray Dataset API (1.0.0)

Mapray Datasets API はGeoJSONフォーマットを基本とした地図データの管理機能を提供します。

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

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

エラー一覧

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

List Datasets

userIDに紐づくdatasetリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Dataset

datasetを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

新しいデータを生成したいターゲットのユーザーID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
required
string [ 0 .. 300 ] characters
Default: ""

説明

src_file_type
string
Default: "geojson"
Enum: "json" "geojson" "kml" "gpx" "shp"

コンバート前のデータフォーマット

dst_file_type
string
Default: "geojson"
Value: "geojson"

コンバート後のデータフォーマット

srid
required
number (srid)
Default: 4326
Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 3097 3098 3099 3100 3101 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 4326 32651 32652 32653 32654 32655 32656

空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。

geoid
required
string
Enum: "EGM96_15" "JGD2011" "ELLIPSOID"

使用しているジオイドモデル

Array of objects (attributions)

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset",
  • "description": "example",
  • "bounds": [
    ],
  • "features": [
    ],
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-03-11T11:09:17.855Z",
  • "status": "ready",
  • "attributions": []
}

Count Datasets

userIDに紐づくdatasetの数を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset",
  • "description": "example",
  • "bounds": [
    ],
  • "features": [
    ],
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-03-11T11:09:17.855Z",
  • "status": "ready",
  • "attributions": []
}

Update Dataset

Request bodyで指定した内容にDatasetを更新します。

※部分更新はできません

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset update",
  • "description": "example update",
  • "bounds": [
    ],
  • "features": [
    ],
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-04-08T18:35:02.322Z",
  • "status": "ready",
  • "attributions": []
}

Reset Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
required
string [ 0 .. 300 ] characters
Default: ""

説明

src_file_type
string
Default: "geojson"
Enum: "json" "geojson" "kml" "gpx" "shp"

コンバート前のデータフォーマット

dst_file_type
string
Default: "geojson"
Value: "geojson"

コンバート後のデータフォーマット

srid
required
number (srid)
Default: 4326
Enum: 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 3097 3098 3099 3100 3101 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 4326 32651 32652 32653 32654 32655 32656

空間参照系識別コード(EPSGコード)。http://www.epsg-registry.org/ で示されるコード。

geoid
required
string
Enum: "EGM96_15" "JGD2011" "ELLIPSOID"

使用しているジオイドモデル

Array of objects (attributions)

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "3843949342039493",
  • "owner_id": "5884034982304942",
  • "name": "2D dataset",
  • "description": "example",
  • "bounds": null,
  • "features": null,
  • "created_at": "2019-03-11T11:09:17.855Z",
  • "updated_at": "2019-03-11T11:09:17.855Z",
  • "status": "before_queued",
  • "attributions": []
}

Delete Dataset

指定したdatasetを削除します。

featuresも同時に削除されます。

一度削除したファイルは元に戻すことはできません。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Create Upload URL

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

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

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
[]

Get Dataset File List

指定したdatasetのファイル一覧情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
[
  • "test.kml",
  • "test.gpx"
]

List Features

datasetIDに紐づくfeaturesのリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Insert Feature

GeoJSONのfeatureをdatasetに追加します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json

GeoJSON featureを指定します。

1つのfeatureにつき1MBの上限があり、その他のパラメータで300B程度あらかじめ使用されます。

id
string
geometrty
object
properties
object
object

Responses

Request samples

Content type
application/json
{
  • "id": "5100199366098944",
  • "geometry": {
    },
  • "properties": {
    },
  • "mapray": {
    }
}

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    },
  • "id": "geo json id",
  • "mapray": {
    }
}

Insert MultiFeatures

GeoJSONのfeatureをdatasetに追加します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Request Body schema: application/json
required

GeoJSON featureを指定します。

1つのfeatureにつき1MBの上限があり、その他のパラメータで300B程度あらかじめ使用されます。

Array
id
string
geometrty
object
properties
object
object

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Update Feature

Featureを更新します。 Request Bodyで指定した内容に置き換わります。 （部分更新はできません）

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

maprayFeatureID
required
string

指定するfeatureのID。

Request Body schema: application/json

GeoJSON featureを指定します。 1つのfeatureにつき1MBの上限があり、その他のパラメータで300B程度あらかじめ使用されます。

id
string
geometrty
object
properties
object
object

Responses

Request samples

Content type
application/json
{
  • "id": "62707111317995529",
  • "geometry": {
    },
  • "properties": {
    },
  • "mapray": {
    }
}

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    },
  • "id": "geo json id",
  • "mapray": {
    }
}

Retrieve Feature

指定したfeatureを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

maprayFeatureID
required
string

指定するfeatureのID。

Responses

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    },
  • "id": "geo json id",
  • "mapray": {
    }
}

Delete Feature

指定したfeatureを削除します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

maprayFeatureID
required
string

指定するfeatureのID。

Responses

Response samples

Content type
application/json
{ }

Convert 2D Dataset

2D datasetのコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Responses

Retrieve 2D Dataset Convert Status

指定した2D datasetのコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

datasetID
required
string

指定するdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "6833388005240832",
  • "jobType": "",
  • "userID": "4098494030324145",
  • "3DDatasetID": "4811188005240832",
  • "inputFilePath": "dummy.appspot.com/dataset/4098494030324145/4811188005240832/input",
  • "outputFilePath": "dummy.appspot.com/dataset/4098494030324145/4811188005240832/output",
  • "error": "",
  • "startAt": "2017-09-04T05:56:10Z",
  • "finishAt": "2017-09-04T05:57:15Z",
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

3D Datasets V1

Mapray 3D Dataset API (1.0.0)

Mapray 3D Dataset API は３次元地理空間情報データの管理機能を提供します。

3D datasetは3次元データを意味しており、3D datasetオブジェクトはmaprayJSで利用されるmaprayシーンファイルに相当します。

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

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

エラー一覧

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

List 3D Datasets

userIDに紐づく3D datasetリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create 3D Dataset

新しい3D datasetを作成します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

新しいデータを生成したいターゲットのユーザーID。

Request Body schema: application/json
src_file_type
string
Enum: "glTF" "obj"

コンバート前のデータフォーマット

dst_file_type
string
Default: "glTF"

コンバート後のデータフォーマット

name
required
string [ 1 .. 128 ] characters

名前

description
string [ 0 .. 300 ] characters
Default: ""

説明

scene_id
string
Default: "0"

デフォルトで有効にしたいシーンID。glTFの場合は0以上の整数を文字列にしたもの

x
number
Default: 0

sridで指定した座標系での位置 x (座標系の定義による)

y
number
Default: 0

sridで指定した座標系での位置 y (座標系の定義による)

z
number
Default: 0

sridで指定した座標系での位置 z (座標系の定義による)

roll
number
Default: 0

sridで指定した座標系でのx軸の回転

tilt
number
Default: 0

sridで指定した座標系でのy軸の回転

heading
number
Default: 0

sridで指定した座標系でのz軸の回転

sx
number
Default: 1

sridで指定した座標系でのx軸の縮尺比率

sy
number
Default: 1

sridで指定した座標系でのy軸の縮尺比率

sz
number
Default: 1

sridで指定した座標系でのz軸の縮尺比率

offset_x
number
Default: 0

sridで指定した座標系でのoffset位置 x

offset_y
number
Default: 0

sridで指定した座標系でのoffset位置 y

offset_z
number
Default: 0

sridで指定した座標系でのoffset位置 z

offset_roll
number
Default: 0

sridで指定した座標系でoffset位置でのx軸の回転

offset_tilt
number
Default: 0

sridで指定した座標系でoffset位置でのy軸の回転

offset_heading
number
Default: 0

sridで指定した座標系でoffset位置でのz軸の回転

offset_sx
number
Default: 1

sridで指定した座標系でoffset位置でのx軸の縮尺比率

offset_sy
number
Default: 1

sridで指定した座標系でoffset位置でのy軸の縮尺比率

offset_sz
number
Default: 1

sridで指定した座標系でoffset位置でのz軸の縮尺比率

Array of objects (attributions)
path
string

関連する頂点データファイル、テクスチャなどのパスが記載されたメインとなるファイルへのパス。 1文字目は"/"で、また".."を含まない

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/ で示されるコード。

altitude_mode
string
Default: "absolute"
Enum: "absolute" "relative" "clamp"

sridで指定した座標系で高度の基準

object

keyがコンバートオプションのMap

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "src_file_type": "glTF",
  • "dst_file_type": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "3ddatasets/v1/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Count 3D Datasets

userIDに紐づく3D datasetの数を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "3ddatasets/v1/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Update 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前

description
string [ 0 .. 300 ] characters
Default: ""

説明

scene_id
string
Default: "0"

デフォルトで有効にしたいシーンID。glTFの場合は0以上の整数を文字列にしたもの

x
number
Default: 0

sridで指定した座標系での位置 x (座標系の定義による)

y
number
Default: 0

sridで指定した座標系での位置 y (座標系の定義による)

z
number
Default: 0

sridで指定した座標系での位置 z (座標系の定義による)

roll
number
Default: 0

sridで指定した座標系でのx軸の回転

tilt
number
Default: 0

sridで指定した座標系でのy軸の回転

heading
number
Default: 0

sridで指定した座標系でのz軸の回転

sx
number
Default: 1

sridで指定した座標系でのx軸の縮尺比率

sy
number
Default: 1

sridで指定した座標系でのy軸の縮尺比率

sz
number
Default: 1

sridで指定した座標系でのz軸の縮尺比率

offset_x
number
Default: 0

sridで指定した座標系でのoffset位置 x

offset_y
number
Default: 0

sridで指定した座標系でのoffset位置 y

offset_z
number
Default: 0

sridで指定した座標系でのoffset位置 z

offset_roll
number
Default: 0

sridで指定した座標系でoffset位置でのx軸の回転

offset_tilt
number
Default: 0

sridで指定した座標系でoffset位置でのy軸の回転

offset_heading
number
Default: 0

sridで指定した座標系でoffset位置でのz軸の回転

offset_sx
number
Default: 1

sridで指定した座標系でoffset位置でのx軸の縮尺比率

offset_sy
number
Default: 1

sridで指定した座標系でoffset位置でのy軸の縮尺比率

offset_sz
number
Default: 1

sridで指定した座標系でoffset位置でのz軸の縮尺比率

Array of objects (attributions)

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "test",
  • "scene_id": "0",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "3ddatasets/v1/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Delete 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset 3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Request Body schema: application/json
src_file_type
string
Enum: "glTF" "obj"

コンバート前のデータフォーマット

dst_file_type
string
Default: "glTF"

コンバート後のデータフォーマット

name
required
string [ 1 .. 128 ] characters

名前

description
string [ 0 .. 300 ] characters
Default: ""

説明

scene_id
string
Default: "0"

デフォルトで有効にしたいシーンID。glTFの場合は0以上の整数を文字列にしたもの

x
number
Default: 0

sridで指定した座標系での位置 x (座標系の定義による)

y
number
Default: 0

sridで指定した座標系での位置 y (座標系の定義による)

z
number
Default: 0

sridで指定した座標系での位置 z (座標系の定義による)

roll
number
Default: 0

sridで指定した座標系でのx軸の回転

tilt
number
Default: 0

sridで指定した座標系でのy軸の回転

heading
number
Default: 0

sridで指定した座標系でのz軸の回転

sx
number
Default: 1

sridで指定した座標系でのx軸の縮尺比率

sy
number
Default: 1

sridで指定した座標系でのy軸の縮尺比率

sz
number
Default: 1

sridで指定した座標系でのz軸の縮尺比率

offset_x
number
Default: 0

sridで指定した座標系でのoffset位置 x

offset_y
number
Default: 0

sridで指定した座標系でのoffset位置 y

offset_z
number
Default: 0

sridで指定した座標系でのoffset位置 z

offset_roll
number
Default: 0

sridで指定した座標系でoffset位置でのx軸の回転

offset_tilt
number
Default: 0

sridで指定した座標系でoffset位置でのy軸の回転

offset_heading
number
Default: 0

sridで指定した座標系でoffset位置でのz軸の回転

offset_sx
number
Default: 1

sridで指定した座標系でoffset位置でのx軸の縮尺比率

offset_sy
number
Default: 1

sridで指定した座標系でoffset位置でのy軸の縮尺比率

offset_sz
number
Default: 1

sridで指定した座標系でoffset位置でのz軸の縮尺比率

Array of objects (attributions)
path
string

関連する頂点データファイル、テクスチャなどのパスが記載されたメインとなるファイルへのパス。 1文字目は"/"で、また".."を含まない

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/ で示されるコード。

altitude_mode
string
Default: "absolute"
Enum: "absolute" "relative" "clamp"

sridで指定した座標系で高度の基準

object

keyがコンバートオプションのMap

Responses

Request samples

Content type
application/json
{
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "src_file_type": "glTF",
  • "dst_file_type": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "3ddatasets/v1/models/4098494030324145/4811188005240832/small.gltf",
  • "name": "shinagawa_area",
  • "description": "test",
  • "path": "/small.gltf",
  • "format": "glTF",
  • "scene_id": "0",
  • "srid": 4326,
  • "status": "ready",
  • "x": 123.456789,
  • "y": 34.5678901,
  • "z": 123.456,
  • "roll": 1.1,
  • "tilt": 2.2,
  • "heading": 3.3,
  • "sx": 4.4,
  • "sy": 5.5,
  • "sz": 6.6,
  • "offset_x": 7.7,
  • "offset_y": 8.8,
  • "offset_z": 9.9,
  • "offset_roll": 10,
  • "offset_tilt": 11.1,
  • "offset_heading": 22.2,
  • "offset_sx": 33.3,
  • "offset_sy": 44.4,
  • "offset_sz": 55.5,
  • "altitude_mode": "absolute",
  • "extensions": {
    },
  • "attributions": []
}

Create Upload URL

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

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

例: sampleディレクトリのファイルをアップロードする場合

  /home
  └── user
      └── sample
          ├── test.gltf
          └── texture
              └── test.png

ファイルフォーマットごとに注意点がありますが、 例えばglTFファイルはglTFにリンクされるbinファイル、テクスチャファイルへのパスが記述されますが、これらのパスはglTF本体からの相対パスが指定されている必要があります。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
[]

Convert 3D Dataset

3D datasetのコンバートを開始します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Retrieve 3D Dataset Convert Status

指定した3D datasetのコンバート情報を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "6833388005540832",
  • "userID": "4098494030324145",
  • "3DDatasetID": "4811188005240832",
  • "inputFilePath": "dummy.appspot.com/3ddataset/4098494030324145/4811188005240832",
  • "outputFilePath": "dummy.appspot.com/3ddataset/4098494030324145/4811188005240832/output",
  • "error": "",
  • "startAt": "2017-09-04T05:56:10Z",
  • "finishAt": "2017-09-04T05:57:10Z",
  • "options": [
    ],
  • "status": "queued"
}

Retrieve Mapray Scene Data

mapray scene フォーマットのJSONを取得する。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

query Parameters
3ddatasets_ids
required
integer
Example: 3ddatasets_ids=5106328150212608,5665678182842368

取得する3DdatasetIDの配列（カンマ区切り、要素数は1以上）

Responses

Response samples

Content type
application/json
{}

List Blob Files

3ddatasetIDに紐づく全てのblobfileのパスとblobfile IDを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "/main/main.gltf": "5171376604315648",
  • "/texture/image0.jpg": "5646954843340800",
  • "/texture/image1.jpg": "5676392851177472"
}

Retrieve Blob File

アップロードしたファイルをダウンロードします。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

3DdatasetID
required
string

指定する3DdatasetのID。

path
required
string

指定するファイルパス。

Responses

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

PC Datasets V1

Mapray Point Cloud Dataset API (1.0.0)

Mapray Point Cloud Dataset API は３次元地理空間の点群データの管理機能を提供します。

PC Datasetは3次元の点群データを意味します。

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

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

エラー一覧

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

List PC Datasets

userIDに紐づくPC datasetリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[]

Create PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

Request Body schema: application/json
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/ で示されるコード。

object

ローカル座標の原点（sridを指定しない場合に必要）

object

点群の回転（sridを指定しない場合に必要）

scale
number
Default: 1

点群のスケール（sridを指定しない場合に必要）

xyz_type
integer [ 1 .. 8 ]

xyzフォーマットの種類番号。入力ファイルがxyz形式の場合に必要。（1:XYZ, 2:XYZRGB, 3:XYZIRGB, 4:XYZI, 5:XYZNxNyNzRGB, 6:XYZNxNyNzIRG, 7:XYZRGBNxNyNz, 8:XYZIRGBNxNyNz）

object

keyがコンバートオプションのMap

Array of objects (attributions)
src_file_type
string
Enum: "e57" "las" "laz" "ply" "pts" "ptx" "xyz"

コンバート前のデータフォーマット

dst_file_type
string
Default: "raw"
Value: "raw"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Count PC Datasets

userIDに紐づくPC datasetの数を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Response samples

Content type
application/json
{}

Update PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Delete PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Request Body schema: application/json
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/ で示されるコード。

object

ローカル座標の原点（sridを指定しない場合に必要）

object

点群の回転（sridを指定しない場合に必要）

scale
number
Default: 1

点群のスケール（sridを指定しない場合に必要）

xyz_type
integer [ 1 .. 8 ]

xyzフォーマットの種類番号。入力ファイルがxyz形式の場合に必要。（1:XYZ, 2:XYZRGB, 3:XYZIRGB, 4:XYZI, 5:XYZNxNyNzRGB, 6:XYZNxNyNzIRG, 7:XYZRGBNxNyNz, 8:XYZIRGBNxNyNz）

object

keyがコンバートオプションのMap

Array of objects (attributions)
src_file_type
string
Enum: "e57" "las" "laz" "ply" "pts" "ptx" "xyz"

コンバート前のデータフォーマット

dst_file_type
string
Default: "raw"
Value: "raw"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{}

Create Upload URL

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

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

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert PC Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Retrieve PC Dataset Convert Status

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

PCdatasetID
required
string

指定するPCdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "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": [
    ],
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>

B3D Datasets V1

Mapray Building 3D Dataset API (1.0.0)

Mapray Building 3D Dataset API は３次元地理空間の建物3Dデータの管理機能を提供します。

Building 3D Datasetは3次元の建物3Dデータを意味します。

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

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

エラー一覧

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

List B3D Datasets

userIDに紐づくB3D datasetリストを取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

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"

ソート方向。

name
string

検索を行う名前。

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

新しいデータを生成したいターゲットのユーザーID。

Request Body schema: application/json
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
Default: "gml"
Value: "gml"

コンバート前のデータフォーマット

dst_file_type
string
Default: "b3d"
Value: "b3d"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Count B3D Datasets

userIDに紐づくB3D datasetの数を取得します。

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

Responses

Response samples

Content type
application/json
{
  • "count": 0
}

Retrieve B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Update B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Request Body schema: application/json
name
required
string [ 1 .. 128 ] characters

名前。

description
string [ 0 .. 300 ] characters
Default: ""

説明。

Array of objects (Attributions)
is_public
boolean
Default: false

公開するかどうかの値。

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-08T08:12:13Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Delete B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Response samples

Content type
application/json
{ }

Reset B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Request Body schema: application/json
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
Default: "gml"
Value: "gml"

コンバート前のデータフォーマット

dst_file_type
string
Default: "b3d"
Value: "b3d"

コンバート後のデータフォーマット

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "4811188005240832",
  • "owner_id": "4098494030324145",
  • "created_at": "2017-09-04T05:56:10Z",
  • "updated_at": "2017-09-04T05:56:10Z",
  • "url": "https://dummy.com/b3d/4811188005240832/",
  • "format": "b3d",
  • "name": "shinagawa_area",
  • "description": "test",
  • "srid": 4326,
  • "status": "ready",
  • "fileinfo": {
    },
  • "attributions": []
}

Create Upload URL

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

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

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Request Body schema: application/json
required

アップロードするファイル情報

Array
filename
required
string

ファイル名

content_type
required

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[]

Convert B3D Dataset

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Retrieve B3D Dataset Convert Status

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

Authorizations:
OAuthApi-KeyBearer-Token
path Parameters
userID
required
string

対象データが紐づいているユーザーID。

B3DdatasetID
required
string

指定するB3DdatasetのID。

Responses

Response samples

Content type
application/json
{
  • "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": [
    ],
  • "status": "ready"
}

Upload Data

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

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

Create Upload URLで取得したUpload URL

header Parameters
Content-Type
required
string

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

Request Body schema: application/octet-stream
object

アップロードするデータ

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: 2021-07-01T10:00:00+00:00</Details>
</Error>