Tech Maven Geospatial

Geospatial Cloud Serv - Tile Server        5

Configure Services        5

Discover Services        6

Index JSON Endpoint        6

Services URLs        7

Tile and File URLs        9

Other URLs        10

Upload File to Tile Server        11

Endpoint Detail        11

Open Layers Map        12

Endpoint Detail        12

Geospatial Cloud Serv - Vector Converter Publishing        14

API Links        14

API Endpoint Details        14

Request Method - Get        14

Request endpoint        14

Request Response        14

Company Services        15

Company Services API Endpoint Details        15

Request Method - Get        15

Request endpoint        15

Request Response        15

Upload File        16

Upload File API Endpoint Details        16

Request Method - Post        16

Request endpoint        16

Request Header - URL Parameter        16

Request Body - Form-data        16

Request Response        17

Download Uploaded File        18

Download File API Endpoint Details        18

Request Method - Get        18

Request endpoint        18

Request Header - URL Parameter        18

Request Response        18

Data Distribution        19

Data Distribution API Endpoint Details        19

Request Method - Get        19

Request endpoint        19

URL Parameters        19

Request Response        20

Vector Conversion        21

Supported Formats        21

Input Formats        21

Output Formats        21

Vector Converter API Endpoint Details        22

Request Method - Post        22

Request endpoint        22

Request Body - Form-data        23

Request Response        23

Note        24

Database to Vector Data (Query)        25

Supported Formats        25

Output Formats        25

Database to Vector Data API Endpoint Details        25

Request method - Post        25

Request endpoint        25

Request Body - Form-data        26

Example Request Body        27

Vector Data to Database (Append)        29

Input Formats        29

Vector Data to Database API Endpoint Details        29

Request method - Post        29

Request endpoint        29

Request Body - Form-data        29

Example Request Body        30

Geospatial Cloud Serv - Tile Conversion / Downloading        31

Front End Web Application        31

URL        31

Username        31

Password        31

Login Screen        32

Converter        32

APIs        33

Login        33

LOGIN API Endpoint Details        33

Request Method - POST        33

Request endpoint        33

Request Body - Form-data        33

Request Response        33

Tile Conversion - Vector/Raster        34

Supported Formats        34

Input Format(s)        34

Output Format(s)        34

TILE CONVERTER API Endpoint Details        35

Request Method - POST        35

Request endpoint        35

Request Header - Form-data        35

Request Body - Form-data        35

Request Response        37

Header        37

Body        37

Response        38

Tile Downloader - Vector/Raster        39

Supported Formats        39

Input Format(s)        39

Output Format(s)        39

TILE DOWNLOADER API Endpoint Details        40

Request Method - POST        40

Request endpoint        40

Request Header - Form-data        40

Request Body - Form-data        40

Request Response        42

Header        42

Body        42

Response        43

Tile Clipping - Vector/Raster        44

Supported Formats        44

Input Format(s)        44

Output Format(s)        44

TILE CLIPING API Endpoint Details        45

Request Method - POST        45

Request endpoint        45

Request Header - Form-data        45

Request Body - Form-data        45

Request Response        47

Header        47

Body        47

Response        48


Geospatial Cloud Serv - Tile Server

Tile Server is running on some port, for example it is running on 84 port with a domain and ssl enabled with the server.

Configure Services

You can configure the Tile Server AI using configure endpoint


Discover Services

View Services and URLs on the discover page

Index JSON Endpoint

For integration of Tile Server in other developmental projects, you can use this endpoint and use service URLs in to your application


Services URLs


Tile and File URLs


Other URLs


Upload File to Tile Server

Endpoint Detail

http://{ip}:{port}/view/upload-file

Select Type Mbtile/GPKG/StyleJSON/Other GIS Vector Files (kml, geojson, vector-features gpkg,  vector-tiles mbtiles, etc.)

When the File is uploaded, it will appear in the discover page.


Open Layers Map

Endpoint Detail

http://{ip}:{port}/map


Geospatial Cloud Serv - Vector Converter Publishing

API Links

Get the list of companies registered.

API Endpoint Details

Request Method - Get

Request endpoint

https://gismapserver.com/{company}/links 

Request Response


Company Services

Get the list of companies services (mbtiles/gpkgs) as tile URLs.

Company Services API Endpoint Details

Request Method - Get

Request endpoint

https://gismapserver.com/{company}/services 

Request Response


Upload File

Upload file on the server so that GO tile server can expose the tiles as z x y tiles.

Upload File API Endpoint Details

Request Method - Post

Request endpoint

https://gismapserver.com/upload/{type} 

Request Header - URL Parameter

Key

Value

type

Ie. mbtile, cog, files, 3dtiles, catlog, gpkg, styles, others

Request Body - Form-data

Key

Value

File

{file} - File to be uploaded on the server

Company

{string} - Company Name - TMG in this case

Request Response


Download Uploaded File

Users can download the uploaded file anytime with the API endpoint.

Download File API Endpoint Details

Request Method - Get

Request endpoint

https://gismapserver.com/download/{company}/{type}/{file} 

Request Header - URL Parameter

Key

Value

company

Company Name

type

Ie. mbtile, cog, files, 3dtiles, catlog, gpkg, styles, others

file

File Name

Request Response


Data Distribution

Users can get all files listed (data distribution) using the API Endpoint.

Data Distribution API Endpoint Details

Request Method - Get

Request endpoint

https://gismapserver.com/{company}/{type}/data_distribution 

URL Parameters

Key

Value

company

Company Name

type

Ie. mbtile, cog, files, 3dtiles, catlog, gpkg, styles, others

Request Response


Vector Conversion

Developed by Tech Maven Geospatial - Mubasher

The API converts to/from geo package (gpkg), shapefile (zip), vector mbtiles, geojson, kml, csv.

Supported Formats

Input Formats

Output Formats

Sr no

Format

Download Format

Key

1

ShapeFile

zip

shp

2

MapInfo

zip

mapinfo

3

File Geodatabase

zip

gdb

4

Geo Package

gpkg

gpkg

5

MBTILES

mbtiles

mbtiles

6

GeoJson

geojson

geojson

7

KML

kml

kml

8

Comma Separated File

csv

csv

9

AutoCAD

dxf

dxf

10

MicroStation

dgn

dgn

Note: You need to use the key of your desired output format in the API.

Vector Converter API Endpoint Details

Request Method - Post

Request endpoint

https://gismapserver.com/convert 

Request Body - Form-data

Key

Value

File

{file} gpkg/geojson/zip/csv/kml/mbtiles/dwg/dxf

See https://docs.google.com/document/d/1lwdu6HsHI-QAwKNR3xTvpXxec_KZFqeUuKF6Xo9ZjwI/edit#heading=h.ue1gelf6webk 

OutputFormat

gpkg/geojson/csv/kml/mbtiles/mapinfo/shp/gdb/dxf/dgn

See https://docs.google.com/document/d/1lwdu6HsHI-QAwKNR3xTvpXxec_KZFqeUuKF6Xo9ZjwI/edit#heading=h.o5kz3g5h14fz 

Name

{string}

Description

{string}

MinZoom

{int 0 - 19}

MaxZoom

{int 0 - 19}

Request Response

The file can be downloaded from the URL in the json response of the request

Note

If the OutputFormat is other than mbtiles you can simply send MinZoom 0 and MaxZoom 0. In case of mbtiles you need to provide valid MinZoom (0 - 19) and valid MaxZoom (0 - 19)


Database to Vector Data (Query)

Supported Formats

Output Formats

Sr no

Format

Download Format

Key

1

MBTILES

mbtiles

 MVT

2

Geo Package

gpkg

GPKG

3

GeoJSON

geojson

GeoJSON

4

Comma Separated Values

csv

CSV

Note: You need to use the key of your desired output format in the API.

Database to Vector Data API Endpoint Details

Request method - Post

Request endpoint

https://gismapserver.com/query   

Request Body - Form-data

Key

Value

MinX

{double}

MinY

{double}

MaxX

{double}

MaxY

{double}

OutputFormat

{string} - MVT/GPKG/GeoJSON/CSV

See https://docs.google.com/document/d/1lwdu6HsHI-QAwKNR3xTvpXxec_KZFqeUuKF6Xo9ZjwI/edit#heading=h.fzkxw2mzipdv 

Host

{string} - ip address of server

Port

{string} - port number of machine

UserName

{string} - username of the database owner

Password

{string} - password of the database

Database

{string} - name of the database

TableName

{string} - table name in which geometry exists

GeomertyColumn

{string} - name of the geometry column

Projection

{integer} - 4326/3857

Name

{string} - any string

Identifier

{string} - any string

Description

{string} - any string

MinZoom

{integer} - 0 to 19

MaxZoom

{integer} - 0 to 19

Example Request Body


Vector Data to Database (Append)

Input Formats

Vector Data to Database API Endpoint Details

Request method - Post

Request endpoint

https://gismapserver.com/append 

Request Body - Form-data

Key

Value

File

{file} - gpkg/geojson

See https://docs.google.com/document/d/1lwdu6HsHI-QAwKNR3xTvpXxec_KZFqeUuKF6Xo9ZjwI/edit#heading=h.14dcefd6tjyv 

Host - TMG/LTG Hosted API don’t need

{string} - any string - host ip of system

Port - TMG/LTG Hosted API don’t need

{string} - any string - port number of database

UserName - TMG/LTG Hosted API don’t need

{string} - any string - username of database

Password- TMG/LTG Hosted API don’t need

{string} - any string - password of database

Database

{string} - any string - database name

Schema (each company has their own Postgres SCHEMA)

TableName

{string} - any string - table name

Example Request Body


Geospatial Cloud Serv - Tile Conversion / Downloading

Front End Web Application

URL

http://geodataconverter.online:9090 

Username

admin

Password

admin@123


Login Screen

Converter

APIs

Login

The API endpoint to get an authentication key that will be valid for 1 hour and can be used in the conversion as Authentication Bearer Header.

LOGIN API Endpoint Details

Request Method - POST

Request endpoint

http://geodataconverter.online/api/esri/login 

Request Body - Form-data

Key

Value

username

{string}

password

{string}

timeout

{integer}

Request Response

The authKey object can be used for the key if the message is Login Successful.

Tile Conversion - Vector/Raster

The API endpoint converts raster/vector mbtiles into esri supported tpkx/vtpk.

Supported Formats

Input Format(s)

Output Format(s)

Sr no

Format

Download Format

Key

1

Raster Tile Package - TPKX

.tpkx

tpkx

2

Vector Tile Package - VTPK

.vtpk

vtpk

Note: You need to use the key of your desired output format in the API.


TILE CONVERTER API Endpoint Details

Request Method - POST

Request endpoint

http://geodataconverter.online/api/esri/convert   

Request Header - Form-data

Key

Value

Authorization

Bearer authKey

Request Body - Form-data

Key

Value

File

{file} mbtiles

See https://docs.google.com/document/d/1mAsFTVyX-JcaflsrkwEzn4_NkrTjfAyRMRYfRMphl54/edit#heading=h.wz26qxa8ypc6 

OutputFormat

{string} - tpkx/vtpk

See https://docs.google.com/document/d/1mAsFTVyX-JcaflsrkwEzn4_NkrTjfAyRMRYfRMphl54/edit#heading=h.8ope8e94cqah 

Format

{string} - Vector/Raster

Projection

{string} - 3857/3395/4326

ReverseRow

{string} - true/false


Request Response

The file can be downloaded from the URL in the json response of the request

Header

Body

Response

The converted file can be downloaded from fileURL object of request response.


Tile Downloader - Vector/Raster

The API endpoint downloads raster/vector mbtiles/gpkg into a specific bounding box with user defined spatial reference system SRS.

Supported Formats

Input Format(s)

Output Format(s)

Sr no

Format

Download Format

Key

1

MBTiles

.mbtiles

generate_mbtiles

2

Geo Package

.gpkg

generate_gpkg

Note: You need to use the key of your desired Function in the API.


TILE DOWNLOADER API Endpoint Details

Request Method - POST

Request endpoint

http://geodataconverter.online/api/esri/download   

Request Header - Form-data

Key

Value

Authorization

Bearer authKey

Request Body - Form-data

Key

Value

Template

{string} hosted layer url

See https://docs.google.com/document/d/1mAsFTVyX-JcaflsrkwEzn4_NkrTjfAyRMRYfRMphl54/edit#heading=h.wz26qxa8ypc6 

Function

{string} - generate_mbtiles/generate_gpkg

See https://docs.google.com/document/d/1mAsFTVyX-JcaflsrkwEzn4_NkrTjfAyRMRYfRMphl54/edit#heading=h.8ope8e94cqah 

Name

{string} - name of data

LayerName

{string} - layer name of data

Description

{string} - description about data

BoundingBox

{string} - minx,miny,maxx,maxy

InSRS

{string} - 3395/3857/4326

OutSRS

{string} - 3395/3857/4326

MinZoom

{integer} - 0/20

MaxZoom

{integer} - 0/20

GZip

{string} - true/false

Clipped

{string} - true/false


Request Response

The file can be downloaded from the URL in the json response of the request

Header

Body


Response

The converted file can be downloaded from fileURL object of request response.


Tile Clipping - Vector/Raster

The API endpoint clips raster/vector mbtiles/gpkg into a specific bounding box with user defined spatial reference system SRS.

Supported Formats

Input Format(s)

Output Format(s)

Sr no

Format

Download Format

Key

1

MBTiles

.mbtiles

clip_mbtiles

2

Geo Package

.gpkg

clip_gpkg

Note: You need to use the key of your desired Function in the API.


TILE CLIPING API Endpoint Details

Request Method - POST

Request endpoint

http://geodataconverter.online/api/esri/download   

Request Header - Form-data

Key

Value

Authorization

Bearer authKey

Request Body - Form-data

Key

Value

File

{file} Input file to be clipped

See https://docs.google.com/document/d/1mAsFTVyX-JcaflsrkwEzn4_NkrTjfAyRMRYfRMphl54/edit#heading=h.wz26qxa8ypc6 

Function

{string} - clip_mbtiles/clip_gpkg

See https://docs.google.com/document/d/1mAsFTVyX-JcaflsrkwEzn4_NkrTjfAyRMRYfRMphl54/edit#heading=h.8ope8e94cqah 

Name

{string} - name of data

LayerName

{string} - layer name of data

Description

{string} - description about data

BoundingBox

{string} - minx,miny,maxx,maxy

InSRS

{string} - 3395/3857/4326

OutSRS

{string} - 3395/3857/4326

MinZoom

{integer} - 0/20

MaxZoom

{integer} - 0/20

GZip

{string} - true/false

Clipped

{string} - true/false


Request Response

The file can be downloaded from the URL in the json response of the request

Header

Body


Response

The converted file can be downloaded from fileURL object of request response.

Cloud-Native Data Explorer

The API allows connection to cloud hosted files and catalogs. Catalogs can be queried to list all available datasets, or those that match a search parameter. Individual cloud hosted files, or all data files in a dataset can be queried for geometry data. The queries work for zipped files as well.

Supported Formats

Input Format(s)

Output Format(s)

Sr no

Format

Response Format

1

FlatGeobuf (.fgb)

.geojson

2

GeoPackage (.gpkg)

.geojson

3

GeoParquet (.parquet)

.geojson

4

ShapeFile (.shp)

.geojson

/catalog Endpoint Details

Request Method - GET

Request endpoint

https://geospatialcloudserv.net:94/catalog/

Request Parameters

Key

Value

catalog_url

URL to the catalog

catalog_type

Type of the catalog (OGC, CKAN, Socrata, Open Data Soft)

Request Response

List of all datasets in the catalog is returned.

Header

Params

Response

The datasets listed in the catalog are returned.

/catalog/search Endpoint Details

Request Method - GET

Request endpoint

https://geospatialcloudserv.net:94/catalog/search

Request Parameters

Key

Value

catalog_url

URL to the catalog

catalog_type

Type of the catalog (OGC, CKAN, Socrata, Open Data Soft)

keyword

Keyword to search for in the catalog

Request Response

Returns a list of datasets in the catalog that match the keyword filter.

Header

Params

Response

The datasets matching the keyword in the catalog are returned.

/queryCatalog Endpoint Details

Request Method - GET

Request endpoint

https://geospatialcloudserv.net:94/queryCatalog/

Request Parameters

Key

Value

catalog_url

URL to the catalog

catalog_type

Type of the catalog (OGC, CKAN, Socrata, Open Data Soft)

collection_id

Dataset ID from the catalog

bbox

Array of numbers: minx, miny, maxx, maxy

filter_param

Optional filter parameter for data files

Request Response

Returns geometry details in geojson format for all processable files in the dataset of the catalog.

Header

Params

Response

Geometry geojson of the processable files in the dataset is returned.

/query Endpoint Details

Request Method - GET

Request endpoint

https://geospatialcloudserv.net:94/query/

Request Parameters

Key

Value

data_url

URL to the data file

bbox

Array of numbers: minx, miny, maxx, maxy

filter_param

Optional filter parameter for defining layer to use for geopackage and shape data files

Request Response

Returns geometry details in geojson format for the data file, if possible.

Header

Params

Response

Geojson FeatureCollection of geometry data matching the bbox parameter is returned.