Appearance
Query Raster Publish URL API
API Information
- Request Path:
/metadata/query/raster/publishUrl - Request Method:
POST - Content-Type:
application/json
Request Headers
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | String | Yes | User authentication token |
| Content-Type | String | Yes | Must be set to application/json |
Request Body Structure
QueryRasterUrlReq Object
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
| metadataId | Long | Yes | Metadata ID | Must be valid metadata ID |
| protoc | Integer | Yes | Protocol type | Must be 2 |
| taskId | String | Yes | Task Id | TaskId |
Request Body Example
json
{
"metadataId": 12345,
"protoc": 2,
"taskId": "1992775676926095360"
}Response Body Structure
CommonResponse Object
| Field | Type | Description |
|---|---|---|
| code | Integer | Response status code |
| message | String | Response message |
| data | PublishTileResp.Data.Tile | Raster publish URL response |
PublishTileResp.Data.Tile Object
| Field | Type | Description |
|---|---|---|
| id | String | Tile ID |
| previewUrl | String | the Preview Image URL |
| protoc | Integer | Protocol type |
| bbox | List<Double> | Bounding box coordinates [minX, minY, maxX, maxY] |
| minZoom | Integer | Minimum zoom level |
| maxZoom | Integer | Maximum zoom level |
| baseUrl | String | COG Metadata XML Url |
| layerName | String | COG Layer |
| wmtsTileUrl | String | OGC Web Map Tile Service (WMTS) Url |
Response Examples
Success Response
json
{
"code": 200,
"message": "OK",
"data": {
"id": "2016814827073695744",
"previewUrl": "https://eo.origen.ae/domSliceResult/mosaicjson/preview?url=https://eo.origen.ae/gis_platform/eo-qa/neu_gis/1/cog/2016814827073695744/79fs9sxt",
"protoc": 2,
"bbox": [
54.329742,
24.50302,
54.41702,
24.552416
],
"minZoom": 15,
"maxZoom": 20,
"baseUrl": "https://eo.origen.ae/domSliceResult/mosaicjson/WMTSCapabilities.xml",
"layerName": "https://eo.origen.ae/gis_platform/eo-qa/neu_gis/1/cog/2016814827073695744/79fs9sxt",
"wmtsTileUrl": "https://eo.origen.ae/geoserver/cog_workspace_79fs9sxt_nvihwnn0/gwc/service/wmts?service=WMTS&version=1.0.0&request=GetTile&layer=cog_workspace_79fs9sxt_nvihwnn0:cog_79fs9sxt_nvihwnn0&format=image/png&tilematrixset=EPSG:4326&tilematrix={z}&tilerow={y}&tilecol={x}"
}
}Failure Response
json
{
"code": 404,
"message": "Published URL not found",
"data": null
}Error Code Description
| Error Code | Description |
|---|---|
| 200 | Success |
| 400 | Request parameter error |
| 401 | Unauthorized |
| 404 | Published URL not found |
| 500 | Server internal error |
Usage Instructions
- This API is used to query the published URL for raster data
- User authentication is required
- Metadata ID and protocol must be specified
- Returns the complete service URL for accessing the published data
Notes
- Metadata ID is required and must be a valid metadata ID
- Protocol must be one of the supported protocols (WMS, WMTS, WFS, WCS)
- Returns the actual service endpoint URL
- User authentication token must be included in request headers