Skip to main content
GET
/
datasets
/
properties
/
se
/
{uuid}
/
orthophotos
Get ortophotos by property UUID
curl --request GET \
  --url https://api.tic.io/datasets/properties/se/{uuid}/orthophotos \
  --header 'x-api-key: <api-key>'
[
  {
    "lantmateriet_OrderImageFileId": 123,
    "flightYear": 123,
    "flightAltitude": 123,
    "resolution": 123,
    "spectralType": "<string>",
    "fileName": "<string>",
    "fileNameLength": 123,
    "fileNameReduced": "<string>",
    "fileNameReducedLength": 123,
    "url": "<string>",
    "urlReduced": "<string>",
    "error": "<string>",
    "processingTimeMs": 123,
    "fromCache": true,
    "flightRecordingStarted": "2023-11-07T05:31:56Z",
    "flightRecordingEnded": "2023-11-07T05:31:56Z",
    "totalArea": 123,
    "numberOfAreas": 123
  }
]
Get a list of all high-resolution orthophotos for each year. We will automatically mark the property areas and their boundary and enhance image quality for displaying directly in a web application. The response will include the open URL or reduced image URL to the high resolution image which you can directly reference. Please note that typical response times are 50-100 ms per image for areas up to ~100 000 m2 so make sure your request doesn’t time out since a response could contain up to 10 years of high-resolutions images (expect 1-3 seconds of non cached images).
This endpoint will only serve images up to 2 000 000 m² and for very large areas response times can vary between 5-15 seconds per image (expect 45 - 90 seconds response times).
Response will include a URL, url, representing loseless PNG which can be expected to be significant of size for large areas. We also include a reduced version, urlReduced, in JPEG format (compressed) and images exceeding 2500 px in width will be resized to 2500 px to avoid very large image sizes. We recommend using the urlReduced for small displays and only use the full loselsess PNG for situations where you may need the full details. Also included is the file sizes in byte for fileNameLength (url) and fileNameReducedLength (urlReduced). These can help to make simple checks if you want to display the PNG or the JPEG image.

​
Example

This example shows a retrieved image for the property, UMEÅ AMERIKA 1:1, having an area of 1 068 479 m² (large) and the image rendered represents urlReduced e.g a compressed version in JPEG format. File size is ~2.3MB since it has been reduced to maximum 2500px in width (2500 x 1814px). If you switch the URL extension to PNG (e.g https://storage.tic.io/909a6a85-299b-90ec-e040-ed8f66444c3f_2024_32098.png) you will get the full uncompressed and unmodified size of 12619 x 9156 px. The file size is now ~237MB. Example of a property 1 068 479 m²

​
Recommendations

Recommendation is to use an if-statement to check if the fileNameLength is less than 10000000 (10MB) and display the url and if it’s greater than 10000000 display the urlReduced.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
uuid
string
required

The unique identifier for the property

Response

200 - application/json

OK

​
lantmateriet_OrderImageFileId
integer<int32>
​
flightYear
integer<int32> | null
​
flightAltitude
integer<int32> | null
​
resolution
number<double> | null
​
spectralType
string | null
​
fileName
string | null
​
fileNameLength
integer<int64>
​
fileNameReduced
string | null
​
fileNameReducedLength
integer<int64>
​
url
string | null
​
urlReduced
string | null
​
error
string | null
​
processingTimeMs
integer<int64> | null
​
fromCache
boolean
​
flightRecordingStarted
string<date-time> | null
​
flightRecordingEnded
string<date-time> | null
​
totalArea
integer<int32>
​
numberOfAreas
integer<int32>