Tile Ingest API

Create new tileset ingest

Added in v4.3.0
POST http://localhost:3650/api/v1/admin/tiles/ingest

Creates a new tileset ingest.

Request

Body

Content-Type Data
application/json

Responses

Code Content Description
200 application/json TileIngestDetail Object
400 application/json Errors Object
404 application/json Errors Object

Detail of the given tileset ingest

Added in v4.3.0
GET http://localhost:3650/api/v1/admin/tiles/ingest/{id}

Gets information about the given tileset ingest.

Request

Path Parameters

Parameters Type Description
id
string
Identifier of the ingesting tileset
Example: b4362feb-6573-451e-b707-cada462c37f7

Responses

Code Content Description
200 application/json TileItemDetail Object
400 application/json Errors Object
404 application/json Errors Object

Upload data to tileset ingest

Added in v4.3.0
PUT http://localhost:3650/api/v1/admin/tiles/ingest/{id}/upload

Uploads sent data to the given tileset ingest.

Request

Body

Content-Type Data
application/octet-stream
A binary file

Responses

Responses headers
Code Key Description
308 Range

Specifies the range of uploaded bytes

Responses schemas
Code Content Description
200

OK, file is completely uploaded

308

Part of the file data is uploaded

400 application/json Errors Object
404 application/json Errors Object

Process tileset ingest

Added in v4.3.0
POST http://localhost:3650/api/v1/admin/tiles/ingest/{id}/process

Processes the data of given tileset ingest and creates a tileset with given document_id

Request

Path Parameters

Parameters Type Description
id
string
Identifier of the ingesting tileset
Example: b4362feb-6573-451e-b707-cada462c37f7

Responses

Code Content Description
200 application/json TileItemDetail Object
400 application/json Errors Object
404 application/json Errors Object

TileIngestCreate Object

Property Type Description
filename
string
Tileset file name
Example: maptiler-osm.mbtiles
size
integer
Size of the uploading file
Example: 6930432

example


    {
  "filename": "maptiler-osm.mbtiles",
  "size": 6930432
}
  

TileIngestDetail Object

Tile ingest item

Property Type Description
id
string
Identifier of the tile ingest
Example: b4362feb-6573-451e-b707-cada462c37f7
document_id
string
Identifier of the ingesting tileset
Example: 86e2836d-d30e-4767-85f0-12a33bed2393
filename
string
Filename of the ingesting tileset
Example: maptiler-osm.mbtiles
size
integer
Size of the ingesting tileset
Example: 6930432
state
string
Current state of the ingest
Example: upload
Allowed values: upload uploading completed failed
upload_url
string
URL for uploading data
Example: http://localhost:3650/api/v1/admin/tiles/ingest/b4362feb-6573-451e-b707-cada462c37f7/upload
errors
Error

example


    {
  "id": "b4362feb-6573-451e-b707-cada462c37f7",
  "document_id": "86e2836d-d30e-4767-85f0-12a33bed2393",
  "filename": "maptiler-osm.mbtiles",
  "size": 6930432,
  "state": "upload",
  "upload_url": "http://localhost:3650/api/v1/admin/tiles/ingest/b4362feb-6573-451e-b707-cada462c37f7/upload",
  "errors": ""
}
  

Error Object

Error message

Property Type Description
message
string
Example: Error message

example


    {"message": "Error message"}
  

Errors Object

Property Type Description
errors
Error

TileItemDetail Object

Tile details

Property Type Description
id
string
Identifier of the tileset
Example: b142543e-ffa2-4994-acbc-825012e75a97
name
string
Name of the tileset
Example: maptiler-osm
title
string
Title of the tileset
Example: Maptiler OSM Data
fileName
string
File name
Example: maptiler-osm.mbtiles
published
boolean
Says whether the tileset is published
Example: true
type
string
Type of the data
Example: mbtiles
Allowed values: composite geopackage mbtiles postgis
tileType
string
File type of the data
Example: vector
Allowed values: raster terrain vector
urls
TileItemDetailUrls Object

example


    {
  "id": "b142543e-ffa2-4994-acbc-825012e75a97",
  "name": "maptiler-osm",
  "title": "Maptiler OSM Data",
  "fileName": "maptiler-osm.mbtiles",
  "published": true,
  "type": "mbtiles",
  "tileType": "vector",
  "urls": {
    "embeddable": "http://localhost:3650/api/tiles/maptiler-osm",
    "tilejson": "http://localhost:3650/api/tiles/maptiler-osm/tiles.json",
    "wmts": "http://localhost:3650/api/tiles/maptiler-osm/WMTSCapabilities.xml",
    "xyz": "http://localhost:3650/api/tiles/maptiler-osm/{z}/{x}/{y}"
  }
}
  

TileItemDetailUrls Object

Accessible URLs for the tileset

Property Type Description
embeddable
string
URL for embeddable viewer
Example: http://localhost:3650/api/tiles/maptiler-osm
tilejson
string
URL for tileJSON / layerJSON
Example: http://localhost:3650/api/tiles/maptiler-osm/tiles.json
wmts
string
URL for WMTS
Example: http://localhost:3650/api/tiles/maptiler-osm/WMTSCapabilities.xml
xyz
string
URL for XYZ
Example: http://localhost:3650/api/tiles/maptiler-osm/{z}/{x}/{y}

example


    {
  "embeddable": "http://localhost:3650/api/tiles/maptiler-osm",
  "tilejson": "http://localhost:3650/api/tiles/maptiler-osm/tiles.json",
  "wmts": "http://localhost:3650/api/tiles/maptiler-osm/WMTSCapabilities.xml",
  "xyz": "http://localhost:3650/api/tiles/maptiler-osm/{z}/{x}/{y}"
}
  

TileItemDetailUrls Object

Accessible URLs for the tileset

Property Type Description
embeddable
string
URL for embeddable viewer
Example: http://localhost:3650/api/tiles/maptiler-osm
tilejson
string
URL for tileJSON / layerJSON
Example: http://localhost:3650/api/tiles/maptiler-osm/tiles.json
wmts
string
URL for WMTS
Example: http://localhost:3650/api/tiles/maptiler-osm/WMTSCapabilities.xml
xyz
string
URL for XYZ
Example: http://localhost:3650/api/tiles/maptiler-osm/{z}/{x}/{y}

example


    {
  "embeddable": "http://localhost:3650/api/tiles/maptiler-osm",
  "tilejson": "http://localhost:3650/api/tiles/maptiler-osm/tiles.json",
  "wmts": "http://localhost:3650/api/tiles/maptiler-osm/WMTSCapabilities.xml",
  "xyz": "http://localhost:3650/api/tiles/maptiler-osm/{z}/{x}/{y}"
}