Retrieve GeoTIFF Metadata
When requested, the GeoTIFF landscape metadata returns information about the GeoTIFF including the origin, extent, resolution, projection and upload and deletion dates.
API Endpoint
API Endpoint
GET /model/landscapeMetadata/<GeoTIFF ID>
Example Request
curl -X GET "https://fmsf.firenet.gov/fmsfModelREST/model/landscapeMetadata/<GeoTIFF ID>" -H "accept: application/json" -H Authorization: Basic <basic64 encoded username:API key>"
Example Response
{"id": <GeoTIFF ID>, "resolution": 60, "numRows": 3671, "numColumns": 4205, "owner": "<Username>", "origin": "LANDFIRE", "pathname": "FMSF file path/<GeoTIFF ID>.zip", upperLeftLongitude": -120.652461, "upperLeftLatitude": 45.716327, "lowerLeftLongitude": -120.598052, "lowerLeftLatitude": 43.734833, "lowerRightLongitude": -117.466141, "lowerRightLatitude": 43.734837, "upperRightLongitude": -117.411741, "upperRightLatitude": 45.716331, "uploaded": "Apr 13, 2022", "deleted": false, "isLandscape": true, "projection": "PROJCS[\"North_American_1983_Albers\", GEOGCS[\"GCS_North_American_1983\", DATUM[\"D_North_American_1983\", SPHEROID[\"GRS_1980\", 6378137.0, 298.257222101], TOWGS84[0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0]], PRIMEM[\"Greenwich\", 0.0], UNIT[\"degree\", 0.017453292519943295], AXIS[\"Longitude\", EAST], AXIS[\"Latitude\", NORTH]], PROJECTION[\"Albers_Conic_Equal_Area\"], PARAMETER[\"central_meridian\", -119.03194999999997], PARAMETER[\"latitude_of_origin\", 44.73109999999999], PARAMETER[\"standard_parallel_1\", 43.7459], PARAMETER[\"false_easting\", 0.0], PARAMETER[\"false_northing\", 0.0], PARAMETER[\"standard_parallel_2\", 45.7163], UNIT[\"m\", 1.0], AXIS[\"x\", EAST], AXIS[\"y\", NORTH]]", "layers": "US_ELEV2020;US_SLPD2020;US_ASP2020;US_200F40_20;US_200CC_20;US_200CH_20;US_200CBH_20;US_200CBD_20"}
Request Body
|
Name |
Type |
Required |
Description |
|---|---|---|---|
|
Authorization |
String |
Required |
<Basic64 encoded username:API key> credentials of the User |
|
GeoTIFF ID |
Integer |
Required |
FMSF assigned <GeoTIFF ID> for the uploaded GeoTIFF |
Response Fields
Code 200 - OK
|
Name |
Type |
Description |
|---|---|---|
|
id |
Integer |
FMSF assigned <GeoTIFF ID> for the uploaded GeoTIFF |
|
resolution |
Integer |
Resolution of the GeoTIFF cells (meters) |
|
numRows |
Integer |
Number of rows in the GeoTIFF file |
|
numColumns |
Integer |
Number of columns in the GeoTIFF file |
|
owner |
String |
User who uploaded or generated the GeoTIFF |
|
origin |
String |
System creating the GeoTIFF* |
|
pathname |
String |
File path in the FMSF directory |
|
upperLeftLongitude |
Number (Float) |
Longitude of upper left corner of the GeoTIFF |
|
upperLeftLatitude |
Number (Float) |
Latitude of upper left corner of the GeoTIFF |
|
lowerLeftLongitude |
Number (Float) |
Longitude of lower left corner of the GeoTIFF |
|
lowerLeftLatitude |
Number (Float) |
Latitude of lower left corner of the GeoTIFF |
|
lowerRightLongitude |
Number (Float) |
Longitude of upper right corner of the GeoTIFF |
|
lowerRightLatitude |
Number (Float) |
Latitude of upper right corner of the GeoTIFF |
|
upperRightLongitude |
Number (Float) |
Longitude of lower right corner of the GeoTIFF |
|
upperRightLatitude |
Number (Float) |
Latitude of lower right corner of the GeoTIFF |
|
uploaded |
Date |
Date the GeoTIFF was uploaded or generated within the FMSF |
|
deleted |
Boolean |
Whether or not the GeoTIFF is still available to use. If TRUE, you will need to re-upload the GeoTIFF |
|
isLandscape |
Boolean |
If TRUE is an a 8-band GeoTIFF that can be used with the fire behavior models within the FMSF |
|
projection |
string |
Projection of the GeoTIFF |
*origin is only present when isLandscape is TRUE
Code 400 – The request was unacceptable
Invalid <GeoTIFF ID> provided
Code 401 – Unauthorized
Authorization info is missing or invalid
Code 500 – Server errors
Something went wrong on the FMSF end. Server error handling the request